واجهة برمجة Seedance 2.0 Fast: نقطة نهاية توليد الفيديو بتكلفة منخفضة

طلب HTTP واحد، مقطع فيديو سينمائي بالذكاء الاصطناعي، بتكلفة $1.94. هذه هي اقتصاديات الوحدة عند البناء على واجهة برمجة تطبيقات Seedance 2.0 Fast. نقاط نهاية مخصصة لتحويل النص إلى فيديو والصورة إلى فيديو، وتسعير محدد مسبقاً، ومحرك جودة مطابق لـ Seedance 2.0 القياسي، مع ميزة تكلفة تبلغ ~20% تُحدث فارقاً حقيقياً عند العمل على نطاق واسع.

إليك الدليل الكامل للمطورين.

ملخص سريع

• نقاط النهاية: bytedance/seedance-2.0/fast/text-to-video و fast/image-to-video
• التكلفة: $0.2419 لكل ثانية، أو 10-55 كريدت لكل مقطع ($1.00-$5.50)
• الاستجابة: معرّف مهمة غير متزامن، استطلع الحالة حتى الاكتمال، ثم نزّل ملف MP4
• المصادقة: مفتاح API من لوحة تحكم Arteza
• السرعة: 30-150 ثانية لكل عملية توليد

ما الغرض من Fast API

إذا كنت تبني تطبيقاً أو أداةً أو خدمةً تُولّد فيديو للمستخدمين، سواء كانت جدولة منشورات اجتماعية، أو منصة أتمتة تسويقية، أو محرك محتوى للتجارة الإلكترونية، أو أداة إبداعية داخلية، فإن Seedance 2.0 Fast API هي أرخص نقطة نهاية سينمائية يمكنك البناء عليها في 2026.

جودة بصرية مطابقة لـ Seedance 2.0 القياسي. تكلفة أقل لكل ثانية. إنتاجية حوسبة أعلى. مصممة للتكامل في سير العمل التي تُنتج الفيديو بكميات كبيرة.

المستخدم المستهدف النموذجي هو مطور أو فريق يحتاج إلى توليد فيديو برمجياً بناءً على مدخلات المستخدم، وليس منشئ محتوى فردي يُنتج مقطعاً واحداً في كل مرة عبر الواجهة.

نقطتا النهاية

نقطة نهاية النص إلى فيديو:

POST https://arteza.ai/api/v1/bytedance/seedance-2.0/fast/text-to-video

تُولّد فيديو من نص وصفي. لا حاجة إلى صورة مصدر.

نقطة نهاية الصورة إلى فيديو:

POST https://arteza.ai/api/v1/bytedance/seedance-2.0/fast/image-to-video

تُولّد فيديو انطلاقاً من صورة مصدر مرفوعة مع نص وصفي للحركة.

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

المصادقة

يحتاج كل طلب إلى مفتاح API في رأس Authorization. أنشئ مفتاحاً من لوحة تحكم Arteza.

Authorization: Bearer YOUR_API_KEY

المفاتيح مرتبطة بحسابك وتسحب من رصيد الكريدت الخاص بك. يمكنك تدويرها عند الحاجة من لوحة التحكم.

تنسيق الطلب: النص إلى فيديو

POST /api/v1/bytedance/seedance-2.0/fast/text-to-video
{
  "prompt": "Slow dolly in on a ceramic coffee cup on a wooden cafe table, morning window light, shallow depth of field, cinematic 35mm film look",
  "duration": 5,
  "aspect_ratio": "16:9"
}

المعاملات:

• prompt (مطلوب، نص): النص الوصفي الذي يصف الفيديو المطلوب.
• duration (مطلوب، عدد صحيح): مدة المقطع بالثواني. النطاق: 4-15.
• aspect_ratio (مطلوب، نص): أحد القيم "16:9" أو "9:16" أو "1:1".

تنسيق الطلب: الصورة إلى فيديو

POST /api/v1/bytedance/seedance-2.0/fast/image-to-video
{
  "image_url": "https://your-cdn.com/source-image.jpg",
  "prompt": "Slow push in with shallow depth of field, cinematic 35mm film look",
  "duration": 5,
  "aspect_ratio": "16:9"
}

المعاملات:

• image_url (مطلوب، نص): رابط URL متاح للعموم للصورة المصدر. الصيغ المدعومة: JPG، PNG، WebP.
• prompt (مطلوب، نص): نص وصفي للحركة يصف كيفية تحريك الصورة.
• duration (مطلوب، عدد صحيح): مدة المقطع بالثواني. النطاق: 4-15.
• aspect_ratio (مطلوب، نص): يُفضَّل أن يتطابق مع نسبة أبعاد الصورة المصدر للحصول على أفضل النتائج.

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

