Ugrás a tartalomra
fcaaiBejelentkezésKezdd ingyen
v1.1 · ÉlőREST · JSONUSD

API-dokumentáció

Aszinkron feladatok, aláírt webhookok, OpenAI-kompatibilis végpontok. Futtatásonként fizetsz, a sikertelen feladatok árát pedig visszatérítjük.

Alap-URLhttps://api.fcaai.ai/v1

Gyors kezdés

  1. Kulcs létrehozásaFiók › Fejlesztői kulcsok. Használj tesztkulcsot, hogy a fejlesztést elkülönítsd az éles környezettől; a futtatások számlázása ugyanaz: fcaai_test_ Tedd ide: FCAAI_API_KEY; az SDK-k és a CLI innen olvassák be.
  2. SDK vagy CLI telepítéseTypeScript Node 18+, Deno, Bun és edge futtatókörnyezetekhez, Python 3.9+, vagy a terminál. A curl nem igényel telepítést. npm i @fcaai/sdkpip install fcaainpm i -g @fcaai/cli
  3. Az első generálás futtatásaA hívás azonnal 202-vel tér vissza, a feladat azonosítójával és árával. Ezzel: { wait: true } az SDK csak akkor tér vissza, amikor a feladat befejeződött.
export FCAAI_API_KEY="fcaai_test_…"

# 1) queue a job → 202 { "id", "status": "queued", "price_usd", "eta_seconds" }
curl https://api.fcaai.ai/v1/generations \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model":"fca/magic-pro","input":{"prompt":"glass villa on a pine ridge at blue hour","aspect_ratio":"16:9","resolution":"2k"}}'

# 2) long poll: holds up to 60 s, returns as soon as the job ends; repeat while queued/running
curl "https://api.fcaai.ai/v1/generations/$GEN_ID?wait=50" \
  -H "Authorization: Bearer $FCAAI_API_KEY"
# → "status": "succeeded", "output": [{ "url": "https://…", "kind": "image", … }]

Hitelesítés

Minden kéréssel küldd el a kulcsodat bearer tokenként.

  • Éles környezethez: fcaai_live_ kezdetű kulcsok; fejlesztéshez: fcaai_test_ kezdetű kulcsok. Mindkettő számlázása ugyanúgy történik; a tesztkulcsok csak elkülönítik a környezeteket.
  • A kulcs egyszer jelenik meg, a létrehozásakor, és csak egy ujjlenyomatot őrzünk meg belőle. Tárold környezeti változóban, például ebben: FCAAI_API_KEY, és soha ne olyan kódban, amely böngészőben vagy alkalmazásban fut.
  • Hiányzó, hibás, visszavont vagy lejárt kulcs esetén 401-es választ kapsz. Megfelelő hatókör nélküli, vagy az engedélyezőlistán kívüli IP-ről használt kulcs esetén 403-at.
curl https://api.fcaai.ai/v1/models \
  -H "Authorization: Bearer $FCAAI_API_KEY"

Hogyan érkeznek az eredmények

Minden generálás egy feladat: queued → running → succeeded, failed vagy canceled. A sikertelen és a megszakított feladatok árát visszatérítjük.

{
  "id": "cmvusmtm300234pbo7l6ecl3f",
  "object": "generation",
  "model": "fca/magic-pro",
  "status": "queued",
  "price_usd": 0.03,
  "currency": "USD",
  "eta_seconds": 14,
  "output": null
}

Generálás megszakítása

A várólistán lévő generálás megszakítható, és a lefoglalt összeg felszabadul. Ha már elindult, általában nem: 409-es választ kapsz (already_started), és a generálás a szokásos módon befejeződik és kiszámlázzuk.

  • Előbb olvasd ki a generálásból ezt a mezőt: cancellable. A várólistán mindig true, elindulás után általában false.
  • Egy már befejeződött generálás megszakítása változatlanul visszaadja azt.
# can it still be cancelled?
curl https://api.fcaai.ai/v1/generations/$GEN_ID -H "Authorization: Bearer $FCAAI_API_KEY"
# → "status": "queued", "cancellable": true, …

curl -X POST https://api.fcaai.ai/v1/generations/$GEN_ID/cancel -H "Authorization: Bearer $FCAAI_API_KEY"
# → 200: the generation, "status": "canceled"
# → 409 "already_started": it finishes and is charged as usual

