واجهة برمجة تطبيقات Seedance 1.0 Lite: نقطة نهاية سريعة لتوليد الفيديو

طلب POST واحد، وانتظار من 30 إلى 60 ثانية، وتحصل على ملف MP4 بدقة 1080p. هذا هو كل ما في واجهة برمجة تطبيقات Seedance 1.0 Lite. إذا كنت مطوراً تبني سير عمل فيديو آلية، سواء كانت رسوم متحركة لمنتجات التجارة الإلكترونية، أو خطوط إنتاج إعلانية، أو أنظمة توليد محتوى، فهذا هو دليل التكامل الذي تحتاجه.

ملخص سريع

• نقطة نهاية POST واحدة تقبل صورة + وصف الحركة، وتُعيد ملف MP4 بدقة 1080p
• نموذج مهام غير متزامن: أرسل الطلب، استعلم عن الحالة، ثم نزّل النتيجة
• تكلفة كل استدعاء: $0.20-$1.00 بحسب المدة (من 2 إلى 12 ثانية)
• زمن الاستجابة الكلي المعتاد: من 30 إلى 60 ثانية
• 10 رصيد مجاني عند التسجيل، يكفي للتحقق من التكامل قبل الالتزام
• نفس مجموعة الرصيد تعمل عبر جميع نماذج Arteza و Seedream

لماذا يدمج المطورون الواجهة البرمجية

النسخة المرئية من Seedance 1.0 Lite رائعة للتوليد اليدوي. أما الواجهة البرمجية فتفتح أمامك سير العمل التي لا يمكن للاستخدام اليدوي دعمها:

• أتمتة رسوم الكتالوج المتحركة - شغّل عملية توليد لكل وحدة SKU جديدة تُضاف إلى خلفية متجرك الإلكتروني
• خطوط إنتاج الإعلانات - أنشئ متغيرات وفق جدول زمني وادفعها إلى منصات الإعلانات عبر واجهاتها البرمجية
• أنظمة توليد المحتوى - أرسل صور نظام إدارة المحتوى إلى Arteza واحصل على نسخ متحركة منها
• سير عمل المحتوى الذي يُنشئه المستخدمون في الوقت الفعلي - دع مستخدميك يرفعون صورة ويحصلون على نسخة متحركة منها
• المهام الدفعية - عالج مئات الصور المصدر طوال الليل

بتكلفة $0.20-$1.00 لكل استدعاء وزمن استجابة من 30 إلى 60 ثانية، يمكنك بناء أتمتة فيديو بمستوى الإنتاج الاحترافي، وهو ما كان مستحيلاً اقتصادياً قبل 18 شهراً.

الحصول على صلاحية الوصول إلى الواجهة البرمجية

1. سجّل على المنصة - يصلك 10 رصيد مجاني فوراً
2. انتقل إلى إعدادات الواجهة البرمجية في لوحة التحكم
3. أنشئ مفتاح API - احفظه بأمان (لا تضمّه أبداً في مستودع git)
4. اختياري: اختر خطة شهرية من صفحة الأسعار - $5 أو $25 أو $50 أو $120

رصيدك المجاني البالغ 10 يعمل مع استدعاءات الواجهة البرمجية أيضاً. يمكنك التحقق من التكامل الكامل قبل دفع أي شيء.

نموذج الطلب

التفاعل الأساسي هو إرسال طلب POST واحد إلى نقطة نهاية التوليد في Seedance 1.0 Lite.

المعاملات المطلوبة

المعاملات الاختيارية

نموذج الاستجابة

تُعيد الواجهة البرمجية معرّف المهمة وحالتها. عملية التوليد غير متزامنة، لذا استعلم عن الحالة أو استخدم webhook.

{
  "job_id": "sd1lite_abc123xyz",
  "status": "processing",
  "credits_charged": 42,
  "estimated_time_seconds": 45,
  "created_at": "2026-04-10T12:00:00Z"
}

عند الاكتمال:

