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

UlazAI - أدوات الصور والفيديو بالذكاء الاصطناعي

Veo 3 مطالبات JSON

سيد منظم اِسْتَدْعَىللتحكم الدقيق في إنشاء الفيديو بالذكاء الاصطناعي. مثالي لتكامل مرجع API ومعالجة الدفعات وسير العمل الاحترافي.

🔧 تعلم تنسيق جيسون 📚 توثيق API
أساسيات جيسون حدود أمثلة التكامل API أفضل الممارسات

JSON أساسيات موجه

لماذا نستخدم JSON prompts؟

1

التحكم الدقيق

حدد المعلمات الدقيقة للحصول على نتائج متسقة ويمكن التنبؤ بها عبر أجيال متعددة.

2

API جاهز

مثالي لإنشاء مقاطع فيديو برمجية وسير العمل الآلي.

3

قابلة للتكرار

حفظ وإعادة استخدام التكوينات الناجحة لمعالجة الدفعات.

4

التحكم في الإصدار

تتبع التغييرات والتعاون عليها اِسْتَدْعَى التكوينات بشكل فعال

هيكل JSON الأساسي

{
  "prompt": "Your detailed video description",
  "style": "cinematic",
  "camera": {
    "type": "wide_shot",
    "movement": "slow_pan"
  },
  "lighting": "golden_hour",
  "quality": "4k",
  "duration": "10s",
  "aspect_ratio": "16:9"
}

مطلوب: اِسْتَدْعَى (سلسلة)

اختياري: جميع المعلمات الأخرى لها إعدادات افتراضية

التنسيق: مطلوب بناء جملة JSON صالح

مرجع المعلمة الكامل

🎯 الأساسية حدود

اِسْتَدْعَى

الوصف الرئيسي لمحتوى الفيديو

string (required)

أسلوب

البصرية الشاملة أسلوب والجمالية

"cinematic" | "realistic" | "artistic" | "documentary"

جودة

دقة الإخراج ومستوى التفاصيل

"4k" | "hd" | "standard" | "high"

مدة

مواصفات طول الفيديو

"5s" | "10s" | "15s" | "short" | "medium"

📹 التحكم بالكاميرا

camera.type

تأطير النار والمنظور

"wide_shot" | "close_up" | "medium_shot" | "extreme_wide"

camera.movement

حركة الكاميرا وديناميكياتها

"static" | "pan_left" | "pan_right" | "dolly_in" | "crane"

camera.angle

الوضع الرأسي بالنسبة للموضوع

"eye_level" | "low_angle" | "high_angle" | "birds_eye"

camera.lens

خصائص العدسة والبعد البؤري

"wide_angle" | "standard" | "telephoto" | "macro"

🎨 التحكم في المشهد

إضاءة

ظروف الإضاءة والمزاج

"golden_hour" | "blue_hour" | "studio" | "natural" | "dramatic"

مزاج

النغمة العاطفية والجو

"serene" | "energetic" | "mysterious" | "uplifting" | "dramatic"

color_palette

نظام الألوان والدرجات

"warm" | "cool" | "vibrant" | "muted" | "monochrome"

aspect_ratio

أبعاد وشكل الفيديو

"16:9" | "9:16" | "1:1" | "21:9" | "4:3"

جسون Prompt أمثلة

🎬 مشهد سينمائي

{
  "prompt": "Aerial shot of red sports car racing through mountain curves at sunset",
  "style": "cinematic",
  "camera": {
    "type": "aerial",
    "movement": "tracking",
    "angle": "high_angle"
  },
  "lighting": "golden_hour",
  "mood": "dramatic",
  "quality": "4k",
  "duration": "15s",
  "aspect_ratio": "21:9",
  "color_palette": "warm"
}

حالة الاستخدام: مسلسلات أكشن، إعلانات سيارات

الميزات الرئيسية: تنسيق سينمائي واسع، وتتبع جوي

👤 صورة احترافية

