الانتقال إلى المحتوى الرئيسي
يتحدث OrcaRouter مع نماذج فيديو Seedance على نفس نقطة نهاية الإرسال والاستطلاع كما هو الحال مع Kling. ترسل model: byteplus/dreamina-seedance-2-0-260128، ويوجّه OrcaRouter الطلب إلى واجهة Ark الأصلية /contents/generations/tasks، ثم تستطلع نفس معرّف المهمة عبر OrcaRouter بمجرد اكتمالها (عادةً من 30 ثانية إلى 4 دقائق حسب المدة / الدقة / generate_audio).
النموذج المتاح حاليًا. يتم توفير Seedance 2.0 فقط في الوقت الحالي، تحت الاسم الخلفي byteplus/dreamina-seedance-2-0-260128. يسرد جدول القدرات أدناه بقية عائلة Seedance للمرجع، لكنها ليست قابلة للاختيار بعد في الحقل التجريبي أو قابلة للتوجيه عبر OrcaRouter — استخدم byteplus/dreamina-seedance-2-0-260128 لكل طلب حاليًا.
نقطة نهاية الإرسال POST /v1/video/generations ونقطة نهاية الجلب GET /v1/video/generations/{task_id} مشتركة مع Kling. ما يتغيّر هو جسم الطلب: يستخدم Kling prompt + image + metadata.{mode, aspect_ratio, image_list, ...}، ويستخدم Seedance prompt + metadata.{content[], ratio, duration, generate_audio, watermark, ...}. تحدد بادئة model أي مخطط يتم احترامه.

النماذج

النموذجT2VI2V (الأول)I2V (الأول+الأخير)المرجع متعدد الوسائط¹تحرير الفيديو²إنشاء الصوت³المدةمتاح
byteplus/dreamina-seedance-2-0-260128 (2.0)✓ كامل4 – 15 ث
byteplus/seedance-2.0-fast✓ كامل4 – 15 ثمخطط له
byteplus/seedance-1-5-proالصورة فقط4 – 12 ثمخطط له
byteplus/seedance-1-0-proالصورة فقط2 – 12 ثمخطط له
byteplus/seedance-1-0-pro-fastالصورة فقط2 – 12 ثمخطط له
byteplus/seedance-1-0-lite-i2vالصورة فقط2 – 12 ثمخطط له
byteplus/seedance-1-0-lite-t2vالصورة فقط2 – 12 ثمخطط له
¹ المرجع متعدد الوسائط = يمكن أن تحمل مصفوفة metadata.content[] عناصر image_url / video_url / audio_url مع علامات role (reference_image / reference_video / reference_audio). يعني “كامل” أنه يتم قبول مجموعات من الصورة + الفيديو + الصوت. ² تحرير الفيديو = مرّر عنصر video_url لتطبيق تعديلات مدفوعة بالموجّه على الفيديو المصدر (تبديل الموضوع، الطلاء الداخلي للمناطق، إلخ). ³ الصوت الأصلي = يُنشئ المنبع تلقائيًا مقطعًا صوتيًا متطابقًا مع الفيديو. يتم التبديل عبر metadata.generate_audio: true. نقطة نهاية الإرسال هي نفسها لكل نموذج — POST /v1/video/generations. ما يتغيّر هو حقول metadata التي يحترمها المنبع وفقًا للجدول أعلاه. راجع مصفوفة قدرات Seedance الخاصة بالمنبع للحصول على قائمة الميزات المعتمدة لكل نموذج.

إرسال مهمة

أرسل طلب POST إلى /v1/video/generations يحتوي على model و prompt وأي معلمات خاصة بالمنبع ضمن metadata:
curl https://api.orcarouter.ai/v1/video/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/dreamina-seedance-2-0-260128",
    "prompt": "A girl holding a fox, the girl opens her eyes, looks gently at the camera, the fox hugs affectionately, the camera slowly pulls out, the girl'\''s hair is blown by the wind",
    "metadata": {
      "content": [
        { "type": "image_url", "image_url": { "url": "https://example.com/foxgirl.png" } }
      ],
      "ratio": "16:9",
      "duration": 5,
      "generate_audio": true,
      "watermark": false
    }
  }'
تحمل الاستجابة معرّف المهمة (نفس الغلاف كما في Kling — يوحّد OrcaRouter بين المزوّدين):
{
  "id": "task_9q9oz6tjtgABYWC1QIqoz3sscgVz7ycw",
  "task_id": "task_9q9oz6tjtgABYWC1QIqoz3sscgVz7ycw",
  "object": "video",
  "model": "byteplus/dreamina-seedance-2-0-260128",
  "status": "queued",
  "progress": 0,
  "created_at": 1777975188
}
يلفّ OrcaRouter prompt الخاص بك كعنصر نص داخل مصفوفة content[] الخاصة بـ Seedance تلقائيًا — لست بحاجة إلى تمرير عنصر {type: "text"} بنفسك. يتم استبدال أي عنصر نص تورّده في metadata.content[] بـ prompt ذي المستوى الأعلى. تمرّ عناصر المحتوى الأخرى (image_url، video_url، audio_url) دون تغيير.