{
  "job_id": "sd1lite_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/...",
  "duration_seconds": 6,
  "resolution": "1080p",
  "credits_charged": 42,
  "completed_at": "2026-04-10T12:00:45Z"
}

المصادقة

تستخدم جميع الطلبات مصادقة رمز الحامل عبر رأس Authorization:

Authorization: Bearer YOUR_API_KEY

مفاتيح الواجهة البرمجية مرتبطة بحسابك وتُخصم من رصيد الاعتمادات. قم بتدوير المفاتيح عبر لوحة التحكم إذا اشتبهت في تسرّب.

مثال على الكود: Python

إليك تكاملاً بسيطاً بلغة Python يُرسل مهمة، ويستعلم عن حالتها، ثم ينزّل النتيجة.

import requests
import time
import os

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1"

def generate_video(image_url, prompt, duration=6, aspect="9:16"):
    # إرسال المهمة
    response = requests.post(
        f"{BASE_URL}/seedance-1-lite/generate",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "image": image_url,
            "prompt": prompt,
            "duration": duration,
            "resolution": "1080p",
            "aspect_ratio": aspect,
            "camera_lock": True,
        },
    )
    job = response.json()
    job_id = job["job_id"]
    
    # الاستعلام عن الحالة حتى الاكتمال
    while True:
        status_response = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        )
        status = status_response.json()
        if status["status"] == "completed":
            return status["video_url"]
        if status["status"] == "failed":
            raise Exception(f"Generation failed: {status.get('error')}")
        time.sleep(5)

video_url = generate_video(
    image_url="https://example.com/product.jpg",
    prompt="Product rotates smoothly, highlights catch across the surface, camera completely locked",
    duration=6,
    aspect="1:1",
)
print(f"Video ready: {video_url}")

مثال على الكود: Node.js

const axios = require('axios');

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1';

async function generateVideo(imageUrl, prompt, duration = 6, aspect = '9:16') {
  // إرسال المهمة
  const { data: job } = await axios.post(
    `${BASE_URL}/seedance-1-lite/generate`,
    {
      image: imageUrl,
      prompt,
      duration,
      resolution: '1080p',
      aspect_ratio: aspect,
      camera_lock: true,
    },
    {
      headers: { Authorization: `Bearer ${API_KEY}` },
    }
  );

  // الاستعلام عن الحالة حتى الاكتمال
  while (true) {
    const { data: status } = await axios.get(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } }
    );

    if (status.status === 'completed') return status.video_url;
    if (status.status === 'failed') throw new Error(status.error);

    await new Promise((r) => setTimeout(r, 5000));
  }
}

generateVideo(
  'https://example.com/product.jpg',
  'Product rotates smoothly, highlights catch across the surface, camera completely locked',
  6,
  '1:1'
).then((url) => console.log('Video ready:', url));

نمط Webhook (موصى به للإنتاج)

الاستعلام الدوري يعمل، لكن الـ webhooks أكثر نظافة على نطاق واسع. مرّر webhook_url في طلب التوليد وستُرسل الواجهة البرمجية حمولة الاكتمال عبر POST عند انتهاء المهمة.

response = requests.post(
    f"{BASE_URL}/seedance-1-lite/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "image": image_url,
        "prompt": prompt,
        "duration": 6,
        "webhook_url": "https://your-app.com/webhooks/seedance",
    },
)

معالج الـ webhook الخاص بك يستقبل نفس JSON الاكتمال الذي تُعيده نقطة نهاية الاستعلام. لا حاجة لحلقة استعلام.

هل تريد صنع هذا بنفسك؟ جرّب Seedance 1.0 Lite مجاناً →

هل أنت مستعد لتجربة Seedance 1.0 Lite؟ ابدأ الإنشاء مجاناً →

حدود المعدل والتزامن

للحصول على تزامن أو حجم أعلى، تواصل مع الدعم. يمكن للمنصة دعم أحمال عمل دفعية تتجاوز 10,000 مهمة يومياً على إعدادات مخصصة.

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

تنطبق رموز حالة HTTP القياسية:

