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 e installa la CLI con npm.

Ottieni una chiave APIGuida rapida
Installa la CLI
npm i -g ineveo
Modelli
707
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://ineveo.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $INEVEO_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://ineveo.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $INEVEO_API_KEY"17 18# 3. Download the file19curl https://ineveo.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $INEVEO_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 APIAccedi con la tua email, apri Impostazioni, Chiavi API e crea una chiave. Ricarica da 3 € in Fatturazione.export INEVEO_API_KEY="YOUR_API_KEY"
  2. 02Installa la CLIUn solo comando: npm i -g ineveo. Legge la tua chiave da INEVEO_API_KEY.npm i -g ineveo
  3. 03Fai il tuo primo renderScegli un ID modello dal catalogo e invia un prompt. Aggiungi --dry-run per vedere il prezzo senza spendere nulla.ineveo run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
[03] CLI

Genera dal terminale

Esegui qualsiasi modello da una shell, un job di CI o un agente di programmazione. Ogni render ha il prezzo calcolato prima di partire e attinge allo stesso saldo.

Script e CIOgni campo di un modello è un flag; un file locale viene caricato per te.
JSON su stdoutUn documento JSON per esecuzione, avanzamento ed errori su stderr, codice di uscita diverso da zero in caso di errore.
Agenti di programmazioneUn file skill insegna al tuo agente a controllare prima il prezzo e a fissare un tetto.
Guida completa alla CLI →
ComandoCosa fa
ineveo models --type videoTutti i modelli video con il prezzo di partenza
ineveo run <model> -hI campi di un modello, letti in tempo reale: tipo, valore predefinito, valori ammessi
ineveo run <model> -p "<prompt>" -o ./out/Genera e salva il risultato in una cartella
ineveo run <model> -p "..." --dry-runIl prezzo esatto, senza spendere nulla
ineveo run <model> -p "..." --max-price 0.50Rifiuta di eseguire se il prezzo è più alto
ineveo run <model> -p "..." --json -o ./out/Un risultato JSON, pronto per il passo successivo
ineveo skill installInsegna al tuo agente di programmazione a usare la CLI
[04] API in sintesi

Pensata per la produzione

Autenticazione

Un token Bearer nell'header Authorization. Crea le chiavi in Impostazioni e revocale quando vuoi.

Authorization: Bearer YOUR_API_KEY

Render in background

Avviare un render risponde subito con stato queued. Controlla il render 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 al minuto e un tetto giornaliero facoltativo. Oltre il limite l'API risponde 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://ineveo.com/api/v1

Riferimento API completo →
GET/api/catalog/meLa tua chiave e il saldo
GET/api/catalog/modelsTutti i modelli
GET/api/catalog/models/detail?id=MODEL_IDUn modello e i suoi campi
POST/api/catalog/quotePrezzo per input esatti
POST/api/catalog/generationsAvvia un render
GET/api/catalog/generationsI tuoi render recenti
GET/api/catalog/generations/IDStato di un render
GET/api/catalog/generations/ID/contentIl file del risultato
DELETE/api/catalog/generations/IDElimina un render

Ricarica 3 € e vai in produzione oggi

Crea una chiave API in Impostazioni e chiama qualsiasi modello. La CLI è su npm. I render falliti vengono rimborsati.

Ottieni una chiave APIVedi i prezzi