تخطَّ إلى المحتوى

مستندات المطور UlazAI

Google Veo 3.1 إنشاء الفيديو API

Google Veo 3.1 إنشاء الفيديو API

قم بإنشاء مقاطع فيديو باستخدام Veo 3.1 باستخدام عناصر التحكم في الإطارات المدعومة وسير عمل حالة المهمة.

✨ جديد: يتوفر Veo 3.1 Lite والسريع والجودة مع التحكم في الإطار الأول والأخير.

✨مميزات Veo 3.1

✅ ثلاثة خيارات للنموذج - لايت، سريع، والجودة

✅ التحكم في الإطار - تعيين صور الإطار الأول والأخير

✅ تحويل النص إلى فيديو و صورة إلى فيديو

✅ فيديوهات مدتها 8 ثواني مع الصوت الأصلي

✅ دعم العلامة المائية - إضافة نص العلامة التجارية

✅ وضع احتياطي اختياري لمحاولة النموذج الثاني

✅ الترجمة الآلية إلى اللغة الإنجليزية

✅ نسب أبعاد متعددة (16:9، 9:16، تلقائي)

💰 التسعير

💸 Veo 3.1 لايت

40 الاعتمادات

وضع القيمة الأفضل

تحويل النص إلى فيديو + صورة إلى فيديو

⚡Veo 3.1 Fast

100 الاعتمادات

~ 0.92 دولار لكل فيديو

الوقت يختلف حسب قائمة الانتظار

💎 جودة Veo 3.1

220 الاعتمادات

~ 2.31 دولارًا لكل فيديو

الوقت يختلف حسب قائمة الانتظار

🛡️ الوضع الاحتياطي

+200 الاعتمادات

الوظيفة الإضافية الاختيارية

التراجع لا يضمن النجاح

بريد /veo31/api/generate/

إنشاء فيديو Veo 3.1

أنشئ مقطع فيديو مدته 8 ثوانٍ باستخدام Google Veo 3.1 باستخدام النص prompt وإطارات الصور الاختيارية.

هيئة الطلب

{
  "prompt": "A golden retriever running through a field of flowers at sunset",
  "model": "veo3_lite",           // Options: "veo3_lite", "veo3_fast", "veo3"
  "aspectRatio": "16:9",          // Options: "16:9", "9:16", "Auto"
  "imageUrls": [],                // Optional: Array of 1-2 image URLs
  "seeds": 42069,                 // Optional: 10000-99999 for reproducible results
  "watermark": "UlazAI",          // Optional: Max 50 characters
  "enableFallback": false,        // Optional fallback attempt; check current extra credits
  "enableTranslation": true       // Optional: Auto-translate to English
}

حدود

prompt * (سلسلة)

الوصف النصي للفيديو المراد إنشاؤه. الحد الأقصى 5000 حرف. كن وصفيًا بشأن الإجراءات وحركات الكاميرا والجو.

نموذج * (سلسلة)

نموذج للاستخدام: veo3_lite (40 الاعتمادات)، veo3_fast (100 الاعتمادات) أو veo3 (220 الاعتمادات)

نسبة العرض إلى الارتفاع (سلسلة)

نسبة العرض إلى الارتفاع للفيديو: 16:9 (المناظر الطبيعية)، 9:16 (صورة)، Auto (تلقائي). تقصير: 16:9

imageUrls (صفيف)

مجموعة اختيارية مكونة من 1-2 عناوين URL للصورة للتحكم في الإطار:
• صورة واحدة: يتمركز الفيديو حول هذه الصورة
• صورتان: انتقالات الفيديو من الإطار الأول إلى الإطار الأخير
الحد الأقصى 10 ميغابايت لكل صورة، JPG/PNG فقط

بذور (عدد صحيح)

بذور اختيارية للحصول على نتائج قابلة للتكرار. النطاق: 10000-99999

علامة مائية (سلسلة)

نص علامة مائية اختيارية للتراكب على الفيديو. الحد الأقصى 50 حرفًا. عظيم للعلامات التجارية.

