API құжаттамасы
Асинхронды тапсырмалар, қолтаңбалы webhook-тар, OpenAI-үйлесімді нүктелер. Әр іске қосу үшін төлейсіз, ал сәтсіз тапсырмалар қайтарылады.
https://api.fcaai.ai/v1Жылдам бастау
- 1Кілт жасаңызТіркелгі › Әзірлеуші кілттері. Әзірлеуді өндірістен бөлек ұстау үшін тест кілтін қолданыңыз; іске қосулар бірдей есептеледі:
fcaai_test_ОныFCAAI_API_KEYішіне қойыңыз; SDK мен CLI оны сол жерден оқиды. - 2SDK не 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. Сәтсіз және тоқтатылған тапсырмалар қайтарылады.
- Ұзақ сұрау:
?wait=50сұранысты 60 с-қа дейін ашық ұстап, тапсырма аяқталған бойда қайтарады. - Webhook: тапсырма аяқталғанда бір қолтаңбалы оқиға.
- SDK: TypeScript-те
{ wait: true }, Python-даwait=True.
{
"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_frametrue болуы және ұзақтық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бар 400invalid_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 қолданыңыз.
- 150 МБ-қа дейін:
POST /v1/uploadsнүктесіне бір сұраныс. - 22 ГБ-қа дейін: сеанс ашып, 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-сы. Өңделмеген денені қолданып, ескі уақыт белгілерін қабылдамаңыз. - 32xx жауабын жылдам беріп, жұмысты кейін істеңіз. Сәтсіз жеткізу барлығы 5 рет қайталанады: бірден, сосын 30 с, 2 мин, 10 мин және 1 сағ кейін. Әр әрекет
GET /v1/webhooks/{id}/deliveriesішінде.
Оқиға бірнеше рет келуі мүмкін; қайталанғандарды өткізіп жіберу үшін оның id мәнін қолданыңыз.
Тек ашық 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 ішінде тізімделеді.
- 1HTTP күйі мен
error.codeтексеріңіз. Мән қате болса,allowedжарамдыларын тізімдейді. - 2429 және 5xx жағдайында
Retry-Afterкейін солIdempotency-Keyмәнімен қайталаңыз, сонда ештеңеге екі рет ақы алынбайды. SDK екеуін де сіз үшін істейді. - 3202 жауабындағы
ignored_fieldsоқыңыз; әр жазбадаfield · reason · messageбар.
Сәтсіз тапсырмалар автоматты түрде қайтарылады. Модельдің әдеттегі бағыты істемесе, тапсырма өздігінен сақтық бағытқа ауысады; 503 model_unavailable қазір бос бағыт жоқ дегенді білдіреді.
| Күйі | Кодтар | Не істеу керек |
|---|---|---|
| 400 | invalid_bodyinvalid_durationinvalid_aspect_ratiomodel_not_allowed | Өріс жоқ немесе бұл модельге рұқсат етілмеген. Сұранысты түзетіңіз; оны өзгеріссіз қайта жіберу қайта сәтсіз болады. |
| 401 | invalid_api_keyapi_key_revokedapi_key_expired | Кілт жоқ, қате, кері қайтарылған не мерзімі өткен. |
| 402 | insufficient_balancekey_spend_cap_reached | Баланс жеткіліксіз немесе кілт айлық шегіне жетті. Ақы алынған жоқ. |
| 403 | insufficient_scopeip_not_allowed | Кілтте рұқсат аясы жоқ (required_scope қараңыз) немесе сұраныс IP-і оның рұқсат тізімінде жоқ. |
| 404 | model_not_found | Мұндай модель жоқ немесе ол кілтіңізге ашық емес. |
| 429 | rate_limited | Сұраныстар тым көп. Retry-After ішіндегі уақытты күтіңіз. |
| 503 | model_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/generations90 с-қа дейін күтіп,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 мысалдарымен берілген.
/v1/modelsМодельдер тізімі/v1/models/{id}Модель мәліметі + баға есебі/v1/voicesКлондалған дауыстарыңыз/v1/style-kitsСтиль жинақтары/v1/elementsЭлементтер/v1/voice-stylesСөйлеу стильдері/v1/voices/cloneДауысты клондау (келісім қажет)/v1/voices/{id}Клондалған дауыстың атын өзгерту/v1/voices/{id}Клондалған дауысты жою (біржола)/v1/models/{id}/voicesСөйлеу моделінің дауыстары/v1/templatesҮлгілер тізімі/v1/templates/{slug}Үлгіні және оның кірістерін алу/v1/templates/{slug}/runҮлгіні іске қосу (асинхронды)/v1/templates/runs/{id}Көп қадамды үлгі іске қосуын алу/v1/templates/runs/{id}/planҮлгі іске қосу жоспарын мақұлдаңыз немесе қайта жазыңыз/v1/templates/runs/{id}/cancelКөп қадамды үлгі іске қосуын тоқтату/v1/flowsFlows тізімі/v1/flows/{id}Flow-ды және оның кірістерін алу/v1/flows/{id}/runFlow іске қосу (асинхронды)/v1/community/templatesҚауымдастық үлгілерінің тізімі/v1/community/templates/{id}Қауымдастық үлгісін алу/v1/flows/runs/{id}Flow іске қосуын алу/v1/timelinesСахна таймлайнын жасау/v1/timelines/{id}Таймлайнды алу/v1/timelines/{id}/{action}Алдын ала қарау, бекіту, толық сапада жасау, монтаждау/v1/farm/jobsРендер фермасы тапсырмаларының тізімі/v1/farm/jobs/{id}/pauseРендер фермасы тапсырмасын кідірту/v1/farm/jobs/{id}/resumeРендер фермасы тапсырмасын жалғастыру/v1/farm/jobs/{id}Рендер фермасы тапсырмасын алу/v1/video-editsБейнені өңдеу: қию, біріктіру, суреттер, мәтін және логотип, дыбыс жолы (асинхронды, тегін)/v1/generationsЖасаулар тізімі/v1/generationsЖасау тапсырмасын құру (асинхронды)/v1/generations/{id}Жасауды алу (wait арқылы ұзақ сұрау)/v1/generations/{id}/cancelТоқтату (резервтегі баланс босатылады)/v1/uploadsКіріс файлын жүктеп салу (≤ 50 МБ)/v1/uploads/sessionsБөліктік жүктеп салуды бастау (2 ГБ-қа дейін)/v1/uploads/sessions/{id}Сеанс күйі (алынған бөліктер, жоқ аралықтар)/v1/uploads/sessions/{id}Бөліктік жүктеп салуды тоқтату/v1/uploads/sessions/{id}/chunks/{index}Бір бөлікті жүктеп салу (өңделмеген дене)/v1/uploads/sessions/{id}/completeБөліктік жүктеп салуды аяқтау/v1/accountТіркелгі, кілт және баланс/v1/account/balanceБаланс (USD)/v1/account/usageКүн мен модель бойынша пайдалану/v1/webhooksWebhook-тар тізімі/v1/webhooksWebhook жасау (құпия бір рет қайтарылады)/v1/webhooks/{id}Webhook жою/v1/webhooks/{id}/deliveriesЖеткізу журналы/v1/reseller/subtenantsКлиенттеріңіздің тізімі (қосалқы тіркелгілер)/v1/reseller/subtenantsКлиент жасау (қосалқы тіркелгі)/v1/reseller/subtenants/{id}/keysКлиентке API кілтін жасау (құпия бір рет қайтарылады)/v1/reseller/usageӘр клиенттің пайдалануы және көтерме құны/v1/chat/completionsЧат жауабы (OpenAI схемасы)/v1/images/generationsСурет жасау (OpenAI схемасы, синхронды ≤ 90 с)/v1/boards/{board_id}/approvalsТақтадағы бекіту сұраныстарының тізімі/v1/boards/{board_id}/approvals/{request_id}Бекіту сұранысын алу/v1/boards/{board_id}/approvals/{request_id}/decideНұсқаны бекіту не өзгеріс сұрау/v1/plans/readЕден жоспарын оқу/v1/panoramas/finish360° панораманы аяқтау/v1/flows/runs/{id}/cancelFlow іске қосуын тоқтату/v1/architecture/projectsArchitecture Studio жобаларының тізімі/v1/architecture/projectsЖоба жасау/v1/architecture/projects/{id}Жобаны және оның элементтерін алу/v1/architecture/projects/{id}/itemsЖобаға қосу/v1/architecture/projects/{id}/compliance«Көрнекі сурет» белгілерінің тізімі/v1/architecture/projects/{id}/compliance«Көрнекі сурет» белгісін қосу/v1/architecture/projects/{id}/compliance/{stamp}Белгіні кері алу/v1/architecture/projects/{id}/productsСуреттің өнімдер тізімдері/v1/architecture/projects/{id}/productsРендерден өнімдер тізімін жасау/v1/architecture/products/{id}Өнімдер тізімін алу не жүктеп алуБағалар
Әр іске қосуға доллармен, тарифіңізбен бірдей баланстан. Бұл әдепкі баптаулардағы нақты бағалар; әр модель беті әр бағаны ажыратымдылық пен ұзақтыққа қарай көрсетеді.
| Модель | Тапсырма | 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 |
Кілттер және шектер
Әр кілттің өз рұқсат аясы, жиілігі және шығын шегі бар. Жауап тақырыптары қанша қалғанын көрсетеді.
X-RateLimit-*key_spend_cap_reachedSDK және құралдар
Ресми TypeScript және Python SDK және CLI. SDK идемпотенттік кілттермен қауіпсіз қайталайды, нәтижелерді күтеді, үлкен файлдарды бөліктермен жүктеп салады және webhook қолтаңбаларын тексереді.
Интерактивті анықтамалық: сұраныстарды браузерде көріп, мысал кодты көшіріңіз.
