דילוג לתוכן
v1.1 · פעילREST · JSONUSD

תיעוד API

משימות אסינכרוניות, webhooks חתומים, נקודות קצה תואמות OpenAI. משלמים לפי הרצה, ומשימות שנכשלו מוחזרות.

כתובת URL בסיסית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. משימות שנכשלו או בוטלו מוחזרות.

{
  "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 שלו כדי לדלג על כפילויות.

אירועים
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"

טיפול בשגיאות ובהגדרות שנשמטו

שגיאות חוזרות כ-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 אומר שאין כרגע מסלול פנוי.

סטטוסקודיםמה לעשות
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 עובד אחרי שינוי של שני דברים: ה-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.

GET/v1/style-kitsערכות סגנון
GET/v1/elementsאלמנטים
POST/v1/video-editsעריכת וידאו: קיצוץ, חיבור, תמונות, טקסט ולוגו, פסקול (אסינכרוני, בחינם)
GET/v1/generationsרשימת יצירות
POST/v1/generationsהפעלת יצירה (אסינכרוני)
GET/v1/generations/{id}קבלת יצירה (long-poll עם 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 וכלים

ערכות SDK רשמיות ל-TypeScript ול-Python ו-CLI. ערכות ה-SDK מנסות שוב בבטחה עם מפתחות idempotency, ממתינות לתוצאות, מעלות קבצים גדולים במקטעים ומאמתות חתימות של webhooks.

TypeScriptnpmjs.com (נפתח בכרטיסייה חדשה)Node 18+, Deno, Bun וסביבות edge
Pythonpypi.org (נפתח בכרטיסייה חדשה)Python 3.9+, ספרייה סטנדרטית בלבד
CLInpmjs.com (נפתח בכרטיסייה חדשה)כל מודל מהטרמינל שלך
MCPחיבור סוכני ה-AI שלך לאותם מודלים ולאותה יתרה.
כל נקודת קצה, שדה וקוד שגיאה

התיעוד האינטראקטיבי: אפשר לנסות בקשות בדפדפן ולהעתיק קוד לדוגמה.

תיעוד API מלא(נפתח בכרטיסייה חדשה)