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

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

وثائق Seedance API: الإنشاء والحالة و1080 بكسل والتسعير

مرجع Seedance 1.5 برو

مستندات سيدانس API

لاستخدام سيدانس API، المصادقة باستخدام مفتاح حامل، استخدم POST /seedance/generate/ لخلق فرص العمل، واستطلاع الرأي GET /seedance/status/{generation_id}/ حتى يصبح الفيديو جاهزا. يدعم UlazAI حاليًا إخراج Seedance 1.5 Pro 480p و 720p و 1080p مع فترات 4 أو 8 أو 12 ثانية.

نقاط النهاية الأساسية

POST /seedance/upload/

POST /seedance/generate/

GET /seedance/status/{generation_id}/

القدرات الحالية

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

ما يصل إلى 2 صور إرشادية

الصوت الأصلي الاختياري

نصيحة

تجيب هذه الصفحة على التدفق الكامل للمطور في الشاشة الأولى: إنشاء نقطة النهاية واستقصاء الحالة ودعم 1080 بكسل ومصادقة الحامل ومسار التسعير.

استخدم /seedance/upload/ فقط عندما تحتاج إلى إنشاء فيديو موجه بالصور. بالنسبة لعمليات التشغيل النصية فقط، اتصل /seedance/generate/ مباشرة وتخطي خطوة التحميل.

عائلة نماذج Seedance: 1.5 Pro و2.0 و2.5

Seedance هو نموذج ByteDance لتحويل النص إلى فيديو والصورة إلى الفيديو. أطلقت ByteDance أول Seedance في يونيو 2025، أطلق سراحه سيدانس 2.0 في فبراير 2026، وقد ظهر منذ ذلك الحين البذور 2.5. كل يدفع الجيل نفس الفكرة الأساسية إلى أبعد من ذلك: الحركة السينمائية، ومشاهد prompt الأقوى، والمشاهد المتعددة اللقطات، مراجع الصور والفيديو والصوت الأصلي الاختياري في عرض واحد. يغطي دليل API الدعم الحالي إصدارات Seedance دون الحاجة إلى إعداد منصة ByteDance الخاصة.

الإصدارتم إصداره بواسطة ByteDanceما يضيفه
Seedance 1.5 Pro2025تحويل النص والصورة إلى فيديو، ما يصل إلى صورتين إرشاديتين، صوت اختياري، 480p/720p/1080p. تم توصيله بـ UlazAI اليوم.
Seedance 2.0فبراير 2026المدخلات متعددة الوسائط (النص، الصورة، الفيديو، الصوت)، رواية القصص بكاميرات متعددة، التوليد المشترك للصوت الأصلي، المقاطع الأطول.
Seedance 2.52026أحدث خطوة أظهرتها ByteDance، تهدف إلى توليد أسرع ومزيد من مكاسب الجودة والتحكم.

نفس الكود، موديل أحدث

يتم إنشاء API العام UlazAI باستخدام bytedance/seedance-1.5-pro اليوم. الجزء المهم للمطورين: عند تمكين إصدار Seedance الأحدث هنا، فإنه يعيد استخدام ملف نفسه مصادقة حامل و نفسه إنشاء واستطلاع نقاط النهاية أدناه. التكامل الخاص بك لا يتغير — فقط معرف النموذج هو الذي يتغير — لذلك يمكنك البناء على هذا المرجع الآن والارتقاء بالعائلة لاحقًا.

ByteDance وARK: النموذج الرسمي، طريق واحد موحد

الناس يبحثون عن التوثيق الرسمي لـ ByteDance Seedance أو ارك سيدانس API عادةً ما يبحثون عن شيئين مختلفين: النموذج نفسه، وطريقة تسميته فعليًا. Seedance هي شركة ByteDance نموذج خاص، تم نشره من خلال محرك Volcano Engine التابع لشركة ByteDance تابوت منصة. هذا المسار يعني إعداد ARK الحساب والوصول إلى المنطقة ونقاط نهاية النموذج الخام.

تقع UlazAI أمام ذلك كطبقة API لجهة خارجية. تحصل مفتاح حامل واحد، مستضاف تحميل الصورة الخطوة، ومحفظة ائتمانية مشتركة، ومجموعة صغيرة من نقاط النهاية في هذه الصفحة - لا يوجد ARK الإعداد، ولا يوجد حل إقليمي، ولا يوجد VPN أو رقم هاتف صيني للوصول إلى النموذج. إذا بحثت على وجه التحديد تحميل صورة ARK API Seedance، المعادل هنا هو مكالمة واحدة: POST /seedance/upload/ إرجاع عنوان URL الدائم الذي قمت بإسقاطه input_urls عند الإنشاء (راجع نقطة نهاية التحميل أدناه).

تم تعيين مفاهيم ARK إلى API