حقول الجسم

تذهب هذه الحقول داخل metadata. رتّبها وفقًا لجداول المتغيرات أدناه.
الحقلالنوعملاحظات
contentمصفوفةعناصر المرجع متعدد الوسائط. كل عنصر: {type, image_url? | video_url? | audio_url?, role?}. تجاوز إذا كان النص إلى فيديو خالصًا.
ratioسلسلة نصيةنسبة العرض إلى الارتفاع. 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / adaptive. يستنتج adaptive من المدخلات.
durationعدد صحيحالثواني. يعتمد النطاق المسموح به على النموذج — راجع الجدول أعلاه.
resolutionسلسلة نصية480p / 720p / 1080p. الافتراضي 720p. 1080p متاحة فقط على seedance-2.0 / seedance-2.0-fast / seedance-1-5-pro / seedance-1-0-pro / seedance-1-0-pro-fast.
generate_audioمنطقيإنشاء مقطع صوتي متزامن تلقائيًا. الافتراضي false. فقط على seedance-2.0 / 2.0-fast / 1-5-pro.
watermarkمنطقيإضافة العلامة المائية الخاصة بالمنبع. الافتراضي محدد من المنبع.
seedعدد صحيحبذرة عشوائية لإعادة الإنتاج.
service_tierسلسلة نصيةdefault (متصل) أو flex (غير متصل / أولوية أقل، حصة أعلى). يكون الافتراضي default.
return_last_frameمنطقيإرجاع الإطار النهائي كصورة إلى جانب MP4. الافتراضي false.
callback_urlسلسلة نصيةعنوان webhook — يستقبل تغييرات الحالة بدلًا من الاستطلاع (أو بجانبه).

شكل عنصر content[]

كل عنصر في metadata.content يأخذ أحد الأشكال الأربعة:
{ "type": "image_url", "image_url": { "url": "https://..." }, "role": "first_frame" }
{ "type": "video_url", "video_url": { "url": "https://..." }, "role": "reference_video" }
{ "type": "audio_url", "audio_url": { "url": "https://..." }, "role": "reference_audio" }
{ "type": "text",      "text": "..." }    // automatically replaced by top-level prompt
قيم role:
roleالغرض
first_frameتثبيت هذه الصورة كأول إطار للفيديو المُنشأ.
end_frameتثبيت هذه الصورة كآخر إطار (تُستخدم مع first_frame لـ i2v الإطار الأول والأخير).
reference_imageمرجع الأسلوب / الموضوع (متغيّر المرجع متعدد الوسائط؛ يمكن تمرير عدة عناصر).
reference_videoمرجع الأسلوب / الحركة، أو الفيديو المصدر للتحرير / التمديد.
reference_audioموسيقى خلفية أو مرجع صوتي (إنشاء فيديو صوتي).
أشِر إلى العناصر داخل الموجّه باستخدام صيغة [Image 1] و [Video 1] و [Audio 1]. يطابق الفهرس ترتيب المصفوفة (يبدأ من 1، محدد لكل نوع).

استطلاع النتائج

استخدم معرّف المهمة الذي تم إرجاعه عند الإرسال:
curl https://api.orcarouter.ai/v1/video/generations/task_9q9oz6tjtgABYWC1QIqoz3sscgVz7ycw \
  -H "Authorization: Bearer sk-orca-..."
شكل الاستجابة ملفوف (مطابق لـ Kling):
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_9q9oz6tjtgABYWC1QIqoz3sscgVz7ycw",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://ark-content-generation-ap-southeast-1.tos-ap-southeast-1.volces.com/.../video.mp4",
    "submit_time": 1777975188,
    "start_time": 1777975241,
    "finish_time": 1777975277,
    "fail_reason": ""
  }
}
تتم تسوية قيم الحالة إلى الأحرف الكبيرة عبر المزوّدين:
الحالةحالة Seedance المنبعيةالمعنى
NOT_START(عابرة)تم إنشاء سجل المهمة، ولم يتم إرسالها بعد
SUBMITTEDqueuedتم إرسالها إلى المنبع، تنتظر في الطابور
IN_PROGRESSrunningالمنبع قيد العرض
SUCCESSsucceededاكتملت. يحمل data.result_url ملف MP4
FAILUREfailedفشلت. يحتوي data.fail_reason على السبب
التقدّم هو سلسلة نصية بنسبة مئوية ("50%", "100%")، وليس عددًا صحيحًا. استطلع كل 5 - 10 ثوانٍ. عادةً ما يكتمل مقطع 720p مدته 5 ثوانٍ في 30 - 60 ثانية؛ يمكن أن تستغرق مقاطع 1080p مع الصوت أو 15 ثانية / المرجع متعدد الوسائط 3 - 5 دقائق. result_url هو عنوان URL موقّع من TOS بمدة صلاحية قصيرة — قم بتنزيله أو إعادة استضافته بسرعة إذا كنت بحاجة إلى الاحتفاظ به لفترة طويلة.