للتكاملات الإنتاجية، نفّذ دائماً:

• التراجع الأسي لأخطاء 429 و500
• فحص رصيد الاعتمادات قبل تشغيل دفعات كبيرة
• التحقق من توقيع الـ webhook عند استخدام الـ webhooks
• مفاتيح الأمان لمنع الرسوم المكررة عند أخطاء الشبكة

إدارة التكاليف في الإنتاج

كل استدعاء يُخصم منه رصيد بحسب المدة: رصيدان لمقطع مدته من 2 إلى 3 ثوانٍ، يرتفع إلى 7 أرصدة عند 12 ثانية.

نصائح للتحكم في التكاليف في الإنتاج:

• اختبر الأوامر بمدة ثانيتين قبل الالتزام بدفعات مدتها 12 ثانية
• حدد ميزانية شهرية للرصيد واجعل الكود يتوقف عند بلوغها
• راقب حقل credits_charged في كل استجابة لتتبع الإنفاق لكل سير عمل
• استخدم الـ webhooks لتجنب إهدار الوقت في الاستعلام الدوري
• احفظ النتائج الناجحة كلما أمكن حتى لا تُعيد توليد طلبات متطابقة

أنماط التكامل الفعلية

رسوم كتالوج التجارة الإلكترونية المتحركة

شغّل مهمة Seedance 1.0 Lite في كل مرة تُضاف فيها وحدة SKU جديدة إلى كتالوجك. اكتب رابط MP4 الناتج في قاعدة بيانات منتجاتك. اعرضه تلقائياً على صفحات تفاصيل المنتج.

خط إنتاج الإعلانات

مهمة cron يومية تُنشئ 10 متغيرات إعلانية جديدة من صور مصدر مختلفة. ترفع ملفات MP4 مباشرة إلى واجهة Meta Ads البرمجية كإعلانات جديدة. تُغلق الحلقة بين توليد المحتوى وتسليم الإعلانات.

تطبيقات المحتوى الذي يُنشئه المستخدمون

دع المستخدمين يرفعون صورة في تطبيقك. تستدعي خلفيتك Seedance 1.0 Lite بأمر جاهز. أعد النسخة المتحركة للمستخدم في أقل من دقيقة. احسب رسوماً على المستخدمين تغطي تكلفة الواجهة البرمجية البالغة نحو $0.20 مع هامش ربح مناسب.

تحسين نظام إدارة المحتوى

اربط نظام إدارة المحتوى بحيث تحصل كل صورة مميزة جديدة تلقائياً على نسخة متحركة من Seedance 1.0 Lite. احفظ كلتا النسختين: الثابتة كبديل احتياطي، والمتحركة للمواضع الرئيسية.

تحديث الكتالوج الدفعي

مهمة ليلية تُعيد توليد نسخ متحركة لأفضل 500 منتج لديك بأوامر حركة موسمية. محتوى جديد دون تدخل بشري.

الترقية إلى Pro أو 2.0 عبر الواجهة البرمجية

عندما تحتاج مهمة معينة إلى جودة متميزة، غيّر نقطة النهاية:

• /seedance-1-lite/generate - $0.20-$1.00، سريع، مثالي للأحجام الكبيرة
• /seedance-1-pro/generate - $0.20-$1.00، حركة متميزة، تحكم في الإطار الأخير
• /seedance-2.0/generate - من $1.20 إلى $4.40، جودة سينمائية مع صوت أصلي

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

ابدأ التكامل اليوم

سجّل، احصل على مفتاح الواجهة البرمجية من لوحة التحكم، وأجرِ أول استدعاء باستخدام رصيدك المجاني البالغ 10. المثال بلغة Python أعلاه يعمل من البداية إلى النهاية في نحو 45 ثانية ويمنحك نمط تكامل جاهزاً للبناء عليه.

احصل على مفتاح API مجاناً → - 10 رصيد عند التسجيل، دون الحاجة إلى بطاقة ائتمان، تكامل جاهز للإنتاج في أقل من ساعة.