Kontentga o‘tish
fcaaiKirishBepul boshlash
v1.1 · FaolREST · JSONUSD

API hujjatlari

Asinxron vazifalar, imzolangan webhook’lar, OpenAI bilan mos endpoint’lar. Har bir ishga tushirish uchun to‘laysiz, muvaffaqiyatsiz vazifalar uchun pul qaytariladi.

Asosiy URLhttps://api.fcaai.ai/v1

Tezkor boshlash

  1. Kalit yaratishHisob › Dasturchi kalitlari. Ishlab chiqishni production’dan ajratish uchun test kalitidan foydalaning; ishga tushirishlar bir xil hisoblanadi: fcaai_test_ Uni FCAAI_API_KEY ga joylang; SDK’lar va CLI uni o‘sha yerdan o‘qiydi.
  2. SDK 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
  3. Birinchi 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_KEY kabi 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.

{
  "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 cancellable ni 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 usual

Foydalanish 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/balance mavjud 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"
Bosqichma-bosqich

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…).

  1. Mahalliy fayllarni yuklang yoki istalgan ommaviy https URL’dan foydalaning.
  2. Tahrirlanadigan rasmni images da birinchi qo‘ying; qolganlari namuna bo‘ladi.
  3. Model tafsilotlarida constraints.max_input_images ni 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.

  1. Modelni tekshiring: constraints.features.end_frame true bo‘lishi va davomiylik constraints.duration ga mos kelishi kerak.
  2. image, end_image, prompt va davomiylikni yuboring. Kamera harakatlari oddiy prompt matni bilan yoziladi.
  3. Video 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).

  1. Manba o‘lchamingiz uchun narxni oling: ?tier=4x&source_width=…&source_height=….
  2. Rasm va masshtabni yuboring. "tier": "max" rasmga mos keladigan eng katta masshtabni tanlaydi (natija 64 MP gacha).
  3. Yangi o‘lcham natijadagi width / height da 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.

  1. Shablonning inputs (kalit, tur, majburiy, variantlar) va pricing ni ko‘rish uchun uni oling.
  2. Uni { "values": { key: value } } bilan ishga tushiring. Rasm kirishlari https URL qabul qiladi.
  3. Uni boshqa vazifalar kabi kuting. Noto‘g‘ri qiymat fields bilan 400 invalid_values qaytaradi.

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.

  1. Yuboradigan sozlamalaringiz bilan GET /v1/models/{id} ni chaqiring: duration · resolution · quality · tier · count · audio=1 · images=2 · end_image=1 · reference_images=3.
  2. Ishga tushirishdan oldin narxni estimate.price_usd dan o‘qing va availability ni tekshiring.
  3. Formangizni options va constraints asosida 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 key

Fayllaringizni yuklang

Har bir kirish — https URL. Ommaviy URL’lar o‘z holicha ishlaydi; mahalliy fayllarni avval yuklang va qaytgan url dan foydalaning.

  1. 50 MB gacha: POST /v1/uploads ga bitta so‘rov.
  2. 2 GB gacha: sessiya oching, 8 MB lik qismlarni istalgan tartibda (parallel ham) yuboring, so‘ng uni yakunlang.
  3. Uzilgan yuklashni davom ettirish yoki allaqachon saqlangan faylni o‘tkazib yuborish uchun sessiyani ochayotganda sha256 ni 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/webhooks orqali ro‘yxatdan o‘ting: https URL’ingiz va kerakli hodisalar. secret faqat bir marta ko‘rsatiladi, shuning uchun uni saqlab qo‘ying.
  2. Har bir yetkazishni tekshiring: X-FCAAI-Signature: t=…,v1=… — bu maxfiy kalitingiz bilan t + "." + rawBody ning HMAC-SHA256 qiymati. Xom tanadan foydalaning va eski vaqt belgilarini rad eting.
  3. Tezda 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}/deliveries da.

Hodisa bir necha marta kelishi mumkin; takrorlarni o‘tkazib yuborish uchun uning id sidan foydalaning.

Hodisalar
generation.succeededgeneration.failedgeneration.canceledflow_run.succeededflow_run.failedflow_run.canceledtimeline.preview_readytimeline.donetimeline.failedapproval.requestedapproval.decided

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.

  1. HTTP holati va error.code ni tekshiring. Qiymat noto‘g‘ri bo‘lsa, allowed to‘g‘ri qiymatlarni ko‘rsatadi.
  2. 429 va 5xx ni Retry-After dan keyin, hech narsa ikki marta hisoblanmasligi uchun o‘sha Idempotency-Key bilan qayta yuboring. SDK’lar ikkalasini ham siz uchun bajaradi.
  3. 202 javobidagi ignored_fields ni o‘qing; har bir yozuvda field · reason · message bor.

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.

