Мазмұнға өту
fcaaiКіруТегін бастау
v1.1 · Іске қосылғанREST · JSONUSD

API құжаттамасы

Асинхронды тапсырмалар, қолтаңбалы webhook-тар, OpenAI-үйлесімді нүктелер. Әр іске қосу үшін төлейсіз, ал сәтсіз тапсырмалар қайтарылады.

Негізгі URLhttps://api.fcaai.ai/v1

Жылдам бастау

  1. Кілт жасаңызТіркелгі › Әзірлеуші кілттері. Әзірлеуді өндірістен бөлек ұстау үшін тест кілтін қолданыңыз; іске қосулар бірдей есептеледі: fcaai_test_ Оны FCAAI_API_KEY ішіне қойыңыз; SDK мен CLI оны сол жерден оқиды.
  2. SDK не CLI орнатыңызNode 18+, Deno, Bun және edge орталарына TypeScript, Python 3.9+ немесе терминал. curl орнатуды қажет етпейді. npm i @fcaai/sdkpip install fcaainpm i -g @fcaai/cli
  3. Алғашқы жасауыңызды іске қосыңызШақыру тапсырма идентификаторы мен бағасымен бірден 202 қайтарады. { wait: true } болса, SDK тапсырма аяқталған соң қайтады.
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", … }]

Аутентификация

Кілтіңізді әр сұраныспен bearer токені ретінде жіберіңіз.

  • fcaai_live_ деп басталатын кілттер өндіріске, ал fcaai_test_ деп басталатындар әзірлеуге арналған. Екеуі де бірдей есептеледі; тест кілттері тек орталарды бөліп ұстайды.
  • Кілт жасалған кезде бір рет көрсетіледі, ал біз тек оның цифрлық ізін сақтаймыз. Оны браузерде не қолданбада іске қосылатын кодта емес, FCAAI_API_KEY сияқты орта айнымалысында сақтаңыз.
  • Жоқ, қате, кері қайтарылған не мерзімі өткен кілт 401 қайтарады. Тиісті рұқсат аясы жоқ немесе рұқсат тізімінен тыс IP-ден қолданылған кілт 403 қайтарады.
curl https://api.fcaai.ai/v1/models \
  -H "Authorization: Bearer $FCAAI_API_KEY"

Нәтижелер қалай қайтады

Әр жасау — тапсырма: queued → running → succeeded, failed не canceled. Сәтсіз және тоқтатылған тапсырмалар қайтарылады.

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

Жасауды тоқтату

Кезектегі жасауды тоқтатуға болады, сонда резервтегі сома босатылады. Басталып кеткен соң әдетте тоқтату мүмкін емес: 409 already_started аласыз, ал ол аяқталып, әдеттегідей ақы алынады.

  • Алдымен жасаудағы cancellable оқыңыз: кезекте тұрғанда ол әрқашан true, басталған соң әдетте false.
  • Аяқталып қойған жасауды тоқтату оны өзгеріссіз қайтарады.
# 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

Пайдалану және баланс

GET /v1/account/usage жасауларды, сәтсіздіктерді және USD-мен шығынды күн мен модель бойынша қайтарады. from және to мәндерін YYYY-MM-DD түрінде бермесеңіз, соңғы 30 күнді қамтиды.

  • GET /v1/account/balance қолжетімді балансыңызды USD-мен қайтарады.
# 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"
Қадам-қадаммен

Нұсқаулықтар

Ең жиі тапсырмаларға қадамдық рецепттер. Мысалдар ресми SDK-ны қолданады; curl қойындысы қарапайым HTTP сұранысын көрсетеді.

Суретті референс суреттермен өңдеу

Өңделетін фото мен референс суреттеріңізді бір images тізімінде жіберіп, өзгерісті сипаттаңыз. Суреттерге ретімен сілтеме жасаңыз (1-сурет, 2-сурет…).

  1. Жергілікті файлдарды жүктеп салыңыз немесе кез келген ашық https URL қолданыңыз.
  2. Өңделетін суретті images ішінде бірінші қойыңыз; қалғандары — референстер.
  3. Модель мәліметтеріндегі constraints.max_input_images мәнін тексеріңіз: ол модель қанша сурет қабылдайтынын көрсетеді.

Кітапханаңыздағы сақталған кейіпкерлерді, өнімдерді және орындарды element_ids арқылы қосуға болады (ең көбі 3); олардың референс суреттері біз жақта тіркеледі.

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": …, … }

Бастапқы және соңғы кадры бар суреттен бейнеге

