Veo 3.1

Veo 3.1 هو نموذج توليد الفيديو من Google. ويقدّمه SeedRouter بخمسة معرّفات نماذج على نقطة نهاية واحدة: ثلاثة مسعّرة لكل مقطع، ومدة كل مقطع 8 ثوانٍ، واثنان مسعّران لكل ثانية مع عناصر تحكم أكثر (المدة، والصوت، والبذرة، والموجّه السلبي، والإطار الأول والأخير). أرسل الطلب، واحتفظ بمعرّف المهمة المُعاد، ثم اقرأ الفيديو المكتمل من المهمة. وتُرسل الصور على شكل روابط URL.

معرّفات النماذج

راجع صفحة النموذج للاطلاع على الأسعار الحالية.

مثال سريع

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast",
    "prompt": "A red paper boat drifts across a calm pond at sunrise, soft mist on the water, slow push-in on a 35mm lens, no text, no logos.",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

نقطة النهاية

POST https://api.seedrouter.ai/v1/videos/generations

الاستجابة مهمة ({"id": "task_...", "status": "processing"}) لا الفيديو المكتمل. استعلم GET /v1/tasks/{task_id} للحصول على النتيجة. واحتفظ بمفاتيح API في شفرة تعمل على الخادم.

المعاملات: النماذج المسعّرة لكل مقطع

veo-3.1-fast وveo-3.1-quality وveo-3.1-lite.

المعاملات: النماذج المسعّرة لكل ثانية

veo-3.1-fast-official وveo-3.1-quality-official.

المخطط صارم: تُرفض الحقول غير المعروفة بدلًا من تجاهلها، ولا يقبل كل نموذج إلا حقوله الخاصة. ولا تتوفر عمليات الاستدعاء الراجع؛ استعلم عن المهمة بدلًا منها.

أوضاع الصور

في veo-3.1-fast وveo-3.1-quality، يحدّد generation_type طريقة استخدام image_urls:

لا يشغّل veo-3.1-quality وضع المراجع، لذا يرفض generation_type: "reference" ويرفض ثلاث صور بلا generation_type. ولا يقبل veo-3.1-lite أي صور.

في النماذج المسعّرة لكل ثانية، اضبط first_frame_image، واضبط last_frame_image اختياريًا. ويحدّد resize_mode ما إذا كانت الصورة ذات الشكل المختلف تُحشى أو تُقصّ.

مدخلات الوسائط

الصور روابط ⁦HTTP(S)⁩ عامة:

{ "image_urls": ["https://example.com/first.jpg", "https://example.com/last.jpg"] }

في النماذج المسعّرة لكل مقطع، تكون كل صورة بصيغة JPEG أو PNG أو WebP وبحجم 10 ميغابايت على الأكثر؛ والملف الذي يخالف هذه القواعد يُفشل المهمة دون احتساب أي رسوم. ولا تُقبل بيانات Base64: ارفع الملف إلى تخزينك الخاص ومرّر رابطه.

عوامل التكلفة

راجع قسم أسعار النموذج للاطلاع على الأسعار الحالية.

per-clip models:    cost = price of one clip at the output resolution        (720p and 1080p cost the same)
per-second models:  cost = duration × rate for the resolution and audio setting

تُحدَّد الرسوم عند قبول الطلب، لذا فالمبلغ المحجوز هو المبلغ المُحتسب. راجع الرسوم النهائية في سجل الاستخدام الخاص بحسابك. ولا تُحتسب رسوم على المهام الفاشلة.

بنية المخرجات

يعيد الإرسال المهمة:

{"id": "task_...", "model": "veo-3.1-fast", "status": "processing", "created_at": 1789689600}

الاستعلام عن المهمة

GET https://api.seedrouter.ai/v1/tasks/{task_id}

استعلم كل 10–20 ثانية حتى تصبح قيمة status هي completed أو failed. وانتهاء مهلة الشبكة أثناء الاستعلام لا يعني فشل التوليد: احتفظ بمعرّف المهمة واستأنف التحقق منها. ولا تنشئ مهمة أخرى لمعرفة التقدّم.

المهمة المكتملة

{
  "id": "task_...",
  "model": "veo-3.1-fast",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689720,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

video_url ملف MP4، أو GIF إذا ضبط الطلب enable_gif. والرابط موجود على تخزين SeedRouter.

ما أعادته تشغيلاتنا التجريبية (تشغيل واحد لكل منها، 2026-10-04):

لا تملك النماذج المسعّرة لكل مقطع مفتاحًا للصوت؛ أما النماذج المسعّرة لكل ثانية فتضيف مسارًا صوتيًا فقط مع generate_audio.

الأخطاء

الطلبات المرفوضة قبل إنشاء المهمة تعيد خطأ HTTP مصحوبًا بكائن error ولا تُحتسب عليها رسوم. أما المهمة التي تفشل بعد قبولها فتعيد عند الاستعلام رمز HTTP 200 مع status: "failed" وكائن error.

راجع كتالوج الأخطاء المشترك للاطلاع على الرموز وحالات HTTP وإرشادات إعادة المحاولة.

{
  "id": "task_...",
  "model": "veo-3.1-fast",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

إذا انتهت مهلة الإرسال نفسه، فراجع مهامك قبل الإرسال مجددًا: فربما قُبل الطلب الأول.

نصائح

• ابدأ بـ veo-3.1-lite أو veo-3.1-fast بدقة 720p لتجربة موجّه، ثم انتقل إلى Quality أو 4k للعرض النهائي.
• سمِّ الكاميرا والإضاءة: العدسة وحركة الكاميرا تغيّران اللقطة أكثر مما تفعله الصفات.
• أضف no text, no logos لإبعاد الكتابة والعلامات المختلقة عن الإطار.
• للقطة يجب أن تبدأ وتنتهي بصور معروفة، استخدم وضع الإطارات مع صورتين، أو النماذج المسعّرة لكل ثانية مع first_frame_image وlast_frame_image.
• ثبّت seed في النماذج المسعّرة لكل ثانية وغيّر عبارة واحدة في كل مرة لتطوير لقطة تدريجيًا.

مواضيع ذات صلة

• Playground وأسعار Veo 3.1
• تنزيل OpenAPI
• Markdown قابل للنسخ