API hujjatlari
Asinxron vazifalar, imzolangan webhook’lar, OpenAI bilan mos endpoint’lar. Har bir ishga tushirish uchun to‘laysiz, muvaffaqiyatsiz vazifalar uchun pul qaytariladi.
https://api.fcaai.ai/v1Tezkor boshlash
- 1Kalit yaratishHisob › Dasturchi kalitlari. Ishlab chiqishni production’dan ajratish uchun test kalitidan foydalaning; ishga tushirishlar bir xil hisoblanadi:
fcaai_test_UniFCAAI_API_KEYga joylang; SDK’lar va CLI uni o‘sha yerdan o‘qiydi. - 2SDK yoki CLI’ni o‘rnatingNode 18+, Deno, Bun va edge muhitlari uchun TypeScript, Python 3.9+ yoki terminal. curl o‘rnatishni talab qilmaydi.
npm i @fcaai/sdkpip install fcaainpm i -g @fcaai/cli - 3Birinchi yaratishni ishga tushiringChaqiruv darhol vazifa id’si va narxi bilan 202 qaytaradi.
{ wait: true }bilan SDK vazifa tugagach javob qaytaradi.
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", … }]Autentifikatsiya
Har bir so‘rovda kalitingizni bearer token sifatida yuboring.
fcaai_live_bilan boshlanadigan kalitlar production uchun,fcaai_test_bilan boshlanadiganlari esa ishlab chiqish uchun. Ikkalasi ham bir xil hisoblanadi; test kalitlari faqat muhitlarni ajratib turadi.- Kalit faqat bir marta — yaratganingizda ko‘rsatiladi, biz esa faqat uning izini saqlaymiz. Uni
FCAAI_API_KEYkabi muhit o‘zgaruvchisida saqlang, hech qachon brauzer yoki ilovada ishlaydigan kodda emas. - Kalit yo‘q, noto‘g‘ri, bekor qilingan yoki muddati o‘tgan bo‘lsa — 401. Kerakli ruxsat doirasi bo‘lmagan yoki ruxsat ro‘yxatidan tashqaridagi IP’dan ishlatilgan kalit — 403.
curl https://api.fcaai.ai/v1/models \
-H "Authorization: Bearer $FCAAI_API_KEY"Natijalar qanday qaytadi
Har bir yaratish — bu vazifa: queued → running → succeeded, failed yoki canceled. Muvaffaqiyatsiz va bekor qilingan vazifalar uchun pul qaytariladi.
- Uzoq so‘rov:
?wait=50so‘rovni 60 s gacha ochiq tutadi va vazifa tugashi bilan javob qaytaradi. - Webhook: vazifa tugaganda bitta imzolangan hodisa.
- SDK: TypeScript’da
{ wait: true }, Python’dawait=True.
{
"id": "cmvusmtm300234pbo7l6ecl3f",
"object": "generation",
"model": "fca/magic-pro",
"status": "queued",
"price_usd": 0.03,
"currency": "USD",
"eta_seconds": 14,
"output": null
}Yaratishni bekor qilish
Navbatdagi yaratishni bekor qilish mumkin, band qilingan summa bo‘shatiladi. Boshlangandan keyin odatda bo‘lmaydi: 409 already_started olasiz, u esa tugaydi va odatdagidek hisoblanadi.
- Avval yaratishdagi
cancellableni o‘qing: u navbatda turganda doim true, boshlangach odatda false bo‘ladi. - Allaqachon tugagan yaratishni bekor qilish uni o‘zgarishsiz qaytaradi.
# 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 usualFoydalanish va balans
GET /v1/account/usage yaratishlar, xatolar va xarajatni USD’da kun va model bo‘yicha qaytaradi. from va to ni YYYY-MM-DD ko‘rinishida bermasangiz, oxirgi 30 kunni qamraydi.
GET /v1/account/balancemavjud balansingizni USD’da qaytaradi.
# 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"Qo‘llanmalar
Eng ko‘p uchraydigan vazifalar uchun bosqichma-bosqich retseptlar. Misollar rasmiy SDK’lardan foydalanadi; curl yorlig‘i oddiy HTTP so‘rovni ko‘rsatadi.
Rasmni namuna rasmlar bilan tahrirlash
Tahrirlanadigan fotoni va namuna rasmlaringizni bitta images ro‘yxatida yuboring, so‘ng o‘zgarishni tasvirlang. Rasmlarga tartib raqami bilan murojaat qiling (1-rasm, 2-rasm…).
- 1Mahalliy fayllarni yuklang yoki istalgan ommaviy https URL’dan foydalaning.
- 2Tahrirlanadigan rasmni
imagesda birinchi qo‘ying; qolganlari namuna bo‘ladi. - 3Model tafsilotlarida
constraints.max_input_imagesni tekshiring: u model nechta rasm qabul qilishini ko‘rsatadi.
Kutubxonangizdagi saqlangan personajlar, mahsulotlar va joylarni element_ids orqali qo‘shish mumkin (3 tagacha); ularning namuna rasmlari biz tomonda biriktiriladi.
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": …, … }Boshlang‘ich va yakuniy kadr bilan rasmdan video
Video modellar birinchi kadrni image da, qo‘llab-quvvatlasa, oxirgi kadrni end_image da qabul qiladi. Klip biridan ikkinchisiga o‘tadi.
- 1Modelni tekshiring:
constraints.features.end_frametrue bo‘lishi va davomiylikconstraints.durationga mos kelishi kerak. - 2
image,end_image, prompt va davomiylikni yuboring. Kamera harakatlari oddiy prompt matni bilan yoziladi. - 3Video bir necha daqiqa oladi: uzunroq kutish vaqti bilan kuting yoki webhook’dan foydalaning.
features.reference ga ega modellarda namuna rejimi ham bor: kadrlar o‘rniga reference_images ni yuboring va promptda ularni @Image1, @Image2 deb ataling. Uni image yoki end_image bilan birga ishlatib bo‘lmaydi.
# 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}}'Rasmni kattalashtirish
Kattalashtirgichlar bitta image va tier dagi masshtabni qabul qiladi. fca/upscale ikki ko‘rinishga ega: fotolar uchun Standart (16x gacha) va renderlar, rejalar va matn uchun Tiniq (4x gacha).
- 1Manba o‘lchamingiz uchun narxni oling:
?tier=4x&source_width=…&source_height=…. - 2Rasm va masshtabni yuboring.
"tier": "max"rasmga mos keladigan eng katta masshtabni tanlaydi (natija 64 MP gacha). - 3Yangi o‘lcham natijadagi
width / heightda ko‘rsatiladi.
Yaxshilagichlar, yorug‘likni o‘zgartirish, kengaytirish, fonni olib tashlash va videoni kattalashtirish GET /v1/models?type=upscale bilan ro‘yxatlanadi.
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"}}}'Shablonni ishga tushirish
Shablonlar — bir nechta nomlangan kirishga ega tayyor retseptlar. Prompt biz tomonda qoladi: siz qiymatlarni yuborasiz va oddiy yaratish natijasini olasiz.
- 1Shablonning
inputs(kalit, tur, majburiy, variantlar) vapricingni ko‘rish uchun uni oling. - 2Uni
{ "values": { key: value } }bilan ishga tushiring. Rasm kirishlari https URL qabul qiladi. - 3Uni boshqa vazifalar kabi kuting. Noto‘g‘ri qiymat
fieldsbilan 400invalid_valuesqaytaradi.
Ko‘p bosqichli shablonlar (package) bir necha bosqichli shablon ishga tushirishini boshlaydi: templates.runPackage / run_package dan foydalaning.
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})Avval narx va model sozlamalarini oling
Bitta bepul chaqiruv model qabul qiladigan hamma narsani va sozlamalaringiz uchun aniq narxni qaytaradi. U POST /v1/generations bilan bir xil narx mantig‘idan foydalanadi, shuning uchun ko‘rsatilgan narx aynan to‘laydiganingiz.
- 1Yuboradigan sozlamalaringiz bilan
GET /v1/models/{id}ni chaqiring:duration · resolution · quality · tier · count · audio=1 · images=2 · end_image=1 · reference_images=3. - 2Ishga tushirishdan oldin narxni
estimate.price_usddan o‘qing vaavailabilityni tekshiring. - 3Formangizni
optionsvaconstraintsasosida tuzing: tomonlar nisbati, aniqlik, davomiylik, maksimal natijalar, maksimal kirish rasmlari va imkoniyatlar.
Model ruxsat bermagan qiymat invalid_params da maydon va ruxsat etilgan qiymatlar bilan qaytadi.
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 keyFayllaringizni yuklang
Har bir kirish — https URL. Ommaviy URL’lar o‘z holicha ishlaydi; mahalliy fayllarni avval yuklang va qaytgan url dan foydalaning.
- 150 MB gacha:
POST /v1/uploadsga bitta so‘rov. - 22 GB gacha: sessiya oching, 8 MB lik qismlarni istalgan tartibda (parallel ham) yuboring, so‘ng uni yakunlang.
- 3Uzilgan yuklashni davom ettirish yoki allaqachon saqlangan faylni o‘tkazib yuborish uchun sessiyani ochayotganda
sha256ni yuboring.
SDK’lar va CLI faylni bo‘ladi, bir vaqtda 3 ta qism yuboradi va sessiya id’si bilan davom ettiradi.
# ≤ 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"Natijalarni webhook orqali olish
So‘rab turish o‘rniga vazifa tugaganda serveringizni chaqirishimizga ruxsat bering. Butun hisob uchun URL ro‘yxatdan o‘tkazing yoki bitta so‘rovga options.webhook_url qo‘shing (uning maxfiy kaliti bir marta webhook_secret sifatida qaytadi).
- 1
POST /v1/webhooksorqali ro‘yxatdan o‘ting: https URL’ingiz va kerakli hodisalar.secretfaqat bir marta ko‘rsatiladi, shuning uchun uni saqlab qo‘ying. - 2Har bir yetkazishni tekshiring:
X-FCAAI-Signature: t=…,v1=…— bu maxfiy kalitingiz bilant + "." + rawBodyning HMAC-SHA256 qiymati. Xom tanadan foydalaning va eski vaqt belgilarini rad eting. - 3Tezda 2xx javob bering, ishni keyin bajaring. Muvaffaqiyatsiz yetkazish jami 5 marta sinab ko‘riladi: darhol, so‘ng 30 s, 2 daq, 10 daq va 1 soatdan keyin. Har bir urinish
GET /v1/webhooks/{id}/deliveriesda.
Hodisa bir necha marta kelishi mumkin; takrorlarni o‘tkazib yuborish uchun uning id sidan foydalaning.
Faqat ommaviy https manzillar qabul qilinadi va manzil har bir yetkazishda qayta tekshiriladi.
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"Xatolar va e’tiborsiz qoldirilgan sozlamalar bilan ishlash
Xatolar barqaror error.code bilan JSON ko‘rinishida qaytadi, unga qarab tarmoqlashingiz mumkin. Qo‘llab bo‘lmaydigan sozlama vazifani buzmaydi: u ignored_fields da ro‘yxatlanadi.
- 1HTTP holati va
error.codeni tekshiring. Qiymat noto‘g‘ri bo‘lsa,allowedto‘g‘ri qiymatlarni ko‘rsatadi. - 2429 va 5xx ni
Retry-Afterdan keyin, hech narsa ikki marta hisoblanmasligi uchun o‘shaIdempotency-Keybilan qayta yuboring. SDK’lar ikkalasini ham siz uchun bajaradi. - 3202 javobidagi
ignored_fieldsni o‘qing; har bir yozuvdafield · reason · messagebor.
Muvaffaqiyatsiz vazifalar uchun pul avtomatik qaytariladi. Agar modelning odatiy yo‘nalishi ishlamasa, vazifa o‘zi zaxira yo‘nalishga o‘tadi; 503 model_unavailable hozir bo‘sh yo‘nalish yo‘qligini bildiradi.
| Holat | Kodlar | Nima qilish kerak |
|---|---|---|
| 400 | invalid_bodyinvalid_durationinvalid_aspect_ratiomodel_not_allowed | Maydon yetishmaydi yoki bu model uchun ruxsat etilmagan. So‘rovni tuzating; o‘zgartirmasdan qayta yuborish yana xato beradi. |
| 401 | invalid_api_keyapi_key_revokedapi_key_expired | Kalit yo‘q, noto‘g‘ri, bekor qilingan yoki muddati o‘tgan. |
| 402 | insufficient_balancekey_spend_cap_reached | Balans yetarli emas yoki kalit oylik chegarasiga yetgan. Hech narsa hisobdan yechilmadi. |
| 403 | insufficient_scopeip_not_allowed | Kalitda ruxsat doirasi yetishmaydi (required_scope ga qarang) yoki so‘rov IP manzili ruxsat ro‘yxatida yo‘q. |
| 404 | model_not_found | Bunday model yo‘q yoki u kalitingiz uchun ochiq emas. |
| 429 | rate_limited | So‘rovlar juda ko‘p. Retry-After dagi vaqtni kuting. |
| 503 | model_unavailable | Model band yoki oflayn. Birozdan keyin qayta urining yoki boshqa model tanlang. |
ignored_fields dagi sabablarunknown_field- Bu so‘rovning maydoni emas; imloni tekshiring.
not_supported_by_model- To‘g‘ri maydon, lekin bu model uni qabul qilmaydi.
nearest_supported- Bu tomonlar nisbati taklif qilinmaydi; eng yaqini ishlatiladi.
follows_input_image- Tahrirlashda bu model kirish rasmining o‘lchami yoki nisbatini saqlaydi.
unpriced_extra- Model belgilamagan qo‘shimcha sozlama olib tashlandi.
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 bilan mos endpoint’lar
OpenAI mijozidan foydalanayotgan kod ikki narsani o‘zgartirgach ishlaydi: asosiy URL va kalit. Chat va rasm yaratish qo‘llab-quvvatlanadi.
- 1Asosiy URL’ni
https://api.fcaai.ai/v1ga o‘rnating va API kaliti sifatida fcaai kalitingizdan foydalaning. - 2Chat:
fca/chatmodeli bilanPOST /v1/chat/completions. Oqimli javob, vositalar va JSON natija odatdagidek ishlaydi. - 3Rasmlar:
POST /v1/images/generations90 s gacha kutadi vadata[].urlqaytaradi. Vazifa uzoqroq davom etsa,fcaai.generation_idbilan 202 olasiz; uniGET /v1/generations/{id}bilan kuzating.
Video, audio, 3D, kattalashtirish va barcha model sozlamalari uchun POST /v1/generations dan foydalaning.
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": … } }O‘z mijozlaringizga qayta soting
Diler hisoblari har bir mijoz uchun quyi hisob ochib, unga alohida kalitlar berishi va har bir mijoz bo‘yicha foydalanishni ulgurji narxda kuzatishi mumkin.
- 1
reseller:manageruxsat doirasiga ega boshqaruv kalitidan foydalaning. Mijoz kalitlari uni hech qachon olmaydi. - 2Mijozni
POST /v1/reseller/subtenantsbilan, so‘ng uning kalitiniPOST /v1/reseller/subtenants/{id}/keysbilan yarating. To‘liq kalit faqat bir marta ko‘rsatiladi. - 3Har bir mijoz bo‘yicha foydalanish va marjani
GET /v1/reseller/usagebilan kuzating. Yaratishlarda o‘z yakuniy foydalanuvchilaringizni belgilash uchunexternal_user_idni yuboring.
Diler ruxsat doirasi bo‘lmagan kalitlar bu endpoint’larda 403 oladi.
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"Nimalar yaratish mumkin
69 ta endpoint. Har biri to‘liq ma’lumotnomada curl, TypeScript va Python misollari bilan berilgan.
/v1/modelsModellar ro‘yxati/v1/models/{id}Model tafsiloti + narx hisobi/v1/voicesKlonlangan ovozlaringiz/v1/style-kitsUslub to‘plamlari/v1/elementsElementlar/v1/voice-stylesNutq uslublari/v1/voices/cloneOvozni klonlash (rozilik talab qilinadi)/v1/voices/{id}Klonlangan ovoz nomini o‘zgartirish/v1/voices/{id}Klonlangan ovozni o‘chirish (butunlay)/v1/models/{id}/voicesNutq modeli uchun ovozlar/v1/templatesShablonlar ro‘yxati/v1/templates/{slug}Shablon va uning kirishlarini olish/v1/templates/{slug}/runShablonni ishga tushirish (asinxron)/v1/templates/runs/{id}Ko‘p bosqichli shablon ishga tushirishini olish/v1/templates/runs/{id}/planShablon ishga tushirish rejasini tasdiqlang yoki qayta yozing/v1/templates/runs/{id}/cancelKo‘p bosqichli shablon ishga tushirishini bekor qilish/v1/flowsFlow’lar ro‘yxati/v1/flows/{id}Flow va uning kirishlarini olish/v1/flows/{id}/runFlow’ni ishga tushirish (asinxron)/v1/community/templatesHamjamiyat shablonlari ro‘yxati/v1/community/templates/{id}Hamjamiyat shablonini olish/v1/flows/runs/{id}Flow ishga tushirishini olish/v1/timelinesSahna taymlaynini yaratish/v1/timelines/{id}Taymlaynni olish/v1/timelines/{id}/{action}Ko‘rib chiqish, tasdiqlash, to‘liq sifatga keltirish, kesish/v1/farm/jobsRender fermasi vazifalari ro‘yxati/v1/farm/jobs/{id}/pauseRender fermasi vazifasini pauza qilish/v1/farm/jobs/{id}/resumeRender fermasi vazifasini davom ettirish/v1/farm/jobs/{id}Render fermasi vazifasini olish/v1/video-editsVideoni tahrirlash: kesish, birlashtirish, rasmlar, matn va logotip, ovoz yo‘lagi (asinxron, bepul)/v1/generationsYaratishlar ro‘yxati/v1/generationsYaratish boshlash (asinxron)/v1/generations/{id}Yaratishni olish (wait bilan uzoq so‘rov)/v1/generations/{id}/cancelBekor qilish (band qilingan balans bo‘shatiladi)/v1/uploadsKirish faylini yuklash (≤ 50 MB)/v1/uploads/sessionsQismlab yuklashni boshlash (2 GB gacha)/v1/uploads/sessions/{id}Sessiya holati (qabul qilingan qismlar, yetishmayotgan oraliqlar)/v1/uploads/sessions/{id}Qismlab yuklashni bekor qilish/v1/uploads/sessions/{id}/chunks/{index}Bitta qismni yuklash (xom tana)/v1/uploads/sessions/{id}/completeQismlab yuklashni yakunlash/v1/accountHisob, kalit va balans/v1/account/balanceBalans (USD)/v1/account/usageKun va model bo‘yicha foydalanish/v1/webhooksWebhook’lar ro‘yxati/v1/webhooksWebhook yaratish (maxfiy kalit bir marta qaytadi)/v1/webhooks/{id}Webhook’ni o‘chirish/v1/webhooks/{id}/deliveriesYetkazish jurnali/v1/reseller/subtenantsMijozlaringiz ro‘yxati (quyi ijarachilar)/v1/reseller/subtenantsMijoz yaratish (quyi ijarachi)/v1/reseller/subtenants/{id}/keysMijoz uchun API kaliti yaratish (maxfiy kalit bir marta qaytadi)/v1/reseller/usageHar bir mijoz bo‘yicha foydalanish va ulgurji xarajat/v1/chat/completionsChat javobi (OpenAI sxemasi)/v1/images/generationsRasm yaratish (OpenAI sxemasi, sinxron ≤ 90 s)/v1/boards/{board_id}/approvalsDoskadagi tasdiqlash so‘rovlari ro‘yxati/v1/boards/{board_id}/approvals/{request_id}Tasdiqlash so‘rovini olish/v1/boards/{board_id}/approvals/{request_id}/decideVariantni tasdiqlash yoki o‘zgartirish so‘rash/v1/plans/readReja chizmasini o‘qish/v1/panoramas/finish360° panoramani yakunlash/v1/flows/runs/{id}/cancelFlow ishga tushirishini bekor qilish/v1/architecture/projectsArchitecture Studio loyihalari ro‘yxati/v1/architecture/projectsLoyiha yaratish/v1/architecture/projects/{id}Loyiha va uning elementlarini olish/v1/architecture/projects/{id}/itemsLoyihaga qo‘shish/v1/architecture/projects/{id}/compliance«Namunaviy tasvir» yorliqlari ro‘yxati/v1/architecture/projects/{id}/compliance«Namunaviy tasvir» yorlig‘ini qo‘shish/v1/architecture/projects/{id}/compliance/{stamp}Yorliqni qaytarib olish/v1/architecture/projects/{id}/productsRasmning mahsulot ro‘yxatlari/v1/architecture/projects/{id}/productsRenderdan mahsulot ro‘yxati tuzish/v1/architecture/products/{id}Mahsulot ro‘yxatini olish yoki yuklab olishNarxlar
Har bir ishga tushirish uchun dollarda, tarifingiz bilan bir xil balansdan. Bular standart sozlamalardagi joriy narxlar; har bir model sahifasida aniqlik va davomiylik bo‘yicha barcha narxlar keltirilgan.
| Model | Vazifa | API (USD) |
|---|---|---|
| Nano Banana Pro | Rasm · rasm · 2K | $0.13 |
| GPT Image 2.5 Flare | Rasm · rasm · 2K | $0.055 |
| FCA Magic Pro | Rasm · rasm · 2K | $0.03 |
| Kling 3.0 Pro | Video · har soniya · 1080p | $0.11 |
| FCA Magic V3 | Video · har soniya · 1080p | $0.017 |
| ElevenLabs v3 | Audio · klip | $0.024 |
Kalitlar va limitlar
Har bir kalitning o‘z ruxsat doirasi, so‘rov tezligi va xarajat chegarasi bor. Qolgan miqdor javob sarlavhalarida ko‘rinadi.
X-RateLimit-*key_spend_cap_reachedSDK’lar va vositalar
Rasmiy TypeScript va Python SDK’lari hamda CLI. SDK’lar idempotentlik kalitlari bilan xavfsiz qayta urinadi, natijalarni kutadi, katta fayllarni qismlab yuklaydi va webhook imzolarini tekshiradi.
Interaktiv ma’lumotnoma: so‘rovlarni brauzerda sinab ko‘ring va misol kodini nusxalang.