Бейне модельдері бірінші кадрды image ішінде, ал қолдаса, соңғы кадрды end_image ішінде қабылдайды. Клип біреуінен екіншісіне қарай қозғалады.

  1. Модельді тексеріңіз: constraints.features.end_frame true болуы және ұзақтық constraints.duration шегіне сай болуы керек.
  2. image, end_image, промпт пен ұзақтықты жіберіңіз. Камера қозғалыстары — промпттағы қарапайым мәтін.
  3. Бейне бірнеше минут алады: ұзағырақ күту уақытымен күтіңіз немесе webhook қолданыңыз.

features.reference бар модельдерде референс режимі де бар: кадрлардың орнына reference_images жіберіп, промптта оларды @Image1, @Image2 деп атаңыз. Оны 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}}'

Суретті үлкейту

Үлкейткіштер бір image және tier ішіндегі масштабты қабылдайды. fca/upscale екі түрлі көрініске ие: фотоларға Standard (16x-ке дейін) және рендерлерге, жоспарлар мен мәтінге Sharp (4x-ке дейін).

  1. Бастапқы өлшеміңізге бағаны алыңыз: ?tier=4x&source_width=…&source_height=….
  2. Сурет пен масштабты жіберіңіз. "tier": "max" суретке сыятын ең үлкен масштабты таңдайды (нәтиже 64 МП-ге дейін).
  3. Жаңа өлшем нәтиженің width / height ішінде.

Жақсартқыштар, қайта жарықтандыру, кеңейту, фонды алып тастау және бейнені үлкейту 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"}}}'

Үлгіні іске қосу

Үлгілер — бірнеше аталған кірісі бар дайын рецепттер. Промпт біз жақта қалады: сіз мәндерді жіберіп, қалыпты жасау нәтижесін аласыз.

  1. Үлгінің inputs (кілт, түр, міндетті, параметрлер) және pricing көру үшін оны алыңыз.
  2. Оны { "values": { key: value } } арқылы іске қосыңыз. Сурет кірістері https URL қабылдайды.
  3. Оны басқа тапсырмалар сияқты күтіңіз. Қате мән fields бар 400 invalid_values қайтарады.

Көп қадамды үлгілер (package) бірнеше қадамы бар үлгі іске қосуын бастайды: 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})

Алдымен бағаны және модель параметрлерін алыңыз

Бір тегін шақыру модель қабылдайтын барлық нәрсені және баптауларыңызға дәл бағаны қайтарады. Ол POST /v1/generations сияқты баға логикасын қолданады, сондықтан есептелген баға — төлейтініңіз.

  1. Жіберетін баптауларыңызбен GET /v1/models/{id} шақырыңыз: duration · resolution · quality · tier · count · audio=1 · images=2 · end_image=1 · reference_images=3.
  2. Іске қоспас бұрын бағаны estimate.price_usd ішінен оқып, availability тексеріңіз.
  3. Пішініңізді options және constraints негізінде құрыңыз: арақатынастар, ажыратымдылықтар, ұзақтық, ең көп нәтиже, ең көп кіріс суреттер және мүмкіндіктер.

Модель рұқсат етпейтін мән invalid_params ішінде өрісімен және рұқсат етілген мәндерімен қайтарылады.

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

Файлдарыңызды жүктеп салу

Әр кіріс — https URL. Ашық URL-дер сол күйінде жұмыс істейді; жергілікті файлдарды алдымен жүктеп салып, қайтарылған url қолданыңыз.

  1. 50 МБ-қа дейін: POST /v1/uploads нүктесіне бір сұраныс.
  2. 2 ГБ-қа дейін: сеанс ашып, 8 МБ бөліктерді кез келген ретпен (параллель де) жіберіп, сосын аяқтаңыз.
  3. Үзілген жүктеп салуды жалғастыру не сақталған файлды өткізіп жіберу үшін сеансты ашқанда sha256 жіберіңіз.

SDK мен CLI файлды бөліп, бір уақытта 3 бөлік жібереді және сеанс идентификаторымен жалғастырады.

# ≤ 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"

Нәтижелерді webhook арқылы алу