Felhasználás és egyenleg

GET /v1/account/usage visszaadja a generálásokat, a hibákat és a költést USD-ben, naponta és modellenként. Az utolsó 30 napot fedi le, hacsak meg nem adod ezeket: from és to, YYYY-MM-DD formátumban.

  • GET /v1/account/balance visszaadja az elérhető egyenlegedet USD-ben.
# per day and model; the last 30 days unless you pass from and to
curl "https://api.fcaai.ai/v1/account/usage?from=2026-10-01&to=2026-10-31" -H "Authorization: Bearer $FCAAI_API_KEY"

curl https://api.fcaai.ai/v1/account/balance -H "Authorization: Bearer $FCAAI_API_KEY"
Lépésről lépésre

Útmutatók

Lépésről lépésre receptek a leggyakoribb feladatokhoz. A példák a hivatalos SDK-kat használják; a curl fül a sima HTTP-kérést mutatja.

Kép szerkesztése referenciaképekkel

Küldd el a szerkesztendő fotót és a referenciaképeidet egyetlen listában (images), majd írd le a változtatást. A képekre a sorrendjükkel hivatkozz (1. kép, 2. kép…).

  1. Tölts fel helyi fájlokat, vagy használj bármilyen nyilvános https URL-t.
  2. A szerkesztendő kép legyen az első itt: images; a többi referencia.
  3. Nézd meg a modell részleteinél ezt az értéket: constraints.max_input_images. Ebből látod, hány képet fogad a modell.

A könyvtáradban mentett karakterek, termékek és helyszínek ezzel adhatók hozzá: element_ids (legfeljebb 3); a referenciaképeiket mi csatoljuk.

curl https://api.fcaai.ai/v1/generations \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"google/nano-banana-pro","input":{"prompt":"Put the armchair from image 2 next to the window. Keep the room, light and camera unchanged.","images":["https://example.com/room.jpg","https://example.com/armchair.jpg"],"resolution":"2k"}}'

# how many images this model takes
curl https://api.fcaai.ai/v1/models/google/nano-banana-pro -H "Authorization: Bearer $FCAAI_API_KEY"
# → "constraints": { "max_input_images": …, … }

Képből videó kezdő- és záróképkockával

A videómodellek az első képkockát itt kapják: image, és ha támogatják, az utolsót itt: end_image. A klip az egyikből a másikba mozog.

  1. Ellenőrizd a modellt: constraints.features.end_frame értéke legyen true, az időtartam pedig feleljen meg ennek: constraints.duration.
  2. Küldd el ezeket: image, end_image, a prompt és az időtartam. A kameramozgásokat sima szövegként írd a promptba.
  3. A videó néhány percig tart: várj hosszabb időkorláttal, vagy használj webhookot.

Ha egy modellnél ez is szerepel: features.reference, akkor referenciamódja is van: képkockák helyett ezt küldd: reference_images, és a promptban @Image1, @Image2 néven hivatkozz rájuk. Nem használható együtt ezekkel: image, end_image.

# price with an end frame
curl "https://api.fcaai.ai/v1/models/kling/3.0-pro?duration=5&end_image=1" -H "Authorization: Bearer $FCAAI_API_KEY"

curl https://api.fcaai.ai/v1/generations \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling/3.0-pro","input":{"prompt":"slow dolly in, morning light moves across the floor","image":"https://example.com/start.jpg","end_image":"https://example.com/end.jpg","duration":5}}'

Kép felskálázása

A felskálázók egy képet (image) és egy léptéket (tier) fogadnak. fca/upscale: két stílus közül választhatsz: Standard fotókhoz (legfeljebb 16x) és Sharp renderekhez, alaprajzokhoz és szöveghez (legfeljebb 4x).

  1. Kérd le az árat a forrásképed méretéhez: ?tier=4x&source_width=…&source_height=….
  2. Küldd el a képet és a léptéket. "tier": "max": a képhez illő legnagyobb léptéket választja (a kimenet legfeljebb 64 MP).
  3. Az új méret a kimenet width / height mezőjében található.

A javítók, az újravilágítás, a kiterjesztés, a háttér eltávolítása és a videófelskálázás ezzel listázható: GET /v1/models?type=upscale.