متغيرات نقطة النهاية

تشترك جميع المتغيرات في POST /v1/video/generations. يتم تحديد مسار ميزة Seedance التي يخدمها المنبع بواسطة عناصر metadata.content[] و علامات role — وليس بواسطة عنوان URL.

النص إلى فيديو

فقط model + prompt + بيانات وصفية اختيارية. عدم وجود عناصر محتوى يعني تحويل النص إلى فيديو بشكل خالص:
curl https://api.orcarouter.ai/v1/video/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/dreamina-seedance-2-0-260128",
    "prompt": "Photorealistic style: under a clear blue sky, a vast expanse of white daisy fields stretches out. The camera gradually zooms in on a single daisy with glistening dewdrops on its petals.",
    "metadata": {
      "ratio": "16:9",
      "duration": 5,
      "watermark": true
    }
  }'

الصورة إلى فيديو — الإطار الأول

مرّر عنصر صورة واحد مع role: "first_frame":
curl https://api.orcarouter.ai/v1/video/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/dreamina-seedance-2-0-260128",
    "prompt": "the cat starts dancing energetically",
    "metadata": {
      "content": [
        { "type": "image_url", "image_url": { "url": "https://example.com/cat.png" }, "role": "first_frame" }
      ],
      "ratio": "adaptive",
      "duration": 5,
      "generate_audio": true
    }
  }'

الصورة إلى فيديو — الإطار الأول والأخير

عنصران صورة، واحد لكل من first_frame و end_frame:
curl https://api.orcarouter.ai/v1/video/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/dreamina-seedance-2-0-260128",
    "prompt": "Create a 360-degree orbiting camera shot from start to end frame.",
    "metadata": {
      "content": [
        { "type": "image_url", "image_url": { "url": "https://example.com/start.jpg" }, "role": "first_frame" },
        { "type": "image_url", "image_url": { "url": "https://example.com/end.jpg" },   "role": "end_frame"   }
      ],
      "ratio": "16:9",
      "duration": 6
    }
  }'

المرجع متعدد الوسائط — صورة + فيديو + صوت

ادمج عناصر reference_image / reference_video / reference_audio. أشِر إليها في الموجّه باستخدام فهارس [Image N] / [Video N] / [Audio N] (تبدأ من 1، لكل نوع):
curl https://api.orcarouter.ai/v1/video/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/dreamina-seedance-2-0-260128",
    "prompt": "Use the first-person POV framing from [Video 1] throughout, and use [Audio 1] as the background music. First-person POV fruit tea promotional ad: [Image 1] hands pick a dew-covered apple; [Image 2] holds the finished drink up to the camera.",
    "metadata": {
      "content": [
        { "type": "image_url", "image_url": { "url": "https://example.com/tea_pic1.jpg" }, "role": "reference_image" },
        { "type": "image_url", "image_url": { "url": "https://example.com/tea_pic2.jpg" }, "role": "reference_image" },
        { "type": "video_url", "video_url": { "url": "https://example.com/tea_video1.mp4" }, "role": "reference_video" },
        { "type": "audio_url", "audio_url": { "url": "https://example.com/tea_audio1.mp3" }, "role": "reference_audio" }
      ],
      "ratio": "16:9",
      "duration": 11,
      "generate_audio": true,
      "watermark": false
    }
  }'
متاحة على seedance-2.0 و seedance-2.0-fast (مجموعات كاملة من الصورة + الفيديو + الصوت)؛ يقبل seedance-1-5-pro و seedance-1-0-* عناصر reference_image فقط.

تحرير / تمديد الفيديو

مرّر {type: "video_url", role: "reference_video"} واطلب من الموجّه تعديله أو تمديده:
curl https://api.orcarouter.ai/v1/video/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/dreamina-seedance-2-0-260128",
    "prompt": "Change all the fruits in [Video 1] into fresh fruits.",
    "metadata": {
      "content": [
        { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" }, "role": "reference_video" }
      ],
      "ratio": "adaptive",
      "duration": 6
    }
  }'
متاحة على seedance-2.0 و seedance-2.0-fast فقط.

Webhooks

مرّر metadata.callback_url: "https://your.domain/webhook" لتلقي طلب POST عندما تنتقل المهمة إلى SUCCESS أو FAILURE. تعكس الحمولة استجابة الاستطلاع. إذا قمت بتعيين كلا الاستطلاع والاستدعاء، فستحصل على كليهما — فهما مستقلان.

الفوترة

يمرّر OrcaRouter رسوم الرمز المميز لكل مهمة من المنبع دون أي زيادة. تتطابق التكلفة النهائية مع بطاقة أسعار ByteDance Ark المنشورة (يتم تحويل completion_tokens / total_tokens المنبعية من نتيجة المهمة إلى حصة بمعدل الرمز المميز للنموذج المحدد في إعدادات Channel Margin). يتم حجز مبلغ صغير مسبق الاستهلاك وقت الإرسال؛ يتم تسوية الفرق عند النجاح. راجع العمليات / الفوترة والاستخدام.

انظر أيضًا