تمكينالتراجع (منطقي)

تمكين محاولة نموذج النسخ الاحتياطي الاختيارية. تحقق من تكلفة الائتمان الإضافية الحالية؛ الاحتياطي لا يضمن الاكتمال. الافتراضي: false

تمكين الترجمة (منطقي)

الترجمة التلقائية prompt إلى الإنجليزية للحصول على أفضل النتائج. يدعم جميع اللغات. الافتراضي: true

استجابة النجاح (201)

{
  "success": true,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "processing",
    "model": "veo3_fast",
    "credits_charged": 100,
    "credits_remaining": 900,
    "estimated_time": "varies by queue",
    "message": "Veo 3.1 video generation started successfully"
  }
}

الاستجابة للخطأ (400)

{
  "success": false,
  "error": "Insufficient credits. Required: 100, Available: 50"
}

مثال cURL - تحويل النص إلى فيديو

curl -X POST https://ulazai.com/veo31/api/generate/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A golden retriever running through a field of flowers at sunset, slow motion, cinematic lighting",
    "model": "veo3_fast",
    "aspectRatio": "16:9",
    "watermark": "MyBrand",
    "enableTranslation": true
  }'

مثال cURL - صورة إلى فيديو مع التحكم في الإطار

curl -X POST https://ulazai.com/veo31/api/generate/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "The character slowly turns their head and smiles at the camera",
    "model": "veo3",
    "aspectRatio": "16:9",
    "imageUrls": ["https://your-domain.com/start-frame.jpg"],
    "seeds": 42069,
    "enableFallback": true
  }'

مثال بايثون

import requests
import time

API_KEY = "your_api_key_here"
BASE_URL = "https://ulazai.com"

# Generate video
response = requests.post(
    f"{BASE_URL}/veo31/api/generate/",
    headers={
        "Authorization": f"Token {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "prompt": "A serene mountain lake at sunrise with mist rising from the water",
        "model": "veo3_fast",
        "aspectRatio": "16:9",
        "watermark": "MyBrand"
    }
)

data = response.json()
if data["success"]:
    task_id = data["data"]["task_id"]
    print(f"Task created: {task_id}")

    # Poll for completion
    while True:
        status_response = requests.get(
            f"{BASE_URL}/veo31/api/status/{task_id}/",
            headers={"Authorization": f"Token {API_KEY}"}
        )

        status_data = status_response.json()
        if status_data["data"]["status"] == "completed":
            video_url = status_data["data"]["video_url"]
            print(f"Video ready: {video_url}")
            break
        elif status_data["data"]["status"] == "failed":
            print(f"Generation failed: {status_data['data']['error_message']}")
            break

        time.sleep(5)  # Poll every 5 seconds
else:
    print(f"Error: {data['error']}")
احصل على /veo31/api/status/<task_id>/

التحقق من حالة الجيل

التحقق من حالة مهمة إنشاء الفيديو Veo 3.1.

الاستجابة - المعالجة

{
  "success": true,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "processing",
    "model": "veo3_fast",
    "prompt": "A golden retriever running through flowers",
    "credits_charged": 100
  }
}

الرد - مكتمل

{
  "success": true,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "completed",
    "video_url": "https://cdn.ulazai.com/videos/veo31_abc123.mp4",
    "thumbnail_url": "https://cdn.ulazai.com/videos/veo31_abc123_thumb.jpg",
    "resolution": "1080p",
    "duration": 8,
    "aspect_ratio": "16:9",
    "fallback_used": false,
    "credits_charged": 100
  }
}

الرد - فشل

{
  "success": true,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "failed",
    "error_message": "Content policy violation. Enable fallback mode to retry.",
    "credits_refunded": 100
  }
}

مثال الضفيرة

curl -X GET https://ulazai.com/veo31/api/status/veo31_abc123def456/ \
  -H "Authorization: Token YOUR_API_KEY"
بريد /veo31/api/upload-frame/

تحميل صورة الإطار