إذا كنت قد قرأت بالفعل وثائق ARK الخاصة بـ ByteDance، فستكون المفردات مختلفة ولكن الخطوات هي نفسها. وهذه هي الترجمة المباشرة:

على ByteDance ARK هنا ما الذي يتغير بالنسبة لك
حساب ARK وإعداد المشروع ونقطة النهاية مفتاح حامل واحد لا توجد منصة على متن الطائرة قبل المكالمة الأولى.
قم باستضافة صورة الدليل بنفسك، وقم بتمرير عنوان URL عام POST /seedance/upload/ يمكنك إرسال الملف الخام. يمنحك الرد عنوان URL الدائم.
معرف النموذج في نص الطلب model المجال نفس الفكرة؛ يتغير المعرف فقط بين الإصدارات.
قم باستقصاء المهمة حتى تكتمل GET /seedance/status/{generation_id}/ نفس شكل الاقتراع، ونقطة نهاية واحدة.

صورة إلى فيديو في مكالمتين

هذا هو تدفق تحميل الصورة بأكمله. تقوم المكالمة الأولى بتخزين الصورة وإرجاع عنوان URL، تستخدم المكالمة الثانية عنوان URL هذا كدليل مرئي للفيديو.

صورة ثابتة تم تحميلها على اليسار تغذي سلسلة من إطارات الفيديو التي تم إنشاؤها على اليمين
# 1. upload the guide image
curl -X POST https://ulazai.com/seedance/upload/ \
  -H "Authorization: Bearer $ULAZAI_API_KEY" \
  -F "[email protected]"

# -> {"url": "https://cdn.ulazai.com/uploads/<id>.jpg"}

# 2. generate, passing that URL back in input_urls
curl -X POST https://ulazai.com/seedance/generate/ \
  -H "Authorization: Bearer $ULAZAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "slow dolly in, warm evening light",
        "input_urls": ["https://cdn.ulazai.com/uploads/<id>.jpg"],
        "resolution": "1080p"
      }'

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

ملخص التكامل السريع

مصادقة حامل المفتاح API من /dashboard/ -> مفاتيح API
معرف النموذج bytedance/seedance-1.5-pro
الفترات 4ث، 8ث، 12ث
القرارات 480p، 720p، 1080p
نسب الارتفاع 1:1, 21:9, 4:3, 3:4, 16:9, 9:16
المدخلات Prompt فقط، أو prompt بالإضافة إلى ما يصل إلى عنواني URL للصورة
تدفق الاقتراع خلق وظيفة، متجر generation_id، ثم حالة الاستطلاع حتى completed

ملخص نقطة النهاية العامة

الطريقة نقطة النهاية متى تستخدمه
بريد /seedance/upload/ قم بتحميل صورة أولاً إذا كنت تريد توجيهات تحويل الصورة إلى فيديو
بريد /seedance/generate/ قم بإنشاء مهمة إنشاء Seedance 1.5 Pro
احصل على /seedance/status/{generation_id}/ تحقق مما إذا كانت المهمة لا تزال قيد المعالجة أو مكتملة أو فاشلة

المصادقة

تتطلب جميع طلبات API رمزًا مميزًا لحاملها:

Authorization: Bearer YOUR_API_KEY

احصل على مفتاح API من لوحة المعلومات الخاصة بك أدناه مفاتيح API. إذا كنت لا تزال بحاجة إلى الاعتمادات، فانتقل إلى الحزم أولا.

بريد /seedance/upload/

تحميل الصور المدخلة لتوجيهات الصورة إلى الفيديو

قم بتحميل صورة دليل قبل الإنشاء إذا كنت تريد أن يقوم Seedance بتثبيت التركيبة أو تأطير الشخصية أو إعداد المشهد. يمنحك الرد عنوان URL الدائم لتمريره إليه input_urls.

طلب رؤوس

Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

معلمات بيانات النموذج

ملف * (ملف)

JPG أو PNG أو WebP، بحجم يصل إلى 10 ميجابايت.

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

{
  "success": true,
  "url": "https://media.ulazai.com/seedance_images/u1_abc123.jpg",
  "filename": "seedance_images/u1_abc123.jpg"
}

مثال للاستخدام (cURL)

curl -X POST https://api.ulazai.com/seedance/upload/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"
بريد /seedance/generate/

قم بإنشاء مهمة إنشاء Seedance 1.5 Pro

أرسل إما الحمولة المبسطة أدناه أو الحمولة الصريحة model زائد input تنسيق. استخدم الإصدار المبسط إذا كنت تحتاج فقط إلى مسار Seedance العام مع prompt وصور الدليل الاختيارية وإعدادات الإخراج.

نص الطلب (بسيط)