Сұраудың орнына тапсырма аяқталғанда серверіңізді біз шақырайық. Бүкіл тіркелгіге URL тіркеңіз немесе жеке сұранысқа options.webhook_url қосыңыз (оның құпиясы бір рет webhook_secret ретінде қайтарылады).

  1. POST /v1/webhooks арқылы тіркеңіз: https URL-іңіз және қалаған оқиғаларыңыз. secret тек бір рет көрсетіледі, сондықтан оны сақтаңыз.
  2. Әр жеткізуді тексеріңіз: X-FCAAI-Signature: t=…,v1=… — құпияңызбен есептелген t + "." + rawBody мәнінің HMAC-SHA256-сы. Өңделмеген денені қолданып, ескі уақыт белгілерін қабылдамаңыз.
  3. 2xx жауабын жылдам беріп, жұмысты кейін істеңіз. Сәтсіз жеткізу барлығы 5 рет қайталанады: бірден, сосын 30 с, 2 мин, 10 мин және 1 сағ кейін. Әр әрекет GET /v1/webhooks/{id}/deliveries ішінде.

Оқиға бірнеше рет келуі мүмкін; қайталанғандарды өткізіп жіберу үшін оның id мәнін қолданыңыз.

Оқиғалар
generation.succeededgeneration.failedgeneration.canceledflow_run.succeededflow_run.failedflow_run.canceledtimeline.preview_readytimeline.donetimeline.failedapproval.requestedapproval.decided

Тек ашық https мекенжайлары қабылданады, мекенжай әр жеткізуде қайта тексеріледі.

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"

Қателер мен еленбеген баптауларды өңдеу

Қателер тармақтауға болатын тұрақты error.code бар JSON ретінде қайтады. Қолдануға болмайтын баптау тапсырманы құлатпайды: ол ignored_fields ішінде тізімделеді.

  1. HTTP күйі мен error.code тексеріңіз. Мән қате болса, allowed жарамдыларын тізімдейді.
  2. 429 және 5xx жағдайында Retry-After кейін сол Idempotency-Key мәнімен қайталаңыз, сонда ештеңеге екі рет ақы алынбайды. SDK екеуін де сіз үшін істейді.
  3. 202 жауабындағы ignored_fields оқыңыз; әр жазбада field · reason · message бар.

Сәтсіз тапсырмалар автоматты түрде қайтарылады. Модельдің әдеттегі бағыты істемесе, тапсырма өздігінен сақтық бағытқа ауысады; 503 model_unavailable қазір бос бағыт жоқ дегенді білдіреді.

КүйіКодтарНе істеу керек
400invalid_bodyinvalid_durationinvalid_aspect_ratiomodel_not_allowedӨріс жоқ немесе бұл модельге рұқсат етілмеген. Сұранысты түзетіңіз; оны өзгеріссіз қайта жіберу қайта сәтсіз болады.
401invalid_api_keyapi_key_revokedapi_key_expiredКілт жоқ, қате, кері қайтарылған не мерзімі өткен.
402insufficient_balancekey_spend_cap_reachedБаланс жеткіліксіз немесе кілт айлық шегіне жетті. Ақы алынған жоқ.
403insufficient_scopeip_not_allowedКілтте рұқсат аясы жоқ (required_scope қараңыз) немесе сұраныс IP-і оның рұқсат тізімінде жоқ.
404model_not_foundМұндай модель жоқ немесе ол кілтіңізге ашық емес.
429rate_limitedСұраныстар тым көп. Retry-After ішіндегі уақытты күтіңіз.
503model_unavailableМодель бос емес не желіден тыс. Біраздан соң қайталаңыз немесе басқа модель таңдаңыз.
ignored_fields ішіндегі себептер
unknown_field
Бұл сұраныстың өрісі емес; жазылуын тексеріңіз.
not_supported_by_model
Бұл модель қабылдамайтын жарамды өріс.
nearest_supported
Бұл арақатынас ұсынылмайды; ең жақыны қолданылады.
follows_input_image
Өңдеу кезінде бұл модель кіріс суреттің өлшемін не арақатынасын сақтайды.
unpriced_extra
Модель анықтамайтын қосымша баптау алынып тасталды.
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-үйлесімді нүктелер

OpenAI клиентін қолданып жүрген код екі нәрсені өзгерткен соң жұмыс істейді: негізгі URL және кілт. Чат және сурет жасау қолдау көрсетіледі.

  1. Негізгі URL-ді https://api.fcaai.ai/v1 етіп орнатып, fcaai кілтіңізді API кілті ретінде қолданыңыз.
  2. Чат: fca/chat моделімен POST /v1/chat/completions. Ағынмен беру, құралдар және JSON шығысы әдеттегідей жұмыс істейді.
  3. Суреттер: POST /v1/images/generations 90 с-қа дейін күтіп, data[].url қайтарады. Тапсырмаға көбірек уақыт керек болса, fcaai.generation_id бар 202 аласыз; оны GET /v1/generations/{id} арқылы бақылаңыз.