curl "https://api.fcaai.ai/v1/models/fca/upscale?tier=4x&source_width=1600&source_height=1000" -H "Authorization: Bearer $FCAAI_API_KEY"

curl https://api.fcaai.ai/v1/generations \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"fca/upscale","input":{"image":"https://example.com/render.jpg","tier":"4x","extra":{"look":"sharp"}}}'

Sablon futtatása

A sablonok kész receptek néhány elnevezett bemenettel. A prompt nálunk marad: te értékeket küldesz, és normál generálást kapsz vissza.

  1. Kérd le a sablont, hogy lásd a bemeneteit (inputs: kulcs, típus, kötelező, opciók) és az árazását (pricing).
  2. Futtasd ezzel: { "values": { key: value } }. A képbemenetek https URL-t fogadnak.
  3. Várd meg, mint bármely más feladatot. Hibás érték esetén 400 invalid_values választ kapsz, ezzel: fields.

A többlépéses sablonok (package) több lépésből álló sablonfuttatást indítanak: ehhez ezt használd: templates.runPackage / run_package.

curl https://api.fcaai.ai/v1/templates -H "Authorization: Bearer $FCAAI_API_KEY"
curl https://api.fcaai.ai/v1/templates/$SLUG -H "Authorization: Bearer $FCAAI_API_KEY"     # inputs, pricing, options (models[].id → run "model")

curl https://api.fcaai.ai/v1/templates/$SLUG/run \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"values":{"photo":"https://example.com/room.jpg"}}'
# → 202: a generation (poll GET /v1/generations/{id}?wait=50)
#   multi-step templates return a template_run (GET /v1/templates/runs/{id})

Előbb kérd le az árat és a modell beállításait

Egyetlen ingyenes hívás visszaadja mindazt, amit a modell elfogad, és a pontos árat a beállításaidhoz. Ugyanazt az árlogikát használja, mint ez: POST /v1/generations, így az ajánlott ár az, amit fizetsz.

  1. Hívd meg ezt: GET /v1/models/{id}, azokkal a beállításokkal, amelyeket küldeni fogsz: duration · resolution · quality · tier · count · audio=1 · images=2 · end_image=1 · reference_images=3.
  2. Az árat itt olvasd le: estimate.price_usd, és futtatás előtt ellenőrizd ezt: availability.
  3. Az űrlapodat ezekből építsd fel: options és constraints: képarányok, felbontások, időtartam, kimenetek maximális száma, bemeneti képek maximális száma és funkciók.

A modell által nem engedélyezett érték itt jelenik meg: invalid_params, a mezővel és az engedélyezett értékekkel együtt.

curl "https://api.fcaai.ai/v1/models/google/veo-3.1?duration=8&resolution=1080p&audio=1&end_image=1" -H "Authorization: Bearer $FCAAI_API_KEY"
# → { "availability": "available",
#     "estimate": { "price_usd": …, "price_display": "$…", "currency": "USD" },
#     "options": { … }, "constraints": { … }, "input_schema": { … } }

curl "https://api.fcaai.ai/v1/models?type=video" -H "Authorization: Bearer $FCAAI_API_KEY"   # the whole catalog for your key

Fájlok feltöltése

Minden bemenet egy https URL. A nyilvános URL-ek változatlanul működnek; a helyi fájlokat előbb töltsd fel, és használd a visszakapott url értéket.

  1. Legfeljebb 50 MB: egyetlen kérés ide: POST /v1/uploads.
  2. Legfeljebb 2 GB: nyiss egy munkamenetet, küldj 8 MB-os darabokat tetszőleges sorrendben (akár párhuzamosan is), majd zárd le.
  3. A munkamenet megnyitásakor küldd el ezt: sha256, hogy folytathass egy megszakadt feltöltést, vagy kihagyj egy már tárolt fájlt.

Az SDK-k és a CLI feldarabolják a fájlt, egyszerre 3 darabot küldenek, és a munkamenet-azonosítóval folytatják.

# ≤ 50 MB
curl https://api.fcaai.ai/v1/uploads -H "Authorization: Bearer $FCAAI_API_KEY" -F "[email protected]"
# → 201 { "id": "…", "object": "upload", "url": "https://…", "mime": "image/jpeg", "bytes": … }