تُعيد نقطتا النهاية معرّف مهمة غير متزامن:

{
  "job_id": "sdf_2026_abc123xyz",
  "status": "queued",
  "estimated_seconds": 45,
  "cost_credits": 242
}

استطلع نقطة نهاية الحالة حتى تكتمل المهمة:

GET /api/v1/jobs/sdf_2026_abc123xyz

استجابة الاكتمال:

{
  "job_id": "sdf_2026_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/output/sdf_2026_abc123xyz.mp4",
  "duration_seconds": 5,
  "resolution": "720p",
  "credits_consumed": 242
}

نزّل video_url وستحصل على ملف MP4 الخاص بك.

مثال Python كامل

import requests
import time

API_KEY = "your_api_key_here"
BASE_URL = "https://arteza.ai/api/v1"

def generate_fast_video(prompt, duration=5, aspect_ratio="16:9"):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    
    # إرسال مهمة التوليد
    response = requests.post(
        f"{BASE_URL}/bytedance/seedance-2.0/fast/text-to-video",
        headers=headers,
        json={
            "prompt": prompt,
            "duration": duration,
            "aspect_ratio": aspect_ratio
        }
    )
    job = response.json()
    job_id = job["job_id"]
    print(f"Job queued: {job_id}, estimated {job['estimated_seconds']}s")
    
    # استطلاع حتى الاكتمال
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Complete: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generation failed: {status.get('error')}")
        else:
            print(f"Status: {status['status']}")

# الاستخدام
video_url = generate_fast_video(
    "Slow tracking shot of a golden retriever running through autumn leaves, golden hour, cinematic 35mm film look",
    duration=5,
    aspect_ratio="16:9"
)

مثال JavaScript كامل

const API_KEY = 'your_api_key_here';
const BASE_URL = 'https://arteza.ai/api/v1';

async function generateFastVideo(prompt, duration = 5, aspectRatio = '16:9') {
  const headers = {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  };

  // إرسال مهمة التوليد
  const submitRes = await fetch(
    `${BASE_URL}/bytedance/seedance-2.0/fast/text-to-video`,
    {
      method: 'POST',
      headers,
      body: JSON.stringify({ prompt, duration, aspect_ratio: aspectRatio })
    }
  );
  const job = await submitRes.json();
  console.log(`Job queued: ${job.job_id}`);

  // استطلاع حتى الاكتمال
  while (true) {
    await new Promise(r => setTimeout(r, 10000));
    const statusRes = await fetch(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers }
    );
    const status = await statusRes.json();

    if (status.status === 'completed') {
      return status.video_url;
    } else if (status.status === 'failed') {
      throw new Error(`Generation failed: ${status.error}`);
    }
  }
}

// الاستخدام
const videoUrl = await generateFastVideo(
  'Slow dolly in on a matcha latte in a ceramic cup, morning window light, cinematic 35mm',
  5,
  '9:16'
);

هل أنت مستعد للبناء على API؟ احصل على مفتاح API الخاص بك →

التسعير لكل استدعاء API

كل استدعاء API يخصم كريدتات من رصيدك بناءً على المدة:

الكريدت لا تنتهي صلاحيتها. اشترِ بالجملة عبر مستويات الاعتمادات للحصول على اقتصاديات أفضل لكل استدعاء، إذ يخفّض مستوى Enterprise التكلفة الفعلية بنسبة ~17%.

حدود المعدل والإنتاجية

تتيح Seedance 2.0 Fast API إرسال مهام متزامنة ضمن حدود معقولة. يمكن للحسابات العادية إرسال 5-10 مهام بالتوازي دون الوصول إلى حدود التقييد. يمكن لحسابات مستوى Enterprise طلب تزامن أعلى.

تستغرق مهام التوليد الفردية 30-150 ثانية بحسب المدة. مع 5 مهام متزامنة، يمكنك فعلياً إنتاج مقطع كل ~15-30 ثانية من الوقت الفعلي.

لتوليد الدُفعات الكبيرة (50 مقطعاً أو أكثر)، أرسل على شكل موجات من 5-10 مهام، انتظر الاكتمال، ثم أرسل الموجة التالية. لا تُغرق API بمئات الطلبات المتزامنة.

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

استجابات الخطأ الشائعة:

400 طلب غير صالح: معاملات غير صحيحة. تحقق من نطاق المدة وقيم نسبة الأبعاد وطول النص الوصفي.

401 غير مصرح: مفتاح API مفقود أو غير صالح.