Бейне, аудио, 3D, үлкейту және әр модель параметрі үшін 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": … } }

Өз клиенттеріңізге қайта сату

Реселлер тіркелгілері әр клиентке қосалқы тіркелгі ашып, оған жеке кілттер беріп, әр клиенттің пайдалануын көтерме бағамен бақылай алады.

  1. reseller:manage рұқсат аясы бар басқару кілтін қолданыңыз. Клиент кілттері оны ешқашан алмайды.
  2. Клиентті POST /v1/reseller/subtenants арқылы, сосын оның кілтін POST /v1/reseller/subtenants/{id}/keys арқылы жасаңыз. Толық кілт тек бір рет көрсетіледі.
  3. Әр клиенттің пайдалануы мен маржасын GET /v1/reseller/usage арқылы бақылаңыз. Жасауларда өз соңғы пайдаланушыларыңызды белгілеу үшін external_user_id жіберіңіз.

Реселлер рұқсат аясы жоқ кілттер бұл нүктелерде 403 алады.

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"
Анықтамалық

Не құра аласыз

69 нүкте. Әрқайсысы толық анықтамалықта curl, TypeScript және Python мысалдарымен берілген.

GET/v1/style-kitsСтиль жинақтары
GET/v1/elementsЭлементтер
POST/v1/video-editsБейнені өңдеу: қию, біріктіру, суреттер, мәтін және логотип, дыбыс жолы (асинхронды, тегін)
GET/v1/generationsЖасаулар тізімі
POST/v1/generationsЖасау тапсырмасын құру (асинхронды)
GET/v1/generations/{id}Жасауды алу (wait арқылы ұзақ сұрау)
POST/v1/generations/{id}/cancelТоқтату (резервтегі баланс босатылады)

Бағалар

Әр іске қосуға доллармен, тарифіңізбен бірдей баланстан. Бұл әдепкі баптаулардағы нақты бағалар; әр модель беті әр бағаны ажыратымдылық пен ұзақтыққа қарай көрсетеді.

МодельТапсырмаAPI (USD)
Nano Banana ProСурет · сурет · 2K$0.13
GPT Image 2.5 FlareСурет · сурет · 2K$0.055
FCA Magic ProСурет · сурет · 2K$0.03
Kling 3.0 ProБейне · секундына · 1080p$0.11
FCA Magic V3Бейне · секундына · 1080p$0.017
ElevenLabs v3Аудио · клип$0.024
Баға есептеу тегінСәтсіз іске қосулар қайтарыладыАвтоматты толтыру әдепкі бойынша өшіруліAPI-да шексіз тариф жоқ

Кілттер және шектер

Әр кілттің өз рұқсат аясы, жиілігі және шығын шегі бар. Жауап тақырыптары қанша қалғанын көрсетеді.

120 / минӘр кілтке әдепкі сұраныс жиілігі. X-RateLimit-*
2Әр кілтке бір уақытта орындалатын тапсырмалар (көбейтуге болады).
Айлық шекUSD-мен; шекке жеткенде сұраныстар 402 алады key_spend_cap_reached
Рұқсат аясыСурет, бейне, аудио, 3D, үлкейту және LLM бір-бірлеп қосылады.
IP рұқсат тізіміКілтті серверлеріңіздің IP мекенжайларына байлаңыз.
Idempotency-KeyСол кілтпен қайталау ешқашан екі рет ақы алмайды.

SDK және құралдар

Ресми TypeScript және Python SDK және CLI. SDK идемпотенттік кілттермен қауіпсіз қайталайды, нәтижелерді күтеді, үлкен файлдарды бөліктермен жүктеп салады және webhook қолтаңбаларын тексереді.

TypeScriptnpmjs.com (жаңа қойындыда ашылады)Node 18+, Deno, Bun және edge орталары
Pythonpypi.org (жаңа қойындыда ашылады)Python 3.9+, тек стандартты кітапхана
CLInpmjs.com (жаңа қойындыда ашылады)Әр модель терминалыңыздан
MCPЖИ агенттеріңізді сол модельдер мен сол балансқа қосыңыз.
Әр нүкте, өріс және қате коды

Интерактивті анықтамалық: сұраныстарды браузерде көріп, мысал кодты көшіріңіз.

Толық API анықтамалығы(жаңа қойындыда ашылады)