Skip to main content
يمكن لنماذج Seedance 2.0 من image-to-video و reference-to-video تحريك فيديو بناءً على وجه بشري تقدمه. عندما يكتشف Venice API وجهًا في الوسائط المُرسَلة، فإنه يتطلب إقرار موافقة لمرة واحدة قبل معالجة الوسائط. هذا متطلب من المزود للمدخلات التي تحتوي على وجه ويحمي من استخدام الشبه دون موافقة. يغطي هذا الدليل بالضبط ما ترسله وما تستقبله وكيف يتم التعامل مع الطلبات المتكررة.

متى تنطبق الموافقة

تُطلب الموافقة فقط عندما يكون كلا الشرطين صحيحًا:
  1. النموذج هو متغير Seedance مؤهل لمعالجة الوجوه:
    • seedance-2-0-image-to-video, seedance-2-0-reference-to-video
    • seedance-2-0-fast-image-to-video, seedance-2-0-fast-reference-to-video
  2. الوسائط المُرسَلة تحتوي فعليًا على وجه بشري قابل للاكتشاف، في أي من هذه الحقول: image_url، end_image_url، reference_image_urls، reference_video_urls.
إذا لم يكن هناك أي وجه في أي من تلك الحقول، يستمر الطلب بشكل طبيعي دون خطوة موافقة. لا يدخل text-to-video أبدًا في هذا التدفق.
الموافقة لا تفتح المحتوى المقيد. الكشف عن قاصر مع مطالبات ذات إيحاءات جنسية/NSFW، أو شبه شخصية عامة يمكن التعرف عليها، يُرفض كانتهاك لسياسة المحتوى (422) ولا يمكن جعله مقبولًا عبر إقرار الموافقة.

تدفق الاستدعاءين

الاستدعاء 1 — الإرسال بدون موافقة

أرسل طلب التوليد كالمعتاد — دون حقل موافقة:
إذا تم اكتشاف وجه ولم تكن قد أقررت بعد، تحصل على 409 دون احتساب رسوم:
لا يتم احتساب أي اعتمادات أو دفعات x402 على 409.

الاستدعاء 2 — إعادة الإرسال مع الموافقة

أعد إرسال نفس جسم الطلب، مع إضافة كائن consents.seedance بثلاث تأكيدات، جميعها true:
يعيد الإرسال الناجح استجابة قائمة الانتظار العادية:
ثم استعلم عن POST /api/v1/video/retrieve باستخدام queue_id كالمعتاد (انظر توليد الفيديو).

كائن الموافقة

يجب أن تكون جميع الحقول الثلاثة قيمة منطقية true. أي حقل مفقود أو false أو أي حقل إضافي — بما في ذلك consent_version — يُرفض بـ 400. إصدار السياسة يحدده الخادم دائمًا؛ لا يرسل العملاء أبدًا إصدارًا ولا يختارونه.

الطلبات المتكررة (إزالة التكرار)

إذا أرسلت نفس بايتات الوسائط بالضبط التي سبق أن أقررت بها، فإن API يتعرف عليها ويتابع دون طلب موافقة مرة أخرى — يمكنك حذف consents.seedance في عمليات الإرسال المتطابقة اللاحقة. تتم هذه المطابقة عبر بايتات الصورة بالضبط: إعادة الترميز أو تغيير الحجم أو الاقتصاص ينتج بايتات مختلفة وسيطلب الموافقة مجددًا. المطابقة الجزئية (مُدخل واحد سبق إقراره بالإضافة إلى مُدخل وجه جديد) لا تزال تتطلب consents.seedance جديدة في الإرسال الجديد.

الإلغاء

لإلغاء الموافقة ومسح أصول الوجه المخزنة، سجل الدخول إلى تطبيق Venice على الويب (Settings). الإلغاء غير متاح عبر واجهة API العامة. بعد الإلغاء، سيطلب الطلب التالي الذي يستخدم تلك الوسائط الموافقة مرة أخرى.

الدفع

يتم اتخاذ قرار الموافقة دائمًا قبل أي رسوم، لكلتا طريقتي الدفع:
  • مفتاح API: تُعاد 409/422 قبل احتساب الرسوم؛ لا تُحاسَب على طلب محظور.
  • x402: تُحتسب رسوم الاستهلاك فقط بعد التوليد الناجح، لذا فإن 409/422 لا تُسوي شيئًا. أعد الإرسال بالموافقة (وتفويض x402 جديد) للمتابعة.

مرجع الأخطاء

المراجع