Dokumentasyon ng API
Async na job, signed webhook, endpoint na compatible sa OpenAI. Bawat run ang bayad, at ibinabalik ang bayad sa mga pumalyang job.
https://api.fcaai.ai/v1Mabilisang simula
- 1Gumawa ng keyAccount › Mga developer key. Gumamit ng test key para mahiwalay ang development sa production; pareho ang singil sa mga run:
fcaai_test_Ilagay ito saFCAAI_API_KEY; doon ito binabasa ng mga SDK at ng CLI. - 2Mag-install ng SDK o ng CLITypeScript para sa Node 18+, Deno, Bun at edge runtime, Python 3.9+, o ang terminal. Hindi kailangang mag-install para sa curl.
npm i @fcaai/sdkpip install fcaainpm i -g @fcaai/cli - 3Patakbuhin ang una mong generationAgad nagbabalik ang call ng 202 kasama ang job id at presyo nito. Kapag may
{ wait: true }, babalik ang SDK kapag tapos na ang job.
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", … }]Authentication
Ipadala ang key mo bilang bearer token sa bawat request.
- Para sa production ang mga key na nagsisimula sa
fcaai_live_at para sa development ang mga key na nagsisimula safcaai_test_. Pareho ang singil sa dalawa; pinaghihiwalay lang ng test key ang mga environment. - Minsan lang ipinapakita ang key, pagkagawa mo nito, at fingerprint lang ang itinatago namin. I-store ito sa environment variable gaya ng
FCAAI_API_KEY, hindi kailanman sa code na tumatakbo sa browser o app. - 401 ang ibinabalik ng key na wala, mali, binawi o nag-expire na. 403 ang ibinabalik ng key na walang tamang scope, o ginamit mula sa IP na wala sa allow list nito.
curl https://api.fcaai.ai/v1/models \
-H "Authorization: Bearer $FCAAI_API_KEY"Paano bumabalik ang mga resulta
Job ang bawat generation: queued → running → succeeded, failed o canceled. Ibinabalik ang bayad sa mga pumalya at kinanselang job.
- Long poll: pinapanatiling bukas ng
?wait=50ang request nang hanggang 60 s at babalik agad pagkatapos ng job. - Webhook: isang signed na event kapag natapos ang job.
- SDK:
{ wait: true }sa TypeScript,wait=Truesa Python.
{
"id": "cmvusmtm300234pbo7l6ecl3f",
"object": "generation",
"model": "fca/magic-pro",
"status": "queued",
"price_usd": 0.03,
"currency": "USD",
"eta_seconds": 14,
"output": null
}Kanselahin ang generation
Puwedeng kanselahin ang generation na nasa pila at ibinabalik ang naka-reserve na halaga. Kapag nagsimula na ito, kadalasang hindi na puwede: makakakuha ka ng 409 already_started, at tatapusin ito at sisingilin gaya ng dati.
- Basahin muna ang
cancellablesa generation: palaging true ito habang nasa pila at kadalasang false kapag nagsimula na. - Kapag kinansela ang generation na tapos na, ibabalik ito nang walang pagbabago.
# 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 usualPaggamit at balanse
Ibinabalik ng GET /v1/account/usage ang mga generation, pagpalya at gastos sa USD kada araw at model. Saklaw nito ang huling 30 araw maliban kung magpasa ka ng from at to bilang YYYY-MM-DD.
- Ibinabalik ng
GET /v1/account/balanceang available mong balanse sa 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"Mga Gabay
Hakbang-hakbang na recipe para sa mga pinakakaraniwang job. Gumagamit ng opisyal na SDK ang mga halimbawa; ipinapakita ng curl tab ang plain HTTP request.
Mag-edit ng larawan gamit ang reference image
Ipadala ang litratong ie-edit at ang mga reference image mo sa iisang images list, saka ilarawan ang pagbabago. Tukuyin ang mga larawan ayon sa pagkakasunod nila (image 1, image 2…).
- 1Mag-upload ng lokal na file, o gumamit ng kahit anong pampublikong https URL.
- 2Unahin sa
imagesang larawang ie-edit; reference ang iba. - 3Tingnan ang
constraints.max_input_imagessa detalye ng model: sinasabi nito kung ilang larawan ang kaya ng model.
Puwedeng idagdag gamit ang element_ids (hanggang 3) ang mga naka-save na character, produkto at lugar mula sa library mo; kami na ang mag-a-attach ng mga reference image nila.
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": …, … }Larawan papuntang video na may simula at dulong frame
Kinukuha ng mga video model ang unang frame sa image at, kung suportado, ang huling frame sa end_image. Gagalaw ang clip mula sa isa papunta sa isa pa.
- 1Tingnan ang model: dapat true ang
constraints.features.end_frameat dapat pasok saconstraints.durationang haba. - 2Ipadala ang
image,end_image, ang prompt at ang haba. Plain na prompt text lang ang mga galaw ng camera. - 3Ilang minuto ang video: maghintay nang may mas mahabang timeout, o gumamit ng webhook.
May reference mode din ang mga model na may features.reference: ipadala ang reference_images sa halip na mga frame at tawagin silang @Image1, @Image2 sa prompt. Hindi ito puwedeng isabay sa image o 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}}'Mag-upscale ng larawan
Kumukuha ang mga upscaler ng isang image at scale sa tier. May dalawang hitsura ang fca/upscale: Standard para sa litrato (hanggang 16x) at Sharp para sa render, plan at text (hanggang 4x).
- 1Kunin ang presyo para sa laki ng source mo:
?tier=4x&source_width=…&source_height=…. - 2Ipadala ang larawan at ang scale. Pinipili ng
"tier": "max"ang pinakamalaking scale na kasya sa larawan (output hanggang 64 MP). - 3Nasa
width / heightng output ang bagong laki.
Nakalista sa GET /v1/models?type=upscale ang mga enhancer, relighting, pag-expand, pag-alis ng background at video upscaling.
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"}}}'Magpatakbo ng template
Ang mga template ay handang recipe na may ilang pinangalanang input. Nasa amin ang prompt: value ang ipapadala mo at karaniwang generation ang babalik.
- 1Kunin ang template para makita ang
inputsnito (key, type, required, options) at angpricingnito. - 2Patakbuhin ito gamit ang
{ "values": { key: value } }. Https URL ang tinatanggap ng mga image input. - 3Hintayin ito tulad ng ibang job. Ang maling value ay nagbabalik ng 400
invalid_valueskasama angfields.
Ang mga multi-step na template (package) ay nagsisimula ng template run na may ilang hakbang: gamitin ang 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})Kunin muna ang presyo at mga opsyon ng model
Isang libreng call ang nagbabalik ng lahat ng tinatanggap ng model at ng eksaktong presyo para sa settings mo. Pareho ang price logic nito sa POST /v1/generations, kaya ang quote ang babayaran mo.
- 1Tawagin ang
GET /v1/models/{id}gamit ang settings na ipapadala mo:duration · resolution · quality · tier · count · audio=1 · images=2 · end_image=1 · reference_images=3. - 2Basahin ang presyo sa
estimate.price_usdat tingnan angavailabilitybago ka magpatakbo. - 3Buuin ang form mo mula sa
optionsatconstraints: aspect ratio, resolution, haba, max na output, max na input image at mga feature.
Ang value na hindi pinapayagan ng model ay bumabalik sa invalid_params, kasama ang field at ang mga pinapayagang value.
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 keyI-upload ang mga file mo
Https URL ang bawat input. Gumagana ang mga pampublikong URL kung ano sila; i-upload muna ang mga lokal na file at gamitin ang url na babalik.
- 1Hanggang 50 MB: isang request sa
POST /v1/uploads. - 2Hanggang 2 GB: magbukas ng session, magpadala ng 8 MB na chunk sa kahit anong pagkakasunod (puwede ring sabay-sabay), saka tapusin ito.
- 3Ipadala ang
sha256pagbukas ng session para ituloy ang naputol na upload o laktawan ang file na naka-store na.
Hinahati ng mga SDK at ng CLI ang file, nagpapadala ng 3 chunk nang sabay at nagtutuloy gamit ang session id.
# ≤ 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"Kunin ang resulta sa webhook
Sa halip na mag-poll, hayaan kaming tumawag sa server mo kapag natapos ang job. Magrehistro ng URL para sa buong account, o idagdag ang options.webhook_url sa isang request (minsan lang babalik ang secret nito bilang webhook_secret).
- 1Magrehistro gamit ang
POST /v1/webhooks: ang https URL mo at ang mga event na gusto mo. Minsan lang ipinapakita angsecret, kaya i-store ito. - 2I-verify ang bawat delivery: ang
X-FCAAI-Signature: t=…,v1=…ay HMAC-SHA256 ngt + "." + rawBodygamit ang secret mo. Gamitin ang raw body at tanggihan ang mga lumang timestamp. - 3Sumagot agad ng 2xx at gawin ang trabaho pagkatapos. Ang pumalyang delivery ay sinusubukan nang 5 beses lahat-lahat: agad, saka pagkalipas ng 30 s, 2 min, 10 min at 1 h. Nasa
GET /v1/webhooks/{id}/deliveriesang bawat subok.
Puwedeng dumating nang higit sa isang beses ang isang event; gamitin ang id nito para laktawan ang mga duplicate.
Pampublikong https address lang ang tinatanggap, at sinusuri ulit ang address sa bawat delivery.
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"Pag-handle ng error at mga binalewalang setting
Bumabalik ang mga error bilang JSON na may matatag na error.code na puwede mong pagbatayan. Hindi pinapapalya ng setting na hindi mailalapat ang job: nakalista ito sa ignored_fields.
- 1Tingnan ang HTTP status at
error.code. Kapag mali ang value, nakalista saallowedang mga valid. - 2I-retry ang 429 at 5xx pagkatapos ng
Retry-After, gamit ang parehongIdempotency-Keypara walang masingil nang dalawang beses. Ginagawa ng mga SDK ang dalawang ito para sa iyo. - 3Basahin ang
ignored_fieldssa 202 response; mayfield · reason · messageang bawat entry.
Awtomatikong ibinabalik ang bayad sa mga pumalyang job. Kung down ang karaniwang ruta ng isang model, kusang lilipat ang job sa backup na ruta; ang ibig sabihin ng 503 model_unavailable ay walang bakanteng ruta ngayon.
| Status | Mga Code | Ano ang gagawin |
|---|---|---|
| 400 | invalid_bodyinvalid_durationinvalid_aspect_ratiomodel_not_allowed | May kulang na field o hindi ito pinapayagan sa model na ito. Ayusin ang request; papalya ulit kapag ipinadala nang walang binago. |
| 401 | invalid_api_keyapi_key_revokedapi_key_expired | Wala, mali, binawi o nag-expire na ang key. |
| 402 | insufficient_balancekey_spend_cap_reached | Kulang ang balanse, o naabot ng key ang buwanang cap nito. Walang siningil. |
| 403 | insufficient_scopeip_not_allowed | Kulang ang scope ng key (tingnan ang required_scope) o wala sa allow list nito ang IP ng request. |
| 404 | model_not_found | Walang ganitong model, o hindi ito bukas sa key mo. |
| 429 | rate_limited | Masyadong maraming request. Maghintay ayon sa oras sa Retry-After. |
| 503 | model_unavailable | Abala o offline ang model. Subukan ulit maya-maya o pumili ng ibang model. |
ignored_fieldsunknown_field- Hindi field ng request na ito; tingnan ang spelling.
not_supported_by_model- Valid na field na hindi tinatanggap ng model na ito.
nearest_supported- Hindi inaalok ang aspect ratio na ito; ang pinakamalapit ang gagamitin.
follows_input_image- Kapag nag-e-edit, pinapanatili ng model na ito ang laki o ratio ng input image.
unpriced_extra- Inalis ang dagdag na setting na hindi tinutukoy ng model.
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
}Mga endpoint na compatible sa OpenAI
Gagana ang code na gumagamit na ng OpenAI client pagkatapos magpalit ng dalawang bagay: ang base URL at ang key. Suportado ang chat at paggawa ng larawan.
- 1Itakda ang base URL sa
https://api.fcaai.ai/v1at gamitin ang fcaai key mo bilang API key. - 2Chat:
POST /v1/chat/completionsgamit ang model nafca/chat. Gumagana gaya ng dati ang streaming, tools at JSON output. - 3Mga larawan: naghihintay ang
POST /v1/images/generationsnang hanggang 90 s at nagbabalik ngdata[].url. Kung mas matagal ang job, makakatanggap ka ng 202 na mayfcaai.generation_id; sundan ito gamit angGET /v1/generations/{id}.
Para sa video, audio, 3D, upscaling at lahat ng opsyon ng model, gamitin ang 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": … } }Ibenta muli sa sarili mong mga customer
Puwedeng magbukas ang mga reseller account ng sub-account para sa bawat customer, bigyan ito ng sariling key at subaybayan ang paggamit kada customer sa wholesale na presyo.
- 1Gumamit ng management key na may
reseller:managescope. Hindi ito kailanman nakukuha ng mga customer key. - 2Gawin ang customer gamit ang
POST /v1/reseller/subtenants, saka ang key nito gamit angPOST /v1/reseller/subtenants/{id}/keys. Minsan lang ipinapakita ang buong key. - 3Subaybayan ang paggamit at margin kada customer gamit ang
GET /v1/reseller/usage. Para i-tag ang sarili mong mga end user sa mga generation, ipadala angexternal_user_id.
403 ang makukuha sa mga endpoint na ito ng mga key na walang reseller scope.
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"Ano ang puwede mong buuin
69 endpoint. Nasa buong reference ang bawat isa, may halimbawa sa curl, TypeScript at Python.
/v1/modelsIlista ang mga model/v1/models/{id}Detalye ng model + tantiya ng presyo/v1/voicesAng mga na-clone mong boses/v1/style-kitsMga style kit/v1/elementsMga Element/v1/voice-stylesMga istilo ng pagsasalita/v1/voices/cloneMag-clone ng boses (kailangan ng pahintulot)/v1/voices/{id}Palitan ang pangalan ng na-clone na boses/v1/voices/{id}Burahin ang na-clone na boses (permanente)/v1/models/{id}/voicesMga boses para sa speech model/v1/templatesIlista ang mga template/v1/templates/{slug}Kunin ang template at ang mga input nito/v1/templates/{slug}/runPatakbuhin ang template (async)/v1/templates/runs/{id}Kunin ang multi-step na template run/v1/templates/runs/{id}/planAprubahan o isulat muli ang plano para sa pagpapatakbo ng template/v1/templates/runs/{id}/cancelKanselahin ang multi-step na run ng template/v1/flowsIlista ang mga Flow/v1/flows/{id}Kunin ang Flow at ang mga input nito/v1/flows/{id}/runPatakbuhin ang Flow (async)/v1/community/templatesIlista ang mga community template/v1/community/templates/{id}Kunin ang community template/v1/flows/runs/{id}Kunin ang Flow run/v1/timelinesGumawa ng scene timeline/v1/timelines/{id}Kunin ang timeline/v1/timelines/{id}/{action}I-preview, aprubahan, gawing full quality, i-cut/v1/farm/jobsIlista ang mga render farm job/v1/farm/jobs/{id}/pauseI-pause ang render farm job/v1/farm/jobs/{id}/resumeItuloy ang render farm job/v1/farm/jobs/{id}Kunin ang render farm job/v1/video-editsMag-edit ng video: trim, pagdugtong, larawan, text at logo, sound track (async, libre)/v1/generationsIlista ang mga generation/v1/generationsGumawa ng generation (async)/v1/generations/{id}Kunin ang generation (long-poll gamit ang wait)/v1/generations/{id}/cancelKanselahin (ibinabalik ang naka-reserve na balanse)/v1/uploadsMag-upload ng input file (≤ 50 MB)/v1/uploads/sessionsMagsimula ng chunked upload (hanggang 2 GB)/v1/uploads/sessions/{id}Status ng session (natanggap na chunk, kulang na range)/v1/uploads/sessions/{id}Kanselahin ang chunked upload/v1/uploads/sessions/{id}/chunks/{index}Mag-upload ng isang chunk (raw body)/v1/uploads/sessions/{id}/completeTapusin ang chunked upload/v1/accountAccount, key at balanse/v1/account/balanceBalanse (USD)/v1/account/usagePaggamit kada araw at model/v1/webhooksIlista ang mga webhook/v1/webhooksGumawa ng webhook (isang beses lang ibinabalik ang secret)/v1/webhooks/{id}Burahin ang webhook/v1/webhooks/{id}/deliveriesLog ng delivery/v1/reseller/subtenantsIlista ang mga customer mo (sub-tenant)/v1/reseller/subtenantsGumawa ng customer (sub-tenant)/v1/reseller/subtenants/{id}/keysGumawa ng API key para sa customer (isang beses lang ibinabalik ang secret)/v1/reseller/usagePaggamit at wholesale na gastos kada customer/v1/chat/completionsChat completion (OpenAI schema)/v1/images/generationsPaggawa ng larawan (OpenAI schema, sync ≤ 90 s)/v1/boards/{board_id}/approvalsIlista ang mga approval request sa board/v1/boards/{board_id}/approvals/{request_id}Kunin ang approval request/v1/boards/{board_id}/approvals/{request_id}/decideAprubahan ang isang opsyon o humingi ng pagbabago/v1/plans/readBasahin ang floor plan/v1/panoramas/finishTapusin ang 360° panorama/v1/flows/runs/{id}/cancelKanselahin ang run ng Flow/v1/architecture/projectsIlista ang mga project sa Architecture Studio/v1/architecture/projectsGumawa ng project/v1/architecture/projects/{id}Kunin ang project at ang mga item nito/v1/architecture/projects/{id}/itemsIdagdag sa project/v1/architecture/projects/{id}/complianceIlista ang mga label na "Representative image"/v1/architecture/projects/{id}/complianceMagdagdag ng label na "Representative image"/v1/architecture/projects/{id}/compliance/{stamp}Bawiin ang label/v1/architecture/projects/{id}/productsMga product list ng larawan/v1/architecture/projects/{id}/productsGumawa ng product list mula sa render/v1/architecture/products/{id}Kunin o i-download ang product listPresyo
Dolyar bawat run, mula sa parehong balanse ng plan mo. Live na presyo ito sa default na settings; nakalista sa page ng bawat model ang lahat ng presyo ayon sa resolution at haba.
| Model | Job | API (USD) |
|---|---|---|
| Nano Banana Pro | Larawan · larawan · 2K | $0.13 |
| GPT Image 2.5 Flare | Larawan · larawan · 2K | $0.055 |
| FCA Magic Pro | Larawan · larawan · 2K | $0.03 |
| Kling 3.0 Pro | Video · kada segundo · 1080p | $0.11 |
| FCA Magic V3 | Video · kada segundo · 1080p | $0.017 |
| ElevenLabs v3 | Audio · clip | $0.024 |
Mga key at limit
May sariling scope, rate at spend cap ang bawat key. Ipinapakita ng response headers kung ilan pa ang natitira.
X-RateLimit-*key_spend_cap_reachedMga SDK at tool
Opisyal na TypeScript at Python SDK at isang CLI. Ligtas na nagre-retry ang mga SDK gamit ang idempotency key, naghihintay ng resulta, nag-a-upload ng malalaking file nang pa-chunk at nag-ve-verify ng webhook signature.
Ang interactive na reference: subukan ang mga request sa browser mo at kopyahin ang halimbawang code.
