نظرة عامة

نقاط النهاية والأعراف المتبعة في واجهة الصور غير المتزامنة.

يقدّم 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). تُحتسب رسوم نماذج النصوص لكل رمز (token).