402 دفع مطلوب: رصيد كريدت غير كافٍ. أضف رصيداً عبر لوحة التحكم.

429 طلبات كثيرة جداً: تجاوز حد المعدل. تراجع وأعد المحاولة.

500 خطأ داخلي في الخادم: مشكلة مؤقتة في الخادم. أعد المحاولة مع تراجع أسي.

ابنِ تكاملك ليتعامل مع 429 و500 بسلاسة مع منطق إعادة المحاولة. التراجع الأسي البسيط (1 ثانية، 2 ثانية، 4 ثوانٍ، 8 ثوانٍ) يغطي معظم الأعطال العابرة.

Fast مقابل القياسي في سياق API

الاختيار بين نقطتَي نهاية Fast والقياسي يعتمد في معظمه على الجانب الاقتصادي:

• استخدم Fast للتوليد البرمجي بحجم كبير، والتطبيقات الحساسة للتكلفة، وكل ما ليس مقطعاً رئيسياً.
• استخدم القياسي للمحتوى الرئيسي حيث تبرر الميزة الطفيفة في الجودة علاوة التكلفة البالغة 20%.

معظم التطبيقات تعتمد Fast افتراضياً. نقطة النهاية القياسية محجوزة عادةً لميزات "المستوى المميز" أو طلبات المستخدمين المحددة.

روابط نقاط النهاية:

• Fast نص: bytedance/seedance-2.0/fast/text-to-video
• Fast صورة: bytedance/seedance-2.0/fast/image-to-video
• قياسي نص: bytedance/seedance-2.0/text-to-video
• قياسي صورة: bytedance/seedance-2.0/image-to-video

دعم Webhook

للمهام طويلة الأمد، يُعدّ الاستطلاع مُضيّعةً للموارد. تدعم Seedance 2.0 Fast API استدعاءات webhook، أضف webhook_url في هيئة طلبك وستتلقى طلب POST عند اكتمال المهمة:

POST /api/v1/bytedance/seedance-2.0/fast/text-to-video
{
  "prompt": "...",
  "duration": 5,
  "aspect_ratio": "16:9",
  "webhook_url": "https://your-app.com/api/seedance-callback"
}

تتلقى نقطة نهاية webhook الخاصة بك نفس حمولة JSON التي ستُعيدها نقطة نهاية الحالة عند الاكتمال. طبّق مبدأ الأثر الواحد، إذ يمكن لـ webhook إعادة المحاولة عند الفشل.

أسئلة شائعة وإجابات سريعة

ما الحد الأقصى للمهام المتزامنة التي يمكنني إرسالها؟ الحسابات العادية: 5-10. Enterprise: قابل للتفاوض.

هل تُخصم الكريدت على المهام الفاشلة؟ لا. تُعاد الكريدت تلقائياً للمهام الفاشلة.

هل يمكنني إلغاء مهمة قيد التنفيذ؟ نعم، عبر POST /api/v1/jobs/{job_id}/cancel. تُعاد الكريدت إذا تم الإلغاء قبل الاكتمال.

ما تنسيق ملف الإخراج؟ MP4، فيديو H.264، صوت AAC، دقة 720p.

كم تبقى روابط الإخراج صالحة؟ روابط CDN للإخراج صالحة لمدة 7 أيام. نزّلها واحفظها في نظامك الخاص للاستخدام طويل الأمد.

هل يوجد وضع اختبار/بيئة تجريبية؟ لا توجد بيئة تجريبية مخصصة. استخدم كريدت 10 المجاني عند التسجيل للاختبار. خطة Starter بـ $5 هي أيضاً طريقة منخفضة المخاطر للبناء على نقاط النهاية الحقيقية.

ابدأ البناء على Seedance 2.0 Fast API

واجهة API مصممة بتعمّد لتكون بسيطة: نقطتا نهاية، وتسعير محدد مسبقاً، ونموذج مهام غير متزامن، وسقف جودة يضاهي مستوى Seedance 2.0 الرئيسي. ابنِ عليها لأدوات التواصل الاجتماعي، وأتمتة التسويق، ومنصات المنشئين، ومحركات محتوى التجارة الإلكترونية، أو التطبيقات الإبداعية الداخلية. اقتصاديات الوحدة أصبحت أخيراً تجعل توليد الفيديو ممكناً كميزة داخل منتجات أخرى.

هل أنت مستعد للبناء؟ احصل على مفتاح API الخاص بك →

تابع القراءة: الدليل الكامل لـ Seedance 2.0 Fast • أسعار Seedance 2.0 Fast • الإنشاء الدفعي في Seedance 2.0 Fast