# up to 2 GB: 1) start a session
curl https://api.fcaai.ai/v1/uploads/sessions \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"walkthrough.mp4","mime":"video/mp4","bytes":104857600}'
# 2) PUT each 8 MB chunk (any order, in parallel)
split -b 8388608 -d -a 4 walkthrough.mp4 part_
curl -X PUT https://api.fcaai.ai/v1/uploads/sessions/$SESSION/chunks/0 -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/octet-stream" --data-binary @part_0000
# 3) finish → { "upload": { "url": … } }
curl -X POST https://api.fcaai.ai/v1/uploads/sessions/$SESSION/complete -H "Authorization: Bearer $FCAAI_API_KEY"

Eredmények webhookkal

Lekérdezgetés helyett hagyd, hogy mi hívjuk meg a szerveredet, amikor egy feladat véget ér. Regisztrálj egy URL-t az egész fiókra, vagy egyetlen kéréshez add hozzá ezt: options.webhook_url (a titkos kulcsa egyszer jön vissza, itt: webhook_secret).

  1. Regisztrálj ezzel: POST /v1/webhooks: add meg a https URL-edet és a kívánt eseményeket. A titkos kulcs (secret) csak egyszer jelenik meg, ezért tárold el.
  2. Ellenőrizz minden kézbesítést: X-FCAAI-Signature: t=…,v1=… értéke t + "." + rawBody HMAC-SHA256 kódja a titkos kulcsoddal. Használd a nyers törzset, és utasítsd el a régi időbélyegeket.
  3. Válaszolj gyorsan 2xx-szel, és a munkát utána végezd el. A sikertelen kézbesítést összesen 5-ször próbáljuk: azonnal, majd 30 mp, 2 perc, 10 perc és 1 óra után. Minden próbálkozás megtalálható itt: GET /v1/webhooks/{id}/deliveries.

Egy esemény többször is megérkezhet; az ismétlődések kiszűréséhez használd az azonosítóját (id).

Események
generation.succeededgeneration.failedgeneration.canceledflow_run.succeededflow_run.failedflow_run.canceledtimeline.preview_readytimeline.donetimeline.failedapproval.requestedapproval.decided

Csak nyilvános https-címeket fogadunk el, és a címet minden kézbesítéskor újra ellenőrizzük.

curl https://api.fcaai.ai/v1/webhooks \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/fcaai-hook","events":["generation.succeeded","generation.failed"]}'
# → 201 { "id": "…", "events": [ … ], "secret": "whsec_…" }   (secret shown only here)

# or one event for one job: add to POST /v1/generations
#   "options": { "webhook_url": "https://example.com/fcaai-hook" }
# → the 202 response carries "webhook_secret" (shown only there)

# delivery log: the latest 50 attempts
curl https://api.fcaai.ai/v1/webhooks/$WEBHOOK_ID/deliveries -H "Authorization: Bearer $FCAAI_API_KEY"

Hibák és figyelmen kívül hagyott beállítások kezelése

A hibák JSON-ként érkeznek, egy stabil kóddal (error.code), amely alapján elágaztathatsz. Egy nem alkalmazható beállítás nem buktatja el a feladatot: ezen a listán szerepel: ignored_fields.

  1. Ellenőrizd a HTTP-állapotot és ezt: error.code. Hibás értéknél allowed felsorolja az érvényeseket.
  2. A 429-es és 5xx-es hibákat ennyi idő után próbáld újra: Retry-After, ugyanazzal a kulccsal (Idempotency-Key), hogy semmit ne számlázzunk kétszer. Az SDK-k mindkettőt elvégzik helyetted.
  3. A 202-es válaszban olvasd ki ezt: ignored_fields; minden bejegyzés tartalmazza ezt: field · reason · message.

A sikertelen feladatok árát automatikusan visszatérítjük. Ha egy modell szokásos útvonala nem működik, a feladat magától tartalék útvonalra kerül; az 503 model_unavailable azt jelenti, hogy jelenleg nincs szabad útvonal.