{
  "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
  "input_urls": ["https://media.ulazai.com/seedance_images/u1_abc123.jpg"],
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": "4",
  "fixed_lens": true,
  "generate_audio": false,
  "prompt_directory_optin": true
}

نص الطلب (النموذج/نمط الإدخال)

{
  "model": "bytedance/seedance-1.5-pro",
  "input": {
    "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
    "input_urls": ["https://media.ulazai.com/seedance_images/u1_abc123.jpg"],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "fixed_lens": true,
    "generate_audio": true
  }
}

حدود

prompt * (سلسلة)

من 3 إلى 2500 حرفًا تصف المشهد والحركة والتأطير والهدف الصوتي.

input_urls (صفيف)

اختياري. ما يصل إلى عنواني URL للصور لتوجيهات تحويل الصورة إلى فيديو.

aspect_ratio (سلسلة)

واحد من: 1:1، 21:9، 4:3، 3:4، 16:9، 9:16.

القرار (سلسلة)

واحدة من: 480p، 720p، 1080p.

مدة (سلسلة)

4 أو 8 أو 12 ثانية.

fixed_lens (منطقي)

تمكين لعرض الكاميرا أكثر استقرارا.

generate_audio (منطقي)

تمكين توليد الصوت المتزامن. وهذا يزيد من استخدام الائتمان.

prompt_directory_optin (منطقي)

اختياري. قم بمشاركة prompts المؤهلة في دليل prompt وقم بتطبيق خصم عندما يكون مدعومًا.

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

{
  "success": true,
  "generation_id": "abc12345-1234-1234-1234-123456789012",
  "task_id": "seedance_task_xyz789",
  "credits_used": 40,
  "directory_discount_applied": true,
  "message": "Video generation started. This may take a few minutes."
}
احصل على /seedance/status/{generation_id}/

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

استقصاء نقطة النهاية هذه حتى مغادرة الوظيفة processing. عند النجاح، يمكنك الحصول على عنوان URL للفيديو مرة أخرى؛ على الفشل يجب عليك فحص الخطأ وإعادة المحاولة باستخدام الحمولة المصححة.

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

{
  "success": true,
  "status": "processing",
  "message": "Video is being generated..."
}

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

{
  "success": true,
  "status": "completed",
  "video_url": "https://media.ulazai.com/seedance_outputs/video.mp4"
}

أمثلة التعليمات البرمجية: cURL وPython وJavaScript

يتم إرسال التدفق الكامل → المتجر generation_id → حالة الاستطلاع. إليك استدعاء الإنشاء في ثلاث مكدسات مشتركة؛ مبادلة في المفتاح الخاص بك وprompt.

الضفيرة

curl -X POST https://api.ulazai.com/seedance/generate/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": "4"
  }'

بايثون (الطلبات)

import time, requests

BASE = "https://api.ulazai.com"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

# 1. Start the job
job = requests.post(f"{BASE}/seedance/generate/", headers=HEADERS, json={
    "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": "4",
}).json()
generation_id = job["generation_id"]

# 2. Poll until it leaves "processing"
while True:
    status = requests.get(f"{BASE}/seedance/status/{generation_id}/", headers=HEADERS).json()
    if status.get("status") == "completed":
        print("Video:", status["video_url"])
        break
    if status.get("status") == "failed":
        raise RuntimeError(status)
    time.sleep(8)  # back off; do not hammer generate

جافا سكريبت (جلب)

const BASE = "https://api.ulazai.com";
const HEADERS = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" };

const job = await fetch(`${BASE}/seedance/generate/`, {
  method: "POST",
  headers: HEADERS,
  body: JSON.stringify({
    prompt: "A cinematic close-up of a chef flipping noodles in slow motion",
    aspect_ratio: "16:9",
    resolution: "1080p",
    duration: "4",
  }),
}).then(r => r.json());

const id = job.generation_id;
let video;
while (!video) {
  const s = await fetch(`${BASE}/seedance/status/${id}/`, { headers: HEADERS }).then(r => r.json());
  if (s.status === "completed") video = s.video_url;
  else if (s.status === "failed") throw new Error(JSON.stringify(s));
  else await new Promise(r => setTimeout(r, 8000));  // poll every ~8s
}
console.log("Video:", video);

تدفق الاستخدام

  1. قم بتحميل صورة دليلية واحدة أو صورتين باستخدام /seedance/upload/ فقط إذا كنت بحاجة إلى إرشادات حول تحويل الصورة إلى فيديو.
  2. اتصل /seedance/generate/ مع prompt وإعدادات الإخراج والاختيارية input_urls.
  3. تخزين عاد generation_id.
  4. استطلاع /seedance/status/{generation_id}/ حتى status يصبح completed.
  5. استخدم العائد video_url لتنزيل الأصل النهائي أو تضمينه أو تمريره إلى سير العمل الخاص بك.

