Dokumentasi API
Tugas tak segerak, webhook bertandatangan, titik akhir serasi OpenAI. Anda membayar setiap larian, dan tugas yang gagal dibayar balik.
https://api.fcaai.ai/v1Mula pantas
- 1Cipta kunciAkaun › Kunci pembangun. Gunakan kunci ujian untuk mengasingkan pembangunan daripada produksi; larian dibilkan dengan cara yang sama:
fcaai_test_Letakkan dalamFCAAI_API_KEY; SDK dan CLI membacanya dari situ. - 2Pasang SDK atau CLITypeScript untuk Node 18+, Deno, Bun dan runtime edge, Python 3.9+, atau terminal. curl tidak memerlukan pemasangan.
npm i @fcaai/sdkpip install fcaainpm i -g @fcaai/cli - 3Jalankan janaan pertama andaPanggilan memulangkan 202 serta-merta dengan id tugas dan harganya. Dengan
{ wait: true }, SDK memulangkan hasil setelah tugas selesai.
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", … }]Pengesahan
Hantar kunci anda sebagai token bearer dengan setiap permintaan.
- Kunci yang bermula dengan
fcaai_live_adalah untuk produksi dan kunci yang bermula denganfcaai_test_adalah untuk pembangunan. Kedua-duanya dibilkan dengan cara yang sama; kunci ujian hanya mengasingkan persekitaran. - Kunci dipaparkan sekali, semasa anda menciptanya, dan kami hanya menyimpan cap jari. Simpan dalam pemboleh ubah persekitaran seperti
FCAAI_API_KEY, jangan sekali-kali dalam kod yang berjalan dalam pelayar atau aplikasi. - Kunci yang tiada, salah, dibatalkan atau tamat tempoh memulangkan 401. Kunci tanpa skop yang betul, atau digunakan daripada IP di luar senarai dibenarkannya, memulangkan 403.
curl https://api.fcaai.ai/v1/models \
-H "Authorization: Bearer $FCAAI_API_KEY"Cara hasil dikembalikan
Setiap janaan ialah satu tugas: queued → running → succeeded, failed atau canceled. Tugas yang gagal dan dibatalkan dibayar balik.
- Tinjauan panjang:
?wait=50membiarkan permintaan terbuka hingga 60 s dan memulangkan hasil sebaik sahaja tugas tamat. - Webhook: satu peristiwa bertandatangan apabila tugas tamat.
- SDK:
{ wait: true }dalam TypeScript,wait=Truedalam Python.
{
"id": "cmvusmtm300234pbo7l6ecl3f",
"object": "generation",
"model": "fca/magic-pro",
"status": "queued",
"price_usd": 0.03,
"currency": "USD",
"eta_seconds": 14,
"output": null
}Batalkan janaan
Janaan dalam giliran boleh dibatalkan dan jumlah yang ditempah dilepaskan. Setelah bermula, ia biasanya tidak boleh dibatalkan: anda mendapat 409 already_started, dan ia selesai serta dicaj seperti biasa.
- Baca
cancellablepada janaan dahulu: ia sentiasa true semasa dalam giliran dan biasanya false setelah bermula. - Membatalkan janaan yang sudah selesai memulangkannya tanpa perubahan.
# 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 usualPenggunaan dan baki
GET /v1/account/usage memulangkan janaan, kegagalan dan perbelanjaan dalam USD mengikut hari dan model. Ia meliputi 30 hari lepas melainkan anda menghantar from dan to sebagai YYYY-MM-DD.
GET /v1/account/balancememulangkan baki tersedia anda dalam 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"Panduan
Resipi langkah demi langkah untuk kerja yang paling lazim. Contoh menggunakan SDK rasmi; tab curl menunjukkan permintaan HTTP biasa.
Sunting imej dengan imej rujukan
Hantar foto untuk disunting dan imej rujukan anda dalam satu senarai images, kemudian terangkan perubahannya. Rujuk imej mengikut urutannya (imej 1, imej 2…).
- 1Muat naik fail tempatan, atau gunakan mana-mana URL https awam.
- 2Letakkan imej untuk disunting dahulu dalam
images; yang lain ialah rujukan. - 3Semak
constraints.max_input_imagesdalam butiran model: ia menyatakan bilangan imej yang diterima model.
Watak, produk dan tempat yang disimpan daripada pustaka anda boleh ditambah dengan element_ids (hingga 3); imej rujukannya dilampirkan di pihak kami.
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": …, … }Imej ke video dengan bingkai mula dan akhir
Model video menerima bingkai pertama dalam image dan, apabila disokong, bingkai terakhir dalam end_image. Klip bergerak daripada satu ke yang satu lagi.
- 1Semak model:
constraints.features.end_framemestilah true dan tempoh mesti muat dalamconstraints.duration. - 2Hantar
image,end_image, prompt dan tempoh. Gerakan kamera ialah teks prompt biasa. - 3Video mengambil masa beberapa minit: tunggu dengan had masa yang lebih panjang, atau gunakan webhook.
Model dengan features.reference juga mempunyai mod rujukan: hantar reference_images sebagai ganti bingkai dan namakan @Image1, @Image2 dalam prompt. Ia tidak boleh digabungkan dengan image atau 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}}'Besarkan imej
Pembesar menerima satu image dan skala dalam tier. fca/upscale mempunyai dua rupa: Standard untuk foto (hingga 16x) dan Sharp untuk render, pelan dan teks (hingga 4x).
- 1Dapatkan harga untuk saiz sumber anda:
?tier=4x&source_width=…&source_height=…. - 2Hantar imej dan skala.
"tier": "max"memilih skala terbesar yang muat untuk imej (output hingga 64 MP). - 3Saiz baharu ada dalam
width / heightoutput.
Pemerhalus, pencahayaan semula, peluasan, pembuangan latar belakang dan pembesaran video disenaraikan dengan 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"}}}'Jalankan templat
Templat ialah resipi sedia guna dengan beberapa input bernama. Prompt kekal di pihak kami: anda menghantar nilai dan menerima janaan biasa.
- 1Dapatkan templat untuk melihat
inputs-nya (kunci, jenis, wajib, pilihan) danpricing-nya. - 2Jalankan dengan
{ "values": { key: value } }. Input imej menerima URL https. - 3Tunggu seperti tugas lain. Nilai yang salah memulangkan 400
invalid_valuesdenganfields.
Templat berbilang langkah (package) memulakan larian templat dengan beberapa langkah: gunakan 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})Dapatkan harga dan pilihan model dahulu
Satu panggilan percuma memulangkan semua yang diterima model dan harga tepat untuk tetapan anda. Ia menggunakan logik harga yang sama seperti POST /v1/generations, jadi sebut harga itulah yang anda bayar.
- 1Panggil
GET /v1/models/{id}dengan tetapan yang akan anda hantar:duration · resolution · quality · tier · count · audio=1 · images=2 · end_image=1 · reference_images=3. - 2Baca harga dalam
estimate.price_usddan semakavailabilitysebelum anda jalankan. - 3Bina borang anda daripada
optionsdanconstraints: nisbah bidang, resolusi, tempoh, output maksimum, imej input maksimum dan ciri.
Nilai yang tidak dibenarkan model dikembalikan dalam invalid_params, bersama medan dan nilai yang dibenarkan.
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 keyMuat naik fail anda
Setiap input ialah URL https. URL awam berfungsi seadanya; muat naik fail tempatan dahulu dan gunakan url yang anda terima.
- 1Hingga 50 MB: satu permintaan ke
POST /v1/uploads. - 2Hingga 2 GB: buka sesi, hantar ketulan 8 MB dalam sebarang urutan (juga secara selari), kemudian lengkapkannya.
- 3Hantar
sha256semasa membuka sesi untuk menyambung semula muat naik yang terganggu atau melangkau fail yang sudah disimpan.
SDK dan CLI membahagikan fail, menghantar 3 ketulan pada satu masa dan menyambung semula dengan id sesi.
# ≤ 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"Dapatkan hasil melalui webhook
Daripada meninjau, biarkan kami memanggil pelayan anda apabila tugas tamat. Daftarkan URL untuk keseluruhan akaun, atau tambah options.webhook_url pada satu permintaan (rahsianya dikembalikan sekali sebagai webhook_secret).
- 1Daftar dengan
POST /v1/webhooks: URL https anda dan peristiwa yang anda mahu.secretdipaparkan sekali sahaja, jadi simpannya. - 2Sahkan setiap penghantaran:
X-FCAAI-Signature: t=…,v1=…ialah HMAC-SHA256 bagit + "." + rawBodydengan rahsia anda. Gunakan badan mentah dan tolak cap masa yang lama. - 3Jawab 2xx dengan segera dan lakukan kerja selepas itu. Penghantaran yang gagal dicuba 5 kali kesemuanya: serta-merta, kemudian selepas 30 s, 2 min, 10 min dan 1 j. Setiap percubaan ada dalam
GET /v1/webhooks/{id}/deliveries.
Satu peristiwa boleh tiba lebih daripada sekali; gunakan id-nya untuk melangkau pendua.
Hanya alamat https awam diterima, dan alamat disemak semula pada setiap penghantaran.
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"Kendalikan ralat dan tetapan yang diabaikan
Ralat dikembalikan sebagai JSON dengan error.code stabil yang boleh anda cabangkan. Tetapan yang tidak dapat diterapkan tidak menggagalkan tugas: ia disenaraikan dalam ignored_fields.
- 1Semak status HTTP dan
error.code. Apabila nilai salah,allowedmenyenaraikan yang sah. - 2Cuba semula 429 dan 5xx selepas
Retry-After, denganIdempotency-Keyyang sama supaya tiada caj berganda. SDK melakukan kedua-duanya untuk anda. - 3Baca
ignored_fieldsdalam respons 202; setiap entri mempunyaifield · reason · message.
Tugas yang gagal dibayar balik secara automatik. Jika laluan biasa sesebuah model tergendala, tugas berpindah ke laluan sandaran dengan sendirinya; 503 model_unavailable bermakna tiada laluan yang kosong sekarang.
| Status | Kod | Apa yang perlu dilakukan |
|---|---|---|
| 400 | invalid_bodyinvalid_durationinvalid_aspect_ratiomodel_not_allowed | Satu medan tiada atau tidak dibenarkan untuk model ini. Betulkan permintaan; menghantarnya semula tanpa perubahan akan gagal lagi. |
| 401 | invalid_api_keyapi_key_revokedapi_key_expired | Kunci tiada, salah, dibatalkan atau tamat tempoh. |
| 402 | insufficient_balancekey_spend_cap_reached | Baki tidak mencukupi, atau kunci telah mencapai had bulanannya. Tiada caj dikenakan. |
| 403 | insufficient_scopeip_not_allowed | Kunci tidak mempunyai skop (lihat required_scope) atau IP permintaan tiada dalam senarai dibenarkannya. |
| 404 | model_not_found | Tiada model sedemikian, atau ia tidak dibuka untuk kunci anda. |
| 429 | rate_limited | Terlalu banyak permintaan. Tunggu selama masa dalam Retry-After. |
| 503 | model_unavailable | Model sedang sibuk atau luar talian. Cuba lagi sebentar lagi atau pilih model lain. |
ignored_fieldsunknown_field- Bukan medan bagi permintaan ini; semak ejaannya.
not_supported_by_model- Medan yang sah tetapi tidak diterima model ini.
nearest_supported- Nisbah bidang itu tidak ditawarkan; yang paling hampir digunakan.
follows_input_image- Semasa menyunting, model ini mengekalkan saiz atau nisbah imej input.
unpriced_extra- Tetapan tambahan yang tidak ditakrifkan model telah dibuang.
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
}Titik akhir serasi OpenAI
Kod yang sudah menggunakan klien OpenAI berfungsi selepas menukar dua perkara: URL asas dan kunci. Sembang dan penjanaan imej disokong.
- 1Tetapkan URL asas kepada
https://api.fcaai.ai/v1dan gunakan kunci fcaai anda sebagai kunci API. - 2Sembang:
POST /v1/chat/completionsdengan modelfca/chat. Penstriman, alat dan output JSON berfungsi seperti biasa. - 3Imej:
POST /v1/images/generationsmenunggu hingga 90 s dan memulangkandata[].url. Jika tugas memerlukan masa lebih lama, anda mendapat 202 denganfcaai.generation_id; ikutinya denganGET /v1/generations/{id}.
Untuk video, audio, 3D, pembesaran dan setiap pilihan model, gunakan 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": … } }Jual semula kepada pelanggan anda sendiri
Akaun penjual semula boleh membuka subakaun bagi setiap pelanggan, memberinya kunci sendiri dan mengikuti penggunaan setiap pelanggan pada harga borong.
- 1Gunakan kunci pengurusan dengan skop
reseller:manage. Kunci pelanggan tidak sekali-kali mendapatnya. - 2Cipta pelanggan dengan
POST /v1/reseller/subtenants, kemudian kuncinya denganPOST /v1/reseller/subtenants/{id}/keys. Kunci penuh dipaparkan sekali sahaja. - 3Ikuti penggunaan dan margin setiap pelanggan dengan
GET /v1/reseller/usage. Untuk menanda pengguna akhir anda sendiri pada janaan, hantarexternal_user_id.
Kunci tanpa skop penjual semula mendapat 403 pada titik akhir ini.
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"Apa yang boleh anda bina
69 titik akhir. Setiap satu ada dalam rujukan penuh dengan contoh curl, TypeScript dan Python.
/v1/modelsSenaraikan model/v1/models/{id}Butiran model + anggaran harga/v1/voicesSuara klon anda/v1/style-kitsKit gaya/v1/elementsElemen/v1/voice-stylesGaya pertuturan/v1/voices/cloneKlon suara (persetujuan diperlukan)/v1/voices/{id}Namakan semula suara klon/v1/voices/{id}Padam suara klon (kekal)/v1/models/{id}/voicesSuara untuk model pertuturan/v1/templatesSenaraikan templat/v1/templates/{slug}Dapatkan templat dan inputnya/v1/templates/{slug}/runJalankan templat (tak segerak)/v1/templates/runs/{id}Dapatkan larian templat berbilang langkah/v1/templates/runs/{id}/planLuluskan atau tulis semula pelan pelaksanaan templat/v1/templates/runs/{id}/cancelBatalkan larian templat berbilang langkah/v1/flowsSenaraikan Flow/v1/flows/{id}Dapatkan Flow dan inputnya/v1/flows/{id}/runJalankan Flow (tak segerak)/v1/community/templatesSenaraikan templat komuniti/v1/community/templates/{id}Dapatkan templat komuniti/v1/flows/runs/{id}Dapatkan larian Flow/v1/timelinesCipta garis masa babak/v1/timelines/{id}Dapatkan garis masa/v1/timelines/{id}/{action}Pratonton, luluskan, hasilkan kualiti penuh, potong/v1/farm/jobsSenaraikan tugas ladang render/v1/farm/jobs/{id}/pauseJeda tugas ladang render/v1/farm/jobs/{id}/resumeSambung semula tugas ladang render/v1/farm/jobs/{id}Dapatkan tugas ladang render/v1/video-editsSunting video: pangkas, cantum, imej, teks & logo, runut bunyi (tak segerak, percuma)/v1/generationsSenaraikan janaan/v1/generationsCipta janaan (tak segerak)/v1/generations/{id}Dapatkan janaan (tinjauan panjang dengan wait)/v1/generations/{id}/cancelBatal (baki yang ditempah dilepaskan)/v1/uploadsMuat naik fail input (≤ 50 MB)/v1/uploads/sessionsMulakan muat naik berketul (hingga 2 GB)/v1/uploads/sessions/{id}Status sesi (ketulan diterima, julat yang tiada)/v1/uploads/sessions/{id}Batalkan muat naik berketul/v1/uploads/sessions/{id}/chunks/{index}Muat naik satu ketulan (badan mentah)/v1/uploads/sessions/{id}/completeSelesaikan muat naik berketul/v1/accountAkaun, kunci dan baki/v1/account/balanceBaki (USD)/v1/account/usagePenggunaan mengikut hari dan model/v1/webhooksSenaraikan webhook/v1/webhooksCipta webhook (rahsia dikembalikan sekali)/v1/webhooks/{id}Padam webhook/v1/webhooks/{id}/deliveriesLog penghantaran/v1/reseller/subtenantsSenaraikan pelanggan anda (subpenyewa)/v1/reseller/subtenantsCipta pelanggan (subpenyewa)/v1/reseller/subtenants/{id}/keysCipta kunci API untuk pelanggan (rahsia dikembalikan sekali)/v1/reseller/usagePenggunaan dan kos borong bagi setiap pelanggan/v1/chat/completionsPelengkapan sembang (skema OpenAI)/v1/images/generationsPenjanaan imej (skema OpenAI, segerak ≤ 90 s)/v1/boards/{board_id}/approvalsSenaraikan permintaan kelulusan pada papan/v1/boards/{board_id}/approvals/{request_id}Dapatkan permintaan kelulusan/v1/boards/{board_id}/approvals/{request_id}/decideLuluskan satu pilihan atau minta perubahan/v1/plans/readBaca pelan lantai/v1/panoramas/finishSiapkan panorama 360°/v1/flows/runs/{id}/cancelBatalkan larian Flow/v1/architecture/projectsSenaraikan projek Architecture Studio/v1/architecture/projectsCipta projek/v1/architecture/projects/{id}Dapatkan projek dan itemnya/v1/architecture/projects/{id}/itemsTambah ke projek/v1/architecture/projects/{id}/complianceSenaraikan label "Imej perwakilan"/v1/architecture/projects/{id}/complianceTambah label "Imej perwakilan"/v1/architecture/projects/{id}/compliance/{stamp}Tarik balik label/v1/architecture/projects/{id}/productsSenarai produk bagi satu imej/v1/architecture/projects/{id}/productsHasilkan senarai produk daripada render/v1/architecture/products/{id}Dapatkan atau muat turun senarai produkHarga
Dolar setiap larian, daripada baki yang sama dengan pelan anda. Ini harga langsung pada tetapan lalai; setiap halaman model menyenaraikan setiap harga mengikut resolusi dan tempoh.
| Model | Tugas | API (USD) |
|---|---|---|
| Nano Banana Pro | Imej · imej · 2K | $0.13 |
| GPT Image 2.5 Flare | Imej · imej · 2K | $0.055 |
| FCA Magic Pro | Imej · imej · 2K | $0.03 |
| Kling 3.0 Pro | Video · setiap saat · 1080p | $0.11 |
| FCA Magic V3 | Video · setiap saat · 1080p | $0.017 |
| ElevenLabs v3 | Audio · klip | $0.024 |
Kunci dan had
Setiap kunci datang dengan skop, kadar dan had belanjanya sendiri. Pengepala respons menunjukkan baki yang tinggal.
X-RateLimit-*key_spend_cap_reachedSDK dan alat
SDK TypeScript dan Python rasmi serta CLI. SDK mencuba semula dengan selamat menggunakan kunci idempotensi, menunggu hasil, memuat naik fail besar secara berketul dan mengesahkan tandatangan webhook.
Rujukan interaktif: cuba permintaan dalam pelayar anda dan salin contoh kod.