ÁllapotKódokTeendő
400invalid_bodyinvalid_durationinvalid_aspect_ratiomodel_not_allowedEgy mező hiányzik, vagy nem engedélyezett ennél a modellnél. Javítsd a kérést; változatlanul újraküldve ismét hibát ad.
401invalid_api_keyapi_key_revokedapi_key_expiredA kulcs hiányzik, hibás, visszavonták vagy lejárt.
402insufficient_balancekey_spend_cap_reachedNincs elég egyenleg, vagy a kulcs elérte a havi korlátját. Nem vontunk le semmit.
403insufficient_scopeip_not_allowedA kulcsnak hiányzik egy hatóköre (lásd: required_scope), vagy a kérés IP-címe nincs az engedélyezőlistáján.
404model_not_foundNincs ilyen modell, vagy nem érhető el a kulcsoddal.
429rate_limitedTúl sok kérés. Várj annyit, amennyit ez jelez: Retry-After.
503model_unavailableA modell foglalt vagy offline. Próbáld újra kicsit később, vagy válassz másik modellt.
Okok ebben: ignored_fields
unknown_field
Nem mezője ennek a kérésnek; ellenőrizd a helyesírást.
not_supported_by_model
Érvényes mező, amelyet ez a modell nem fogad.
nearest_supported
Ez a képarány nem érhető el; a legközelebbit használjuk.
follows_input_image
Szerkesztéskor ez a modell megtartja a bemeneti kép méretét vagy arányát.
unpriced_extra
Egy olyan extra beállítást, amelyet a modell nem definiál, eltávolítottunk.
import { Fcaai, FcaaiError } from '@fcaai/sdk'

type Ignored = { field: string; reason: string; message: string }
const fcaai = new Fcaai({ maxRetries: 2 }) // 429 / 5xx / network errors: retried with backoff, honoring Retry-After

try {
  const gen = await fcaai.generations.create({ model: 'google/veo-3.1', input: { prompt: 'waves at dusk, slow pan', duration: 6 } })
  const { ignored_fields = [] } = gen as unknown as { ignored_fields?: Ignored[] }
  for (const f of ignored_fields) console.warn(f.field + ' ignored (' + f.reason + '): ' + f.message)
} catch (e) {
  if (!(e instanceof FcaaiError)) throw e
  const allowed = (e.body as { error?: { allowed?: unknown[] } } | null)?.error?.allowed
  if (e.status === 400) console.error(e.code, e.message, allowed)   // fix the request; do not retry as is
  else if (e.status === 402) console.error('Top up, or raise the key cap:', e.message)
  else if (e.code === 'model_unavailable') console.error('Retry shortly or pick another model')
  else throw e
}

OpenAI-kompatibilis végpontok

Az OpenAI-klienst már használó kód két dolog módosítása után működik: az alap-URL és a kulcs. A csevegés és a képgenerálás támogatott.

  1. Állítsd az alap-URL-t erre: https://api.fcaai.ai/v1, és API-kulcsként az fcaai-kulcsodat használd.
  2. Csevegés: POST /v1/chat/completions, modell: fca/chat. A streaming, az eszközök és a JSON-kimenet a megszokott módon működik.
  3. Képek: POST /v1/images/generations legfeljebb 90 mp-ig vár, és ezt adja vissza: data[].url. Ha a feladat tovább tart, 202-t kapsz ezzel: fcaai.generation_id; kövesd nyomon ezzel: GET /v1/generations/{id}.

Videóhoz, hanghoz, 3D-hez, felskálázáshoz és minden modellbeállításhoz ezt használd: POST /v1/generations.

curl https://api.fcaai.ai/v1/chat/completions \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"fca/chat","messages":[{"role":"user","content":"Write a one-line caption for a walnut side table."}]}'

curl https://api.fcaai.ai/v1/images/generations \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"google/nano-banana-pro","prompt":"a paper plane on a wooden desk","size":"1536x1024"}'
# → { "created": …, "data": [{ "url": "https://…" }], "fcaai": { "generation_id": "…", "price_usd": … } }

Viszonteladás a saját ügyfeleidnek

A viszonteladói fiókok minden ügyfélnek külön alfiókot nyithatnak, saját kulcsokat adhatnak neki, és ügyfelenként követhetik a felhasználást nagykereskedelmi áron.

  1. Használj kezelőkulcsot ezzel a hatókörrel: reseller:manage. Az ügyfélkulcsok sosem kapják meg.
  2. Hozd létre az ügyfelet ezzel: POST /v1/reseller/subtenants, majd a kulcsát ezzel: POST /v1/reseller/subtenants/{id}/keys. A teljes kulcs csak egyszer jelenik meg.
  3. Kövesd a felhasználást és az árrést ügyfelenként ezzel: GET /v1/reseller/usage. Ha a saját végfelhasználóidat is meg szeretnéd jelölni a generálásokon, küldd ezt: external_user_id.

