סקירה כללית

נקודות הקצה והמוסכמות של ה-API האסינכרוני לתמונות.

SeedRouter מספקת מודלים של תמונה, וידאו, אודיו וטקסט דרך API אחד ומפתח API אחד. מודלים של תמונה, וידאו ואודיו רצים כמשימות אסינכרוניות: שולחים בקשה, מקבלים מזהה משימה ומתשאלים אותה כדי לקבל את התוצאה. מודלים של טקסט עונים ישירות, בפורמט הבקשות של ספק המודל.

כתובת בסיס

https://api.seedrouter.ai

השתמש ב-HTTPS ושלח גופי בקשה ב-JSON. נקודות הקצה של אודיו מקבלות במקום זאת העלאת קובץ ב-multipart/form-data.

אימות

שלח את המפתח כאסימון Bearer בכל בקשה, כולל תשאול משימות:

Authorization: Bearer YOUR_API_KEY

נקודת הקצה של Anthropic Messages מקבלת את המפתח גם ב-x-api-key, יחד עם הכותרת anthropic-version. ראה אימות.

נקודות קצה למשימות מדיה

שיטה	נתיב	מטרה
POST	`/v1/images/generations`	שולח משימת יצירה או עריכה של תמונה: GPT Image, Nano Banana ו-Midjourney.
POST	`/v1/videos/generations`	שולח משימת וידאו: Seedance 2.5 ו-2.0 (גוף בקשה של ModelArk), Veo 3.1, Kling 3.0, MiniMax H3 ו-SD Video.
POST	`/v1/audio/transcriptions`	שולח קובץ אודיו לתמלול עם Whisper-1.
POST	`/v1/audio/translations`	שולח קובץ אודיו לתרגום לאנגלית עם Whisper-1.
GET	`/v1/tasks/{id}`	קורא את המצב והתוצאה של משימת תמונה, וידאו או אודיו.

תמונות, סרטונים וקובצי אודיו לייחוס מועברים ככתובות URL בגוף הבקשה. בקשת תמונה הופכת לעריכה כשהיא כוללת תמונות קלט. הסימוכין של כל מודל מפרטים את הפרמטרים שלו.

נקודות קצה לטקסט

שיטה	נתיב	פורמט הבקשה
POST	`/v1/chat/completions`	OpenAI Chat Completions
POST	`/v1/responses`	OpenAI Responses
POST	`/v1/messages`	Anthropic Messages
POST	`/v1beta/models/{model}:generateContent`	Google Gemini
POST	`/v1beta/models/{model}:streamGenerateContent`	Google Gemini, בהזרמה
GET	`/v1/models`	מציג את רשימת המודלים הזמינים

לא כל מודל טקסט תומך בכל הפורמטים. סימוכין ה-API של המודל מציינים אילו פורמטים הוא מקבל; לדוגמה, Claude Opus 5.5 מקבל Chat Completions, Responses ו-Messages, ואילו מודלי הטקסט של Gemini משתמשים בנתיבי /v1beta.

מחזור החיים של בקשה

משימות מדיה

שלח את הבקשה. התשובה היא משימה, לא הקובץ המוכן: שמור את ה-id שלה.
תשאל את המשימה עד שהיא מגיעה למצב סופי. משימות ב-/v1/tasks/{id} מדווחות processing, ואחר כך completed או failed.
קרא את התוצאה. תמונות נמצאות ב-output.data[].url, סרטונים ב-output.video_url, והפלט של Whisper ב-output.url. כל קישורי התוצאות מצביעים לאחסון של SeedRouter.

במקרה של כשל בדוק את error.code ואת error.message. משימות שנכשלו אינן מחויבות. אין webhook שמודיע על סיום; תשאל את המשימה במקום זאת, כפי שמתואר ב-Webhooks.

בקשות טקסט

בקשת טקסט מחזירה את תשובת המודל באותה תגובה, במבנה התגובה הרשמי של הספק. הגדר את stream ל-true, או השתמש ב-:streamGenerateContent עבור Gemini, כדי לקבל אירועים שנשלחים מהשרת (SSE). מודלי טקסט מחויבים לפי טוקן.