HolatKodlarNima qilish kerak
400invalid_bodyinvalid_durationinvalid_aspect_ratiomodel_not_allowedMaydon yetishmaydi yoki bu model uchun ruxsat etilmagan. So‘rovni tuzating; o‘zgartirmasdan qayta yuborish yana xato beradi.
401invalid_api_keyapi_key_revokedapi_key_expiredKalit yo‘q, noto‘g‘ri, bekor qilingan yoki muddati o‘tgan.
402insufficient_balancekey_spend_cap_reachedBalans yetarli emas yoki kalit oylik chegarasiga yetgan. Hech narsa hisobdan yechilmadi.
403insufficient_scopeip_not_allowedKalitda ruxsat doirasi yetishmaydi (required_scope ga qarang) yoki so‘rov IP manzili ruxsat ro‘yxatida yo‘q.
404model_not_foundBunday model yo‘q yoki u kalitingiz uchun ochiq emas.
429rate_limitedSo‘rovlar juda ko‘p. Retry-After dagi vaqtni kuting.
503model_unavailableModel band yoki oflayn. Birozdan keyin qayta urining yoki boshqa model tanlang.
ignored_fields dagi sabablar
unknown_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.

  1. Asosiy URL’ni https://api.fcaai.ai/v1 ga o‘rnating va API kaliti sifatida fcaai kalitingizdan foydalaning.
  2. Chat: fca/chat modeli bilan POST /v1/chat/completions. Oqimli javob, vositalar va JSON natija odatdagidek ishlaydi.
  3. Rasmlar: POST /v1/images/generations 90 s gacha kutadi va data[].url qaytaradi. Vazifa uzoqroq davom etsa, fcaai.generation_id bilan 202 olasiz; uni GET /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:manage ruxsat doirasiga ega boshqaruv kalitidan foydalaning. Mijoz kalitlari uni hech qachon olmaydi.
  2. Mijozni POST /v1/reseller/subtenants bilan, so‘ng uning kalitini POST /v1/reseller/subtenants/{id}/keys bilan yarating. To‘liq kalit faqat bir marta ko‘rsatiladi.
  3. Har bir mijoz bo‘yicha foydalanish va marjani GET /v1/reseller/usage bilan kuzating. Yaratishlarda o‘z yakuniy foydalanuvchilaringizni belgilash uchun external_user_id ni 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"
Ma’lumotnoma

Nimalar yaratish mumkin

69 ta endpoint. Har biri to‘liq ma’lumotnomada curl, TypeScript va Python misollari bilan berilgan.

GET/v1/style-kitsUslub to‘plamlari
GET/v1/elementsElementlar
POST/v1/video-editsVideoni tahrirlash: kesish, birlashtirish, rasmlar, matn va logotip, ovoz yo‘lagi (asinxron, bepul)
GET/v1/generationsYaratishlar ro‘yxati
POST/v1/generationsYaratish boshlash (asinxron)
GET/v1/generations/{id}Yaratishni olish (wait bilan uzoq so‘rov)
POST/v1/generations/{id}/cancelBekor qilish (band qilingan balans bo‘shatiladi)

Narxlar

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.

ModelVazifaAPI (USD)
Nano Banana ProRasm · rasm · 2K$0.13
GPT Image 2.5 FlareRasm · rasm · 2K$0.055
FCA Magic ProRasm · rasm · 2K$0.03
Kling 3.0 ProVideo · har soniya · 1080p$0.11
FCA Magic V3Video · har soniya · 1080p$0.017
ElevenLabs v3Audio · klip$0.024
Narxni so‘rash bepulMuvaffaqiyatsiz ishga tushirishlar uchun pul qaytariladiAvtomatik to‘ldirish standart holatda o‘chiqAPI’da cheksiz tarif yo‘q

Kalitlar va limitlar

Har bir kalitning o‘z ruxsat doirasi, so‘rov tezligi va xarajat chegarasi bor. Qolgan miqdor javob sarlavhalarida ko‘rinadi.

120 / daqHar bir kalit uchun standart so‘rov tezligi. X-RateLimit-*
2Har bir kalit uchun bir vaqtda ishlaydigan vazifalar (oshirish mumkin).
Oylik chegaraUSD’da; chegaraga yetilganda so‘rovlar 402 oladi key_spend_cap_reached
Ruxsat doirasiRasm, video, audio, 3D, kattalashtirish va LLM birma-bir yoqiladi.
IP ruxsat ro‘yxatiKalitni serverlaringiz IP manzillariga bog‘lang.
Idempotency-KeyBir xil kalit bilan qayta urinish hech qachon ikki marta haq olmaydi.

SDK’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.

TypeScriptnpmjs.com (yangi varaqda ochiladi)Node 18+, Deno, Bun va edge muhitlari
Pythonpypi.org (yangi varaqda ochiladi)Python 3.9+, faqat standart kutubxona
CLInpmjs.com (yangi varaqda ochiladi)Har bir model terminalingizda
MCPSun’iy intellekt agentlaringizni o‘sha modellar va o‘sha balansga ulang.
Har bir endpoint, maydon va xato kodi

Interaktiv ma’lumotnoma: so‘rovlarni brauzerda sinab ko‘ring va misol kodini nusxalang.

To‘liq API ma’lumotnomasi(yangi varaqda ochiladi)