A viszonteladói hatókör nélküli kulcsok 403-at kapnak ezeken a végpontokon.

curl https://api.fcaai.ai/v1/reseller/subtenants \
  -H "Authorization: Bearer $FCAAI_RESELLER_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Acme Studio","plan":"pro","retail_markup":1.5}'

curl https://api.fcaai.ai/v1/reseller/subtenants/$CUSTOMER_ID/keys \
  -H "Authorization: Bearer $FCAAI_RESELLER_KEY" -H "Content-Type: application/json" \
  -d '{"name":"production","mode":"live"}'

curl "https://api.fcaai.ai/v1/reseller/usage?from=2026-10-01" -H "Authorization: Bearer $FCAAI_RESELLER_KEY"
Referencia

Mit építhetsz

69 végpont. Mindegyik szerepel a teljes referenciában curl, TypeScript és Python példákkal.

GET/v1/style-kitsStíluskészletek
GET/v1/elementsElemek
POST/v1/video-editsVideószerkesztés: vágás, összefűzés, képek, szöveg és logó, hangsáv (aszinkron, ingyenes)
GET/v1/generationsGenerálások listázása
POST/v1/generationsGenerálás létrehozása (aszinkron)
GET/v1/generations/{id}Generálás lekérése (long poll a wait paraméterrel)
POST/v1/generations/{id}/cancelMegszakítás (a lefoglalt egyenleg felszabadul)

Árak

Dollár futtatásonként, ugyanabból az egyenlegből, mint a csomagod. Ezek élő árak alapértelmezett beállításokkal; minden modelloldal felsorolja az összes árat felbontás és időtartam szerint.

ModellFeladatAPI (USD)
Nano Banana ProKép · kép · 2K$0.13
GPT Image 2.5 FlareKép · kép · 2K$0.055
FCA Magic ProKép · kép · 2K$0.03
Kling 3.0 ProVideó · másodpercenként · 1080p$0.11
FCA Magic V3Videó · másodpercenként · 1080p$0.017
ElevenLabs v3Hang · klip$0.024
Az árajánlat ingyenesA sikertelen futtatás árát visszatérítjükAz automatikus egyenlegfeltöltés alapból ki van kapcsolvaAz API-n nincs korlátlan csomag

Kulcsok és korlátok

Minden kulcsnak saját hatóköre, kérésgyakorisága és költési korlátja van. A válaszfejlécek mutatják, mennyi maradt.

120 / percAlapértelmezett kérésgyakoriság kulcsonként. X-RateLimit-*
2Kulcsonként egyszerre futó feladatok (emelhető).
Havi korlátUSD-ben; elérésekor a kérések 402-es választ kapnak key_spend_cap_reached
HatókörA kép, videó, hang, 3D, felskálázás és LLM egyenként kapcsolható be.
IP-engedélyezőlistaA kulcs zárolása a szervereid IP-címeire.
Idempotency-KeyUgyanazzal az idempotenciakulccsal újrapróbálva sosem számlázunk kétszer.

SDK-k és eszközök

Hivatalos TypeScript és Python SDK-k és egy CLI. Az SDK-k idempotenciakulccsal biztonságosan újrapróbálkoznak, megvárják az eredményeket, darabokban töltik fel a nagy fájlokat, és ellenőrzik a webhook-aláírásokat.

TypeScriptnpmjs.com (új lapon nyílik meg)Node 18+, Deno, Bun és edge futtatókörnyezetek
Pythonpypi.org (új lapon nyílik meg)Python 3.9+, csak a standard könyvtárral
CLInpmjs.com (új lapon nyílik meg)Minden modell a terminálodból
MCPCsatlakoztasd az AI-ügynökeidet ugyanazokhoz a modellekhez és ugyanahhoz az egyenleghez.
Minden végpont, mező és hibakód

Az interaktív referencia: próbálj ki kéréseket a böngésződben, és másold ki a példakódot.

Teljes API-referencia(új lapon nyílik meg)