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.
https://api.fcaai.ai/v1Gyors kezdés
- 1Kulcs 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. - 2SDK 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 - 3Az 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.
- Long poll: ezzel:
?wait=50a kérés legfeljebb 60 mp-ig nyitva marad, és amint a feladat véget ér, visszatér. - Webhook: egyetlen aláírt esemény a feladat végén.
- SDK:
{ wait: true }TypeScriptben,wait=TruePythonban.
{
"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 usualFelhaszná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/balancevisszaadja 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"Ú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…).
- 1Tölts fel helyi fájlokat, vagy használj bármilyen nyilvános https URL-t.
- 2A szerkesztendő kép legyen az első itt:
images; a többi referencia. - 3Né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.
- 1Ellenőrizd a modellt:
constraints.features.end_frameértéke legyen true, az időtartam pedig feleljen meg ennek:constraints.duration. - 2Küldd el ezeket:
image,end_image, a prompt és az időtartam. A kameramozgásokat sima szövegként írd a promptba. - 3A 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).
- 1Kérd le az árat a forrásképed méretéhez:
?tier=4x&source_width=…&source_height=…. - 2Kü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). - 3Az új méret a kimenet
width / heightmező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.
- 1Kérd le a sablont, hogy lásd a bemeneteit (
inputs: kulcs, típus, kötelező, opciók) és az árazását (pricing). - 2Futtasd ezzel:
{ "values": { key: value } }. A képbemenetek https URL-t fogadnak. - 3Várd meg, mint bármely más feladatot. Hibás érték esetén 400
invalid_valuesvá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.
- 1Hí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. - 2Az árat itt olvasd le:
estimate.price_usd, és futtatás előtt ellenőrizd ezt:availability. - 3Az űrlapodat ezekből építsd fel:
optionsésconstraints: 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 keyFá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.
- 1Legfeljebb 50 MB: egyetlen kérés ide:
POST /v1/uploads. - 2Legfeljebb 2 GB: nyiss egy munkamenetet, küldj 8 MB-os darabokat tetszőleges sorrendben (akár párhuzamosan is), majd zárd le.
- 3A 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).
- 1Regisztrá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. - 2Ellenőrizz minden kézbesítést:
X-FCAAI-Signature: t=…,v1=…értéket + "." + rawBodyHMAC-SHA256 kódja a titkos kulcsoddal. Használd a nyers törzset, és utasítsd el a régi időbélyegeket. - 3Vá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).
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.
- 1Ellenőrizd a HTTP-állapotot és ezt:
error.code. Hibás értéknélallowedfelsorolja az érvényeseket. - 2A 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. - 3A 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.
| Állapot | Kódok | Teendő |
|---|---|---|
| 400 | invalid_bodyinvalid_durationinvalid_aspect_ratiomodel_not_allowed | Egy 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. |
| 401 | invalid_api_keyapi_key_revokedapi_key_expired | A kulcs hiányzik, hibás, visszavonták vagy lejárt. |
| 402 | insufficient_balancekey_spend_cap_reached | Nincs elég egyenleg, vagy a kulcs elérte a havi korlátját. Nem vontunk le semmit. |
| 403 | insufficient_scopeip_not_allowed | A 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. |
| 404 | model_not_found | Nincs ilyen modell, vagy nem érhető el a kulcsoddal. |
| 429 | rate_limited | Túl sok kérés. Várj annyit, amennyit ez jelez: Retry-After. |
| 503 | model_unavailable | A modell foglalt vagy offline. Próbáld újra kicsit később, vagy válassz másik modellt. |
ignored_fieldsunknown_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. - 2Csevegé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. - 3Képek:
POST /v1/images/generationslegfeljebb 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.
- 1Használj kezelőkulcsot ezzel a hatókörrel:
reseller:manage. Az ügyfélkulcsok sosem kapják meg. - 2Hozd 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. - 3Kö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"Mit építhetsz
69 végpont. Mindegyik szerepel a teljes referenciában curl, TypeScript és Python példákkal.
/v1/modelsModellek listázása/v1/models/{id}Modell részletei + árbecslés/v1/voicesKlónozott hangjaid/v1/style-kitsStíluskészletek/v1/elementsElemek/v1/voice-stylesBeszédstílusok/v1/voices/cloneHang klónozása (hozzájárulás szükséges)/v1/voices/{id}Klónozott hang átnevezése/v1/voices/{id}Klónozott hang törlése (végleges)/v1/models/{id}/voicesEgy beszédmodell hangjai/v1/templatesSablonok listázása/v1/templates/{slug}Sablon és bemenetei lekérése/v1/templates/{slug}/runSablon futtatása (aszinkron)/v1/templates/runs/{id}Többlépéses sablonfuttatás lekérése/v1/templates/runs/{id}/planHagyd jóvá vagy írd át a sablonfuttatás tervét/v1/templates/runs/{id}/cancelTöbblépéses sablonfuttatás megszakítása/v1/flowsFolyamatok listázása/v1/flows/{id}Folyamat és bemenetei lekérése/v1/flows/{id}/runFolyamat futtatása (aszinkron)/v1/community/templatesKözösségi sablonok listázása/v1/community/templates/{id}Közösségi sablon lekérése/v1/flows/runs/{id}Folyamatfuttatás lekérése/v1/timelinesJelenet-idővonal létrehozása/v1/timelines/{id}Idővonal lekérése/v1/timelines/{id}/{action}Előnézet, jóváhagyás, teljes minőség, vágás/v1/farm/jobsRenderfarm-feladatok listázása/v1/farm/jobs/{id}/pauseRenderfarm-feladat szüneteltetése/v1/farm/jobs/{id}/resumeRenderfarm-feladat folytatása/v1/farm/jobs/{id}Renderfarm-feladat lekérése/v1/video-editsVideószerkesztés: vágás, összefűzés, képek, szöveg és logó, hangsáv (aszinkron, ingyenes)/v1/generationsGenerálások listázása/v1/generationsGenerálás létrehozása (aszinkron)/v1/generations/{id}Generálás lekérése (long poll a wait paraméterrel)/v1/generations/{id}/cancelMegszakítás (a lefoglalt egyenleg felszabadul)/v1/uploadsBemeneti fájl feltöltése (≤ 50 MB)/v1/uploads/sessionsDarabolt feltöltés indítása (legfeljebb 2 GB)/v1/uploads/sessions/{id}Munkamenet állapota (fogadott darabok, hiányzó tartományok)/v1/uploads/sessions/{id}Darabolt feltöltés megszakítása/v1/uploads/sessions/{id}/chunks/{index}Egy darab feltöltése (nyers törzs)/v1/uploads/sessions/{id}/completeDarabolt feltöltés befejezése/v1/accountFiók, kulcs és egyenleg/v1/account/balanceEgyenleg (USD)/v1/account/usageFelhasználás naponta és modellenként/v1/webhooksWebhookok listázása/v1/webhooksWebhook létrehozása (a titkos kulcs egyszer jön vissza)/v1/webhooks/{id}Webhook törlése/v1/webhooks/{id}/deliveriesKézbesítési napló/v1/reseller/subtenantsÜgyfeleid listázása (alfiókok)/v1/reseller/subtenantsÜgyfél létrehozása (alfiók)/v1/reseller/subtenants/{id}/keysAPI-kulcs létrehozása egy ügyfélnek (a titkos kulcs egyszer jön vissza)/v1/reseller/usageFelhasználás és nagykereskedelmi költség ügyfelenként/v1/chat/completionsCsevegés-kiegészítés (OpenAI-séma)/v1/images/generationsKépgenerálás (OpenAI-séma, szinkron ≤ 90 mp)/v1/boards/{board_id}/approvalsEgy tábla jóváhagyási kéréseinek listázása/v1/boards/{board_id}/approvals/{request_id}Jóváhagyási kérés lekérése/v1/boards/{board_id}/approvals/{request_id}/decideOpció jóváhagyása vagy módosítás kérése/v1/plans/readAlaprajz beolvasása/v1/panoramas/finish360°-os panoráma véglegesítése/v1/flows/runs/{id}/cancelFolyamatfuttatás megszakítása/v1/architecture/projectsArchitecture Studio-projektek listázása/v1/architecture/projectsProjekt létrehozása/v1/architecture/projects/{id}Projekt és elemei lekérése/v1/architecture/projects/{id}/itemsHozzáadás egy projekthez/v1/architecture/projects/{id}/compliance„Reprezentatív kép” címkék listázása/v1/architecture/projects/{id}/compliance„Reprezentatív kép” címke hozzáadása/v1/architecture/projects/{id}/compliance/{stamp}Címke visszavonása/v1/architecture/projects/{id}/productsEgy kép terméklistái/v1/architecture/projects/{id}/productsTerméklista készítése egy renderből/v1/architecture/products/{id}Terméklista lekérése vagy letöltéseÁ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.
| Modell | Feladat | API (USD) |
|---|---|---|
| Nano Banana Pro | Kép · kép · 2K | $0.13 |
| GPT Image 2.5 Flare | Kép · kép · 2K | $0.055 |
| FCA Magic Pro | Kép · kép · 2K | $0.03 |
| Kling 3.0 Pro | Videó · másodpercenként · 1080p | $0.11 |
| FCA Magic V3 | Videó · másodpercenként · 1080p | $0.017 |
| ElevenLabs v3 | Hang · klip | $0.024 |
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.
X-RateLimit-*key_spend_cap_reachedSDK-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.
Az interaktív referencia: próbálj ki kéréseket a böngésződben, és másold ki a példakódot.