قم بتحميل صورة للتحكم في الإطار (الإطار الأول أو الأخير). يُرجع عنوان URL لاستخدامه في إنشاء نقطة النهاية.

طلب (متعدد الأجزاء/بيانات النموذج)

Content-Type: multipart/form-data

image: (binary file data)

حدود

صورة * (ملف)

ملف الصورة للتحميل. ماكس 10 ميغابايت. التنسيقات المدعومة: JPG، PNG. الدقة الموصى بها: 1920 × 1080 أو أعلى.

استجابة النجاح (200)

{
  "success": true,
  "url": "https://cdn.ulazai.com/uploads/frame_abc123.jpg",
  "message": "Image uploaded successfully"
}

مثال الضفيرة

curl -X POST https://ulazai.com/veo31/api/upload-frame/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -F "image=@/path/to/your/image.jpg"

رموز الحالة

200 موافق - الطلب ناجح

201 تم الإنشاء - تم إنشاء مهمة الإنشاء بنجاح

400 طلب سيء - المعلمات غير صالحة أو الاعتمادات غير كافية

401 غير مصرح به - مفتاح API مفقود أو غير صالح

404 غير موجود - لم يتم العثور على معرف المهمة

413 الحمولة كبيرة جدًا - حجم الصورة يتجاوز 10 ميغابايت

429 طلبات كثيرة جدًا - تجاوز الحد الأقصى للسعر

500 خطأ داخلي في الخادم - خطأ في الخادم، اتصل بالدعم

قيم حالة المهمة

في انتظار - تم إنشاء المهمة، في انتظار البدء

معالجة - يتم إنشاء الفيديو

اكتمل - تم إنشاء الفيديو بنجاح، video_url متاح

فشل - فشل الإنشاء، وتم رد الاعتمادات تلقائيًا

💡 أفضل الممارسات

استخدم prompts الوصفية

قم بتضمين تفاصيل حول الإجراءات وحركات الكاميرا والإضاءة والجو. مثال: "لقطة مقربة بالحركة البطيئة لقطرات الماء المتساقطة، مضاءة من الخلف بغروب الشمس الذهبي، وعمق مجال ضحل"

تمكين الرجوع للمحتوى المهم

بالنسبة للمهام المهمة، فكر في المحاولة الاحتياطية الاختيارية واستمر في التعامل مع الأجيال الفاشلة أو المرفوضة في سير عملك.

استخدم البذور لتحقيق الاتساق

إذا كنت بحاجة إلى إعادة إنشاء مقاطع فيديو مماثلة، فاستخدم نفس القيمة الأولية (10000-99999) للحصول على نتائج أكثر اتساقًا.

التحكم في الإطار للعلامة التجارية

قم بتحميل صورة واحدة لتوسيط الفيديو الخاص بك حولها، أو صورتين لإنشاء انتقال سلس. مثالية لفيديوهات الشخصيات أو المنتجات المتسقة.

حالة الاستطلاع بكفاءة

قم بالاستطلاع كل 5 ثوانٍ للوضع السريع، و10 ثوانٍ لوضع الجودة. لا تقم بالاستطلاع بشكل متكرر لتجنب حدود المعدل.

📝 مثال Prompts

✅ جيد Prompt

"نسر مهيب يحلق فوق الجبال المغطاة بالثلوج عند الفجر، والضوء الذهبي يضيء جناحيه، وكاميرا تتبع الحركة البطيئة لقطة من الأسفل، تكوين سينمائي"

✅ جيد Prompt

"لقطة مقربة لصانع القهوة وهو يسكب فن اللاتيه، والبخار يتصاعد من الكوب، وإضاءة المقهى الدافئة، وعمق المجال الضحل، ومنظور العدسة الكلية"

❌ مسكين Prompt

"النسر الطائر"

غامض جدًا - تفاصيل مفقودة حول الإعداد والحركة وزاوية الكاميرا

هل تحتاج إلى مساعدة؟

هل تواجه مشكلة مع Veo 3.1 API؟ نحن هنا للمساعدة!