{
  "prompt": "Professional headshot of confident businesswoman, warm smile, eye contact",
  "style": "realistic",
  "camera": {
    "type": "close_up",
    "movement": "static",
    "angle": "eye_level",
    "lens": "85mm"
  },
  "lighting": "studio",
  "mood": "professional",
  "quality": "4k",
  "duration": "8s",
  "aspect_ratio": "16:9",
  "color_palette": "neutral"
}

حالة الاستخدام: مقاطع فيديو الشركات والملفات الشخصية على LinkedIn

الميزات الرئيسية: إضاءة الاستوديو، عدسة صورة

📱 معرض المنتجات

{
  "prompt": "Sleek smartphone rotating on white surface, premium materials visible",
  "style": "commercial",
  "camera": {
    "type": "medium_shot",
    "movement": "orbit",
    "angle": "slightly_low"
  },
  "lighting": "studio",
  "mood": "clean",
  "quality": "4k",
  "duration": "10s",
  "aspect_ratio": "16:9",
  "color_palette": "minimal",
  "background": "clean_white"
}

حالة الاستخدام: تسويق المنتجات، التجارة الإلكترونية

الميزات الرئيسية: الكاميرا المدارية، خلفية نظيفة

🎨 الحركة المجردة

{
  "prompt": "Fluid abstract shapes morphing in vibrant neon colors",
  "style": "artistic",
  "camera": {
    "type": "macro",
    "movement": "floating",
    "angle": "dynamic"
  },
  "lighting": "neon",
  "mood": "energetic",
  "quality": "4k",
  "duration": "12s",
  "aspect_ratio": "16:9",
  "color_palette": "vibrant",
  "effects": ["glow", "particle_systems"],
  "speed": "slow_motion"
}

حالة الاستخدام: فيديوهات موسيقية، محتوى فني

الميزات الرئيسية: المؤثرات الخاصة، الحركة البطيئة

🎭 JSON المتقدم متعدد المشاهد

{
  "project": {
    "title": "Brand Story Campaign",
    "total_duration": "45s",
    "aspect_ratio": "16:9",
    "quality": "4k"
  },
  "scenes": [
    {
      "id": "scene_1",
      "prompt": "Wide establishing shot of modern office building at sunrise",
      "style": "cinematic",
      "camera": {
        "type": "extreme_wide",
        "movement": "slow_push_in",
        "angle": "slightly_low"
      },
      "lighting": "golden_hour",
      "duration": "8s",
      "mood": "inspiring"
    },
    {
      "id": "scene_2",
      "prompt": "Medium shot of diverse team collaborating around conference table",
      "style": "realistic",
      "camera": {
        "type": "medium_shot",
        "movement": "subtle_pan",
        "angle": "eye_level"
      },
      "lighting": "natural_office",
      "duration": "12s",
      "mood": "professional"
    },
    {
      "id": "scene_3",
      "prompt": "Close-up of hands typing on laptop, screen reflecting innovation",
      "style": "commercial",
      "camera": {
        "type": "macro",
        "movement": "static",
        "angle": "overhead"
      },
      "lighting": "screen_glow",
      "duration": "10s",
      "mood": "focused"
    }
  ],
  "transitions": {
    "type": "fade",
    "duration": "1s"
  },
  "audio": {
    "style": "corporate_uplifting",
    "volume": "background"
  }
}

نصيحة احترافية: يتيح JSON متعدد المشاهد روايات معقدة مع التحكم الدقيق في كل مقطع.

التكامل API دليل

🌐 مثال لطلب HTTP

curl -X POST https://ulazai.com/api/v1/video/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Cinematic aerial shot of mountain landscape",
    "style": "cinematic",
    "camera": {
      "type": "aerial",
      "movement": "forward_dolly"
    },
    "quality": "4k",
    "duration": "10s",
    "aspect_ratio": "16:9"
  }'

تنسيق الاستجابة

{
  "success": true,
  "job_id": "veo3_abc123def456",
  "status": "processing",
  "estimated_time": "varies by queue",
  "webhook_url": "https://your-app.com/webhook",
  "cost": "returned with the current quote"
}

🐍 التكامل بايثون

import requests
import json

# Your API configuration
API_KEY = "your_api_key_here"
BASE_URL = "https://ulazai.com/api/v1"