رموز الخطأ

400 معلمات الطلب غير صالحة

401 فشلت المصادقة (مفتاح API مفقود أو غير صالح)

402 الاعتمادات غير كافية

429 تم تجاوز الحد الأقصى للسعر

500 خطأ داخلي في الخادم

حدود الأسعار والسعر

تعمل الفواتير الأولية على UlazAI على الاعتمادات، لذا فإن مقاييس التكلفة مع الدقة والمدة بدلاً من معدل ثابت لكل ثانية. استخدم هذا كدليل للتخطيط؛ تظهر تكلفة الائتمان المباشر في الحزم وفي وقت الطلب.

الإخراجالاستخدام النموذجيسائق التكلفة
480pالمسودات والتكرارات السريعةأدنى الاعتمادات في الثانية الواحدة
720pمقاطع اجتماعية جاهزةمنتصف الاعتمادات في الثانية الواحدة
1080pالتسليم النهائيأعلى الاعتمادات في الثانية الواحدة؛ فترات أطول تكلف أكثر

حدود المعدل والتعامل مع 429: إذا قمت بتقديم العديد من الوظائف بالتوازي فقد تحصل عليها 429 Rate limit exceeded. تعامل مع API على أنه يعتمد على الوظيفة: قم بإرسال وتخزين generation_id، والاستطلاع /seedance/status/{generation_id}/ كل 5-10 ثواني بدلا من توليد الطرق. على أ 429، تراجع بشكل كبير (على سبيل المثال 2 ثانية، 4 ثانية، 8 ثانية) قبل إعادة المحاولة.

Seedance 1.5 Pro مقابل Seedance 2.0: يغطي هذا المرجع bytedance/seedance-1.5-pro، النموذج متصل حاليًا بـ Video Studio. منذ ذلك الحين، قدمت ByteDance Seedance 2.0 باعتباره الجيل التالي؛ عندما يتم تمكينه هنا، فإنه يستخدم نفس تدفق التوليد والاستقصاء ونفس المصادقة، لذلك لا يتغير رمز التكامل - فقط معرف النموذج هو الذي يتغير.

الأسئلة المتداولة

هل يدعم UlazAI Seedance API Seedance 2.0 و2.5؟

يتم إنشاء API باستخدام bytedance/seedance-1.5-pro اليوم. أصدرت ByteDance Seedance 2.0 في فبراير 2026 ومنذ ذلك الحين أنتجت 2.5. عند تمكين إصدار أحدث هنا، فإنه يستخدم نفس مصادقة Bearer ونفس نقاط نهاية الإنشاء والاستقصاء، لذلك لا يتغير رمز التكامل الخاص بك - فقط معرف النموذج هو الذي يتغير.

كيف يرتبط UlazAI بـ Seedance / ARK API الرسمي من ByteDance؟

Seedance هو نموذج ByteDance الخاص، ويتم تقديمه من خلال منصة Volcano Engine ARK الخاصة بـ ByteDance. UlazAI عبارة عن طبقة API تابعة لجهة خارجية تقوم بتشغيل Seedance خلف مسار واحد مبسط باستخدام مفتاح Bearer واحد، وتحميل صورة مستضافة، ومحفظة ائتمانية مشتركة - لا يوجد حساب ARK أو نقاط نهاية نموذج أولية لإدارتها.

كيف يمكنني تحميل صورة لتحويل صورة إلى فيديو من Seedance؟

أرسل الصورة كبيانات متعددة الأجزاء/نموذج إلى POST /seedance/upload/ مع مفتاح الحامل الخاص بك. تقوم الاستجابة بإرجاع عنوان URL دائم؛ مررها (ما يصل إلى اثنين) في input_urls مصفوفة على POST /seedance/generate/. تتخطى ملفات prompt النصية فقط خطوة التحميل.

كم تبلغ تكلفة Seedance API؟

يتم تشغيل الفواتير على أساس الاعتمادات، لذا يتم قياس التكلفة مع الدقة والمدة. تكلف المسودة القصيرة بدقة 480 بكسل أقل عدد من الاعتمادات؛ عرض 1080 بكسل مدته 12 ثانية مع الصوت هو الأكثر تكلفة. تظهر التكلفة الدقيقة في الحزم ومرة أخرى كما credits_used في توليد الاستجابة.

هل Seedance متاح في جميع أنحاء العالم من خلال API؟

نعم. يمكنك الاتصال بنقاط نهاية HTTPS المستضافة لـ UlazAI باستخدام مفتاح Bearer، لذلك ليست هناك حاجة إلى VPN أو حل إقليمي أو رقم هاتف صيني. يمكن لأي خادم يمكنه تقديم طلب HTTPS مصادق عليه إرسال المهام واستطلاع النتائج.

أين تذهب بعد ذلك