Sviluppatori · API v1

Un'unica API.
Ogni modello.

Immagini, video, audio e 3D dietro un'unica API, pagati dallo stesso saldo dello studio. Crea una chiave in Impostazioni. Installa la CLI con npm.

Ottieni una chiave APIGuida rapida
$ npm i -g femimg
Modelli
699
Endpoint
9
Ricarica minima
3 €
01 · Esempi

Stessa chiamata, qualsiasi output

Cambia l'ID del modello per passare tra immagine, video e voce. I campi seguono il modello.

1# 1. Generate an image2curl -X POST https://femimg.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $FEMIMG_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://femimg.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $FEMIMG_API_KEY"17 18# 3. Download the file19curl https://femimg.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $FEMIMG_API_KEY" \21  -o result.jpeg
Render di esempioluma/uni-v1/text-to-image
02 · Guida rapida

Il primo render in tre passi

  1. 01Crea una chiave APIIn Impostazioni > Chiavi API, dai un nome a una chiave e copiala subito: la vedi una sola volta. Ricarica da 3 € in Pagamenti.export FEMIMG_API_KEY="YOUR_API_KEY"
  2. 02Avvia un renderInvia l'ID del modello e i suoi input. Ricevi subito una generazione, con stato queued.POST /api/v1/api/catalog/generations
  3. 03Controlla e scaricaControlla la generazione finché lo stato è succeeded, poi scarica il file.GET /api/v1/api/catalog/generations/ID/content
03 · CLI

Genera dal terminale

Uno strumento da riga di comando per script, CI e agenti di codice, con le stesse chiavi e lo stesso saldo dell'API. Installalo con npm, oppure chiama direttamente l'API con un semplice curl.

$ npm i -g femimg
Script e CIGenera da qualsiasi shell, job o cron.
Output JSONUn documento JSON per ogni esecuzione, pronto per il passo successivo.
Agenti di programmazioneIl tuo agente controlla prima il prezzo e mette un tetto a quanto spende.
04 · L'essenziale dell'API

Pensata per la produzione

Autenticazione

Un token Bearer nell'header Authorization. Crea le chiavi in Impostazioni.

Authorization: Bearer YOUR_API_KEY

Render in background

Avviare un render risponde subito con stato queued. Controllalo finché non è riuscito, fallito o rimborsato.

{ "status": "queued" }

Prima il prezzo

Chiedi il prezzo esatto dei tuoi input senza avviare nulla. Ogni importo è in centesimi di euro.

POST /api/v1/api/catalog/quote

Nuovi tentativi sicuri

Invia un header Idempotency-Key e una richiesta ripetuta non addebita mai due volte.

Idempotency-Key: render-042

Limiti

Ogni chiave ha un limite di richieste al minuto. Oltre il limite ricevi un errore 429.

429 Too Many Requests

Errori e rimborsi

Errori JSON con un codice e un messaggio. Un render non riuscito viene rimborsato automaticamente sul tuo saldo.

{ "status": "refunded" }
05 · Riferimento

Endpoint

URL di base https://femimg.com/api/v1

GET/api/catalog/meIl nome della chiave, il suo limite e il tuo saldo
GET/api/catalog/modelsIl catalogo dei modelli con i loro prezzi
GET/api/catalog/models/detail?id=MODEL_IDUn modello con tutti i suoi campi
POST/api/catalog/quoteIl prezzo esatto di un insieme di input
POST/api/catalog/generationsAvvia un render con qualsiasi modello
GET/api/catalog/generationsLe tue generazioni recenti
GET/api/catalog/generations/IDStato, costo e risultato di una generazione
GET/api/catalog/generations/ID/contentScarica il file finito
DELETE/api/catalog/generations/IDElimina una generazione

Ricarica 3 € e vai in produzione oggi

L'API e lo studio condividono un solo saldo. Un render che fallisce viene rimborsato.

Ottieni una chiave APIVedi i prezzi