# JSON اِسْتَدْعَى configuration
video_config = {
    "prompt": "Professional product demo video",
    "style": "commercial",
    "camera": {
        "type": "medium_shot",
        "movement": "orbit"
    },
    "lighting": "studio",
    "quality": "4k",
    "duration": "15s"
}

# Send generation request
response = requests.post(
    f"{BASE_URL}/video/generate",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json=video_config
)

result = response.json()
print(f"Job ID: {result['job_id']}")
print(f"Status: {result['status']}")

استطلاع الحالة

# Check generation status
status_response = requests.get(
    f"{BASE_URL}/video/status/{job_id}",
    headers={"Authorization": f"Bearer {API_KEY}"}
)

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

📱 مثال JavaScript/Node.js

const axios = require('axios');

class UlazAIClient {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseURL = 'https://ulazai.com/api/v1';
  }

  async generateVideo(config) {
    try {
      const response = await axios.post(`${this.baseURL}/video/generate`, config, {
        headers: {
          'Authorization': `Bearer ${this.apiKey}`,
          'Content-Type': 'application/json'
        }
      });

      return response.data;
    } catch (error) {
      throw new Error(`Generation failed: ${error.response.data.message}`);
    }
  }

  async getVideoStatus(jobId) {
    const response = await axios.get(`${this.baseURL}/video/status/${jobId}`, {
      headers: { 'Authorization': `Bearer ${this.apiKey}` }
    });

    return response.data;
  }
}

// Usage example
const client = new UlazAIClient('your_api_key');

const videoConfig = {
  اِسْتَدْعَى: "Time lapse of city skyline transition from day to night",
  أسلوب: "cinematic",
  camera: { type: "wide_shot", movement: "static" },
  إضاءة: "day_to_night",
  مدة: "20s",
  جودة: "4k"
};

client.generateVideo(videoConfig)
  .then(result => console.log('Generation started:', result.job_id))
  .catch(error => console.error('Error:', error.message));

أفضل ممارسات JSON السريعة

✅ إرشادات الهيكل

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

⚡ نصائح الأداء

  • • قم بتخزين التكوينات الناجحة في ذاكرة التخزين المؤقت لإعادة استخدامها
  • • استخدم خطافات الويب بدلاً من الاستقصاء عن الحالة
  • • قم بتجميع الطلبات المماثلة عندما يكون ذلك ممكنًا
  • • تحسين اِسْتَدْعَى الطول لمعالجة أسرع
  • • مراقبة استخدام الائتمان وضبط التنبيهات

🛡️ معالجة الأخطاء

  • • تنفيذ منطق إعادة المحاولة مع التراجع الأسي
  • • التحقق من صحة المعلمات قبل استدعاءات API
  • • التعامل مع معدل الحد بأمان
  • • سجل الفشل مع سياق التصحيح
  • • توفير خيارات احتياطية للأجيال الفاشلة

🚨 أخطاء وحلول JSON الشائعة

❌ بناء جملة JSON غير صالح

{ "prompt": "Test", "quality": "4k", } // Trailing comma
{ "prompt": "Test", "quality": "4k" } // Correct

❌ قيم المعلمات غير صالحة

{ "quality": "super_high" } // Invalid value
{ "quality": "4k" } // Valid value

❌ الحقول المطلوبة مفقودة

{ "style": "cinematic" } // Missing اِسْتَدْعَى
{ "prompt": "Test video", "style": "cinematic" }

❌ المعلمات المتضاربة

{ "mood": "serene", "style": "action" } // Conflicting
{ "mood": "energetic", "style": "action" } // Consistent

جاهز للاستخدام مطالبات JSON?

ابدأ في دمج إنشاء الفيديو المنظم في تطبيقاتك. احصل على إمكانية الوصول إلى واجهة برمجة التطبيقات (API) وابدأ في الإنشاء بتحكم دقيق.

📚 توثيق API 🎁 احصل على مفتاح API مجانًا

أرصدة مجانية لواجهة برمجة التطبيقات (API) • دعم احترافي • خيارات مؤسسية متاحة