תיעוד API
משימות אסינכרוניות, webhooks חתומים, נקודות קצה תואמות OpenAI. משלמים לפי הרצה, ומשימות שנכשלו מוחזרות.
https://api.fcaai.ai/v1התחלה מהירה
- 1יצירת מפתחחשבון › מפתחות למפתחים. מפתח בדיקה שומר על הפרדה בין פיתוח לייצור; ההרצות מחויבות באותו אופן:
fcaai_test_יש לשים אותו ב-FCAAI_API_KEY; ערכות ה-SDK וה-CLI קוראות אותו משם. - 2התקנת SDK או ה-CLITypeScript ל-Node 18+, Deno, Bun וסביבות edge, 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 token בכל בקשה.
- מפתחות שמתחילים ב-
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. משימות שנכשלו או בוטלו מוחזרות.
- Long poll:
?wait=50משאיר את הבקשה פתוחה עד 60 s וחוזר ברגע שהמשימה מסתיימת. - Webhook: אירוע חתום אחד כשהמשימה מסתיימת.
- SDK:
{ wait: true }ב-TypeScript, wait=Trueב-Python.
{
"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 לפי יום ומודל. הוא מכסה את 30 הימים האחרונים, אלא אם מעבירים from ו-to בפורמט YYYY-MM-DD.
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 אחת, ואז לתאר את השינוי. אפשר להתייחס לתמונות לפי הסדר שלהן (image 1, image 2…).
- 1אפשר להעלות קבצים מקומיים, או להשתמש בכל URL ציבורי ב-https.
- 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וידאו לוקח כמה דקות: אפשר להמתין עם timeout ארוך יותר, או להשתמש ב-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 MP). - 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שלה (key, type, required, options) ואת ה-pricingשלה. - 2הרצה עם
{ "values": { key: value } }. קלטי תמונה מקבלים URL ב-https. - 3ממתינים לה כמו לכל משימה אחרת. ערך שגוי מחזיר 400
invalid_valuesעםfields.
תבניות מרובות שלבים (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העלאת הקבצים שלך
כל קלט הוא URL ב-https. כתובות URL ציבוריות עובדות כמו שהן; קבצים מקומיים יש להעלות קודם ולהשתמש ב-url שמתקבל.
- 1עד 50 MB: בקשה אחת ל-
POST /v1/uploads. - 2עד 2 GB: פותחים סשן, שולחים מקטעים של 8 MB בכל סדר (גם במקביל), ואז משלימים אותו.
- 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
במקום לבצע polling, אפשר לתת לנו לקרוא לשרת שלך כשמשימה מסתיימת. רושמים URL לכל החשבון, או מוסיפים options.webhook_url לבקשה בודדת (הסוד שלו חוזר פעם אחת כ-webhook_secret).
- 1רישום עם
POST /v1/webhooks: ה-URL שלך ב-https והאירועים הרצויים. ה-secretמוצג פעם אחת בלבד, לכן יש לשמור אותו. - 2יש לאמת כל משלוח:
X-FCAAI-Signature: t=…,v1=…הוא HMAC-SHA256 שלt + "." + rawBodyעם הסוד שלך. יש להשתמש בגוף הגולמי ולדחות חותמות זמן ישנות. - 3יש לענות 2xx מהר ולבצע את העבודה אחר כך. משלוח שנכשל נוסה 5 פעמים בסך הכול: מיד, ואז אחרי 30 s, 2 min, 10 min ו-1 h. כל ניסיון מופיע ב-
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"טיפול בשגיאות ובהגדרות שנשמטו
שגיאות חוזרות כ-JSON עם error.code קבוע שאפשר להסתעף לפיו. הגדרה שלא ניתן להחיל לא מכשילה את המשימה: היא מופיעה ב-ignored_fields.
- 1יש לבדוק את סטטוס ה-HTTP ואת
error.code. כשערך שגוי,allowedמפרט את הערכים התקינים. - 2ניסיון חוזר ל-429 ול-5xx אחרי
Retry-After, עם אותוIdempotency-Keyכדי שדבר לא יחויב פעמיים. ערכות ה-SDK עושות את שניהם עבורך. - 3יש לקרוא את
ignored_fieldsבתגובת ה-202; לכל רשומה יש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_fieldsunknown_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 עובד אחרי שינוי של שני דברים: ה-Base URL והמפתח. צ'אט ויצירת תמונות נתמכים.
- 1יש להגדיר את ה-Base URL ל-
https://api.fcaai.ai/v1ולהשתמש במפתח fcaai שלך כמפתח ה-API. - 2צ'אט:
POST /v1/chat/completionsעם המודלfca/chat. Streaming, כלים ופלט JSON עובדים כרגיל. - 3תמונות:
POST /v1/images/generationsממתין עד 90 s ומחזירdata[].url. אם המשימה צריכה יותר זמן, מתקבל 202 עםfcaai.generation_id; אפשר לעקוב אחריה עם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/flowsרשימת זרימות/v1/flows/{id}קבלת זרימה והקלטים שלה/v1/flows/{id}/runהרצת זרימה (אסינכרוני)/v1/community/templatesרשימת תבניות קהילה/v1/community/templates/{id}קבלת תבנית קהילה/v1/flows/runs/{id}קבלת הרצת זרימה/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}קבלת יצירה (long-poll עם wait)/v1/generations/{id}/cancelביטול (היתרה ששוריינה משתחררת)/v1/uploadsהעלאת קובץ קלט (≤ 50 MB)/v1/uploads/sessionsהתחלת העלאה במקטעים (עד 2 GB)/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/webhooksרשימת webhooks/v1/webhooksיצירת webhook (הסוד מוחזר פעם אחת)/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 s)/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/finishהשלמת פנורמה 360°/v1/flows/runs/{id}/cancelביטול הרצת Flow/v1/architecture/projectsרשימת פרויקטים ב-Architecture 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_reachedערכות SDK וכלים
ערכות SDK רשמיות ל-TypeScript ול-Python ו-CLI. ערכות ה-SDK מנסות שוב בבטחה עם מפתחות idempotency, ממתינות לתוצאות, מעלות קבצים גדולים במקטעים ומאמתות חתימות של webhooks.
התיעוד האינטראקטיבי: אפשר לנסות בקשות בדפדפן ולהעתיק קוד לדוגמה.
