API Ineveo

1 · Ověření

Vytvořte klíč v Nastavení > API klíče. Posílejte ho s každým požadavkem jako Bearer token a držte ho na svém serveru, nikdy v prohlížeči ani v aplikaci.

curl https://ineveo.com/api/v1/api/catalog/me \
  -H 'Authorization: Bearer YOUR_API_KEY'

2 · Výběr modelu

Vyberte model a uvidíte hotový požadavek sestavený z jeho vlastních polí. Povinná pole jsou vyplněná; každé volitelné nastavení používá výchozí hodnotu modelu.

3 · Spuštění renderu

Jedno volání spočítá cenu vašich přesných vstupů a strhne ji ze zůstatku. Odpověď přijde okamžitě se stavem queued; render běží na pozadí. Pošlete hlavičku Idempotency-Key, aby opakovaný požadavek nikdy neúčtoval dvakrát.

curl -X POST https://ineveo.com/api/v1/api/catalog/generations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "modelId": "ineveo/fast-image/text-to-image",
  "inputs": {
    "prompt": "a lighthouse on a cliff at dusk, soft light"
  }
}'

Nejprve zkontrolujte cenu (volitelné)

Stejné vstupy, jen oceněné bez spuštění čehokoli. Odpověď je v centech.

curl -X POST https://ineveo.com/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"ineveo/fast-image/text-to-image","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light"}}'

4 · Dotazování a stažení

Každých pár sekund se dotazujte na render, dokud stav není succeeded, failed nebo refunded. Po úspěchu stáhněte soubor z contentUrl stejným klíčem. Textový model vrací odpověď místo toho v textOutput.

curl https://ineveo.com/api/v1/api/catalog/generations/GENERATION_ID \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl https://ineveo.com/api/v1/api/catalog/generations/GENERATION_ID/content \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -o result.png

Endpointy

Základní URL: https://ineveo.com/api/v1/api/catalog

Ceny a zůstatek

Rendery přes API čerpají ze stejného zůstatku jako studio a stojí stejně. Každá částka v API je v eurocentech: costCents je to, co render stál, balanceCents to, co zbývá.

Chyby a limity

Chyby se vracejí jako JSON s kódem a zprávou. 401: chybějící, chybný nebo zrušený klíč. 400: neplatné pole (podrobnosti ho jmenují). 402: nedostatečný zůstatek. 429: příliš mnoho požadavků, zpomalte. Nezdařený render se vrací automaticky. Přesné limity budou zveřejněny se spuštěním klíčů. 403 s HTML stránkou: požadavek byl zastaven dřív, než dorazil k API, obvykle kvůli hlavičce User-Agent. Výchozí hlavička Pythonu urllib je blokovaná, pošlete tedy vlastní, například User-Agent: my-app/1.0.