From c1e65c6a3113308b0597ba9702588d4762a3b621 Mon Sep 17 00:00:00 2001 From: Tomas Bystrican Date: Sat, 8 Aug 2026 18:31:20 +0930 Subject: [PATCH 1/5] Re-enable Seedance docs for faces-off API (API-103). Document Seedance 2.0 and 2.5 with family-specific limits, replace public consent how-tos with faces-off guidance, and restore the guide in nav while keeping the face-consent page off-nav. Co-authored-by: Cursor --- api-reference/endpoint/video/queue.mdx | 8 +- ar/api-reference/endpoint/video/queue.mdx | 8 +- ar/guides/media/seedance-2-0.mdx | 304 +++++++++------- de/api-reference/endpoint/video/queue.mdx | 8 +- de/guides/media/seedance-2-0.mdx | 324 ++++++++++-------- docs.json | 9 + ...6-08-08-api-103-seedance-faces-off-docs.md | 25 ++ ...-api-103-seedance-faces-off-docs-design.md | 79 +++++ es/api-reference/endpoint/video/queue.mdx | 8 +- es/guides/media/seedance-2-0.mdx | 308 ++++++++++------- fr/api-reference/endpoint/video/queue.mdx | 8 +- fr/guides/media/seedance-2-0.mdx | 300 +++++++++------- guides/media/seedance-2-0.mdx | 142 +++++--- it/api-reference/endpoint/video/queue.mdx | 8 +- it/guides/media/seedance-2-0.mdx | 312 ++++++++++------- ko/api-reference/endpoint/video/queue.mdx | 8 +- ko/guides/media/seedance-2-0.mdx | 308 ++++++++++------- pt-BR/api-reference/endpoint/video/queue.mdx | 8 +- pt-BR/guides/media/seedance-2-0.mdx | 302 +++++++++------- zh/api-reference/endpoint/video/queue.mdx | 8 +- zh/guides/media/seedance-2-0.mdx | 302 +++++++++------- 21 files changed, 1666 insertions(+), 1121 deletions(-) create mode 100644 docs/superpowers/plans/2026-08-08-api-103-seedance-faces-off-docs.md create mode 100644 docs/superpowers/specs/2026-08-08-api-103-seedance-faces-off-docs-design.md diff --git a/api-reference/endpoint/video/queue.mdx b/api-reference/endpoint/video/queue.mdx index fbee520d..c5c974c2 100644 --- a/api-reference/endpoint/video/queue.mdx +++ b/api-reference/endpoint/video/queue.mdx @@ -9,13 +9,13 @@ Call `/video/quote` to get a price estimate, then poll `/video/retrieve` with th Private models also return a `download_url` for the finished video. It is a short-lived delivery URL (a few retries are fine if a download drops); see the [Video Generation guide](/guides/media/video-generation#private-download-links) for details and optional `DELETE` for privacy. -### Seedance 2.0 +### Seedance 2.0 & 2.5 -For `seedance-2-0-*` models (text-to-video, image-to-video, reference-to-video, plus the `-fast-*` variants), see the [Seedance 2.0 Guide](/guides/media/seedance-2-0) for the four-workflow model (Reference / Edit / Extend / Stitch), canonical prompt patterns, multimodal input limits, and pricing details. +For `seedance-2-0-*` and `seedance-2-5-*` models (text-to-video, image-to-video, reference-to-video, plus the Seedance 2.0 `-fast-*` variants), see the [Seedance 2.0 & 2.5 Guide](/guides/media/seedance-2-0) for the four-workflow model (Reference / Edit / Extend / Stitch), family-specific multimodal limits, faces-off API behavior, and pricing details. -### Seedance consent +### Seedance faces-off API -When a Seedance image- or reference-to-video request contains a human face, the API returns a `409 needs_consent` with the policy text, and you resubmit the same request with a `consents.seedance` attestation. See the [Seedance Face-Media Consent Guide](/guides/media/seedance-face-consent) for the full flow, the consent object, dedupe, and revocation. +Public Seedance models do **not** support face-asset provisioning or face-consent attestation. Face-bearing inputs may be rejected upstream. For likeness / face-asset generation, use the Venice app or Studio. See the [Seedance guide](/guides/media/seedance-2-0) for details. ### Video upscaling diff --git a/ar/api-reference/endpoint/video/queue.mdx b/ar/api-reference/endpoint/video/queue.mdx index 0b982a72..bde1d794 100644 --- a/ar/api-reference/endpoint/video/queue.mdx +++ b/ar/api-reference/endpoint/video/queue.mdx @@ -9,13 +9,13 @@ openapi: 'POST /video/queue' تُعيد النماذج الخاصة أيضًا `download_url` للفيديو النهائي. وهو عنوان URL للتسليم قصير الأمد (لا بأس بإعادة المحاولة بضع مرات في حال انقطع التنزيل)؛ راجع [دليل توليد الفيديو](/guides/media/video-generation#private-download-links) للتفاصيل و`DELETE` الاختيارية للخصوصية. -### Seedance 2.0 +### Seedance 2.0 و 2.5 -بالنسبة لنماذج `seedance-2-0-*` (text-to-video، image-to-video، reference-to-video، بالإضافة إلى متغيرات `-fast-*`)، راجع [دليل Seedance 2.0](/guides/media/seedance-2-0) لنموذج التدفقات الأربعة (Reference / Edit / Extend / Stitch)، وأنماط الـ prompt القياسية، وحدود الإدخال متعدد الوسائط، وتفاصيل التسعير. +لنماذج `seedance-2-0-*` و `seedance-2-5-*` (text-to-video و image-to-video و reference-to-video، بالإضافة إلى متغيّرات `-fast-*` لـ Seedance 2.0)، راجع [دليل Seedance 2.0 و 2.5](/guides/media/seedance-2-0) لنموذج سير العمل الأربعة (Reference / Edit / Extend / Stitch) وحدود الوسائط المتعددة حسب العائلة وسلوك واجهة faces-off وتفاصيل التسعير. -### موافقة Seedance +### واجهة Seedance بدون وجوه (faces-off) -عندما يحتوي طلب image-to-video أو reference-to-video في Seedance على وجه بشري، تُعيد الـ API استجابة `409 needs_consent` مع نص السياسة، وتعيد إرسال الطلب نفسه مع شهادة `consents.seedance`. راجع [دليل موافقة Seedance لوسائط الوجوه](/guides/media/seedance-face-consent) للتدفق الكامل وكائن الموافقة وإزالة التكرار والإلغاء. +نماذج Seedance العامة **لا** تدعم تجهيز أصول الوجه ولا إثبات موافقة الوجه. قد تُرفض المدخلات التي تحتوي على وجوه في المنبع. لتوليد likeness / أصول الوجه استخدم تطبيق Venice أو Studio. راجع [دليل Seedance](/guides/media/seedance-2-0). ### تكبير الفيديو diff --git a/ar/guides/media/seedance-2-0.mdx b/ar/guides/media/seedance-2-0.mdx index 9c7eacf0..a8281281 100644 --- a/ar/guides/media/seedance-2-0.mdx +++ b/ar/guides/media/seedance-2-0.mdx @@ -1,49 +1,58 @@ --- -title: "Seedance 2.0" -description: "أنشئ، حرّر، مدّد، ولصِّق مقاطع الفيديو مع Seedance 2.0 على Venice — تدفقات نص وصورة ومرجع إلى فيديو على endpoint واحد، مع أمثلة مشروحة." -'og:title': "دليل Seedance 2.0 | وثائق Venice API" -'og:description': "ولِّد وحرِّر ومدِّد وادمج مقاطع الفيديو باستخدام Seedance 2.0 عبر Venice API. أنماط سير العمل وحدود الإدخال متعدد الوسائط والتسعير وأمثلة عملية." +title: "Seedance 2.0 و 2.5" +description: "أنشئ وحرّر ومدّد والصِق مقاطع الفيديو مع Seedance 2.0 و 2.5 على Venice - تدفقات النص/الصورة/المرجع، وسلوك واجهة faces-off، وحدود الوسائط المتعددة حسب العائلة." +'og:title': "دليل Seedance 2.0 و 2.5 | وثائق Venice API" +'og:description': "ولِّد وحرِّر ومدِّد وادمج مقاطع الفيديو باستخدام Seedance 2.0 و 2.5 عبر Venice API. أنماط سير العمل وfaces-off والحدود والتسعير والأمثلة." --- -Seedance 2.0 هو نموذج فيديو رائد متعدد الوسائط، متاح على Venice كعائلة من ثلاثة متغيّرات لتوليد الفيديو من النص والصورة والمراجع. متغيّر **reference-to-video** قويّ بشكل غير معتاد: نقطة نهاية واحدة ومعرّف نموذج واحد يتعاملان مع **أربعة سير عمل مميّزة** (Reference، Edit، Extend، Stitch) — ويُستنتج سير العمل من **شكل التعليمة**. +Seedance is a flagship multimodal video family on Venice for text-, image-, and reference-driven video generation. **Seedance 2.0** (plus Fast) and **Seedance 2.5** share the same R2V prompt-routing model: a single reference-to-video endpoint handles **four distinct workflows** (Reference, Edit, Extend, Stitch) — the workflow is inferred from the **shape of your prompt**. -يستعرض هذا الدليل المتغيّرات، وسير العمل الأربعة مع التعليمات المعيارية، وحدود الإدخال متعدد الوسائط، والتسعير، وأمثلة `curl` كاملة. +This guide covers variants, the four workflows, **faces-off public API behavior**, **family-specific multimodal limits**, pricing, and `curl` examples. -## المتغيّرات + +**الوجوه غير مدعومة على واجهة Seedance العامة.** لا تشغّل Venice تجهيز أصول الوجه ولا إثبات موافقة الوجه (`consents.seedance` / `needs_consent`) لنماذج Seedance العامة. قد تُرفض المدخلات التي تحتوي على وجوه في المنبع كخطأ سياسة محتوى / مزوّد. لتوليد likeness / أصول الوجه استخدم تطبيق Venice أو Studio. + + +## Variants -| معرّف النموذج | المتغيّر | دقّات الإخراج | ملاحظات | +| Model ID | Variant | Output resolutions | Notes | |---|---|---|---| -| `seedance-2-0-text-to-video` | T2V | 480p / 720p / 1080p | تعليمة نصية فقط | -| `seedance-2-0-image-to-video` | I2V | 480p / 720p / 1080p | تثبيت بصورة الإطار الأول (واختياريًا الإطار الأخير) | -| `seedance-2-0-reference-to-video` | R2V | 480p / 720p / 1080p | حتى 9 صور مرجعية + 3 فيديوهات مرجعية + 3 مانحات صوتية. يدعم Reference / Edit / Extend / Stitch | -| `seedance-2-0-fast-text-to-video` | Fast T2V | 480p / 720p | فئة أسرع بجودة أقل | -| `seedance-2-0-fast-image-to-video` | Fast I2V | 480p / 720p | فئة أسرع بجودة أقل | -| `seedance-2-0-fast-reference-to-video` | Fast R2V | 480p / 720p | فئة أسرع بجودة أقل؛ نفس مجموعة سير العمل | +| `seedance-2-0-text-to-video` | T2V | 480p / 720p / 1080p | Text prompt only | +| `seedance-2-0-image-to-video` | I2V | 480p / 720p / 1080p | First-frame (and optionally last-frame) image grounding | +| `seedance-2-0-reference-to-video` | R2V | 480p / 720p / 1080p | Up to 9 reference images + 3 reference videos + 3 reference audio donors. Powers Reference / Edit / Extend / Stitch | +| `seedance-2-0-fast-text-to-video` | Fast T2V | 480p / 720p | Faster, lower-fidelity tier | +| `seedance-2-0-fast-image-to-video` | Fast I2V | 480p / 720p | Faster, lower-fidelity tier | +| `seedance-2-0-fast-reference-to-video` | Fast R2V | 480p / 720p | Faster, lower-fidelity tier; same workflow set | +| `seedance-2-5-text-to-video` | T2V | 480p / 720p | Up to 30s output; native audio | +| `seedance-2-5-image-to-video` | I2V | 480p / 720p | Up to 30s output; first-frame (and optionally last-frame) grounding | +| `seedance-2-5-reference-to-video` | R2V | 480p / 720p | Up to 30 images + 10 videos + 10 audio donors; same Reference / Edit / Extend / Stitch workflows | -جميع المتغيّرات غير متزامنة. أرسل عبر `POST /api/v1/video/queue`، ثم استعلم بـ `POST /api/v1/video/retrieve` حتى يصبح جسم الاستجابة `video/mp4`. راجع [توليد الفيديو](/guides/media/video-generation) لتدفق الطابور العام. +All variants are async. Submit via `POST /api/v1/video/queue`, then poll `POST /api/v1/video/retrieve` until the response body is `video/mp4`. See [Video Generation](/guides/media/video-generation) for the general queue flow. -## نموذج «نموذج واحد، أربعة سير عمل» +Discover live model IDs with `GET /models?type=video` — do not hardcode availability. -متغيّر reference-to-video (`seedance-2-0-reference-to-video` وشقيقه Fast) هو النموذج الأساسي ذاته يخدم أربع مهام مختلفة. **يستنتج النموذج المهمة من بادئة التعليمة وشكل مدخلاتك.** لا يوجد حقل `task` أو `workflow` — فبنية التعليمة هي ما يحدّد التوجيه. +## The "one model, four workflows" model -| سير العمل | ما يفعله | بادئة التعليمة | المدخلات | +The reference-to-video variants (`seedance-2-0-reference-to-video`, its Fast sibling, and `seedance-2-5-reference-to-video`) use the same prompt-routing pattern. **The model infers the task from the prompt prefix and the shape of your inputs.** There is no `task` or `workflow` field — the prompt syntax is the routing. + +| Workflow | What it does | Prompt prefix | Inputs | |---|---|---|---| -| **Reference** | توليد فيديو جديد باستخدام الملفات المرجعية المرفوعة كمانحات للموضوع / الحركة / الأسلوب / الصوت | `Refer to ... in to generate ...` | نص + ≥1 مرجع صورة أو فيديو (0–9 صور، 0–3 فيديوهات)، بالإضافة اختياريًا إلى ما يصل إلى 3 مانحات صوتية | -| **Edit** | تعديل فيديو إدخال واحد مع الحفاظ على الباقي | `Strictly edit