API عام

أنشئ فيديوهات وصورًا من أدواتك الخاصة

أنشئ مفتاحًا، واستدعِ واجهة API باستخدام مصادقة Bearer، وتابع حالة المهمة حتى تصبح نتيجتك جاهزة. يعمل مع Claude Code وCodex وأي عميل HTTP.

إدارة المفاتيح

بداية سريعة

الخطوة 1

إنشاء مفتاح

أنشئ مفتاح API في لوحة التحكم الخاصة بك. يُعرض مرة واحدة فقط، لذا احفظه في مكان آمن.

الخطوة 2

استدعاء API

أرسل طلب POST مع مفتاح Bearer الخاص بك ورأس Idempotency-Key.

الخطوة 3

الاستعلام عن النتيجة

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

المصادقة

يتم توثيق كل طلب باستخدام مفتاح API من نوع Bearer في رأس Authorization.

http

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
Idempotency-Key: a-unique-id-per-request

Seedance 2 Video

نص، صورة، أو وسائط إلى فيديو.

تقديم مهمة

POST

/api/v1/video/seedance2

المعلمات

المعامل	النوع	مطلوب	افتراضي	القيم المسموحة
`mode` Generation mode.	`string`	اختياري	`text-to-video`	`text-to-videoimage-to-videomedia-to-video`
`quality_tier` Quality tier.	`string`	اختياري	`standard`	`standardpro`
`channel` Rendering channel.	`string`	اختياري	`standard`	`standardrealwild`
`prompt` Text prompt.	`string`	مطلوب	`—`	`3–10000 chars`
`aspect_ratio` Aspect ratio.	`string`	اختياري	`16:9`	`1:121:94:33:416:99:16`
`duration` Clip duration.	`string`	اختياري	`5`	`4–15 (seconds)`
`resolution` Output resolution.	`string`	اختياري	`720p`	`720p1080p`
`image_url` Start frame — required for image-to-video.	`string (URL)`	اختياري	`—`	`public https URL`
`end_image_url` Optional end frame.	`string (URL)`	اختياري	`—`	`public https URL`
`media_urls` Required for media-to-video.	`string[] (URL)`	اختياري	`—`	`≤ 12 public https URLs`
`generate_audio` Generate an audio track.	`boolean`	اختياري	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	اختياري	`false`	`truefalse`
`seed` Not supported on the real channel.	`integer`	اختياري	`—`	`-1 – 4294967295`

طلب

bash

curl -X POST https://seedance2ai.io/api/v1/video/seedance2 \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-video-001" \
  -d '{
    "mode": "text-to-video",
    "quality_tier": "standard",
    "prompt": "A cinematic shot of a glass train crossing a snowy mountain bridge",
    "aspect_ratio": "16:9",
    "duration": "5",
    "resolution": "720p"
  }'

استجابة202

json

{
  "id": "sd2_xxxxx",
  "status": "processing",
  "model": "seedance2",
  "quality_tier": "standard",
  "channel": "standard",
  "credits_used": 30
}

فحص حالة المهمة

GET

/api/v1/tasks/{id}

طلب

bash

curl https://seedance2ai.io/api/v1/tasks/sd2_xxxxx \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

استجابة200

json

{
  "id": "sd2_xxxxx",
  "status": "completed",
  "model": "seedance2",
  "quality_tier": "standard",
  "channel": "standard",
  "credits_used": 30,
  "credits_refunded": 0,
  "output": {
    "video_url": "https://...",
    "last_frame_url": "https://...",
    "seed": 123
  },
  "error": null,
  "created_at": "2026-06-03T10:00:00.000Z",
  "updated_at": "2026-06-03T10:03:12.000Z"
}

status: processing · completed · failed

رموز الأخطاء

All errors share this shape:

json

{ "error": { "code": "invalid_request", "message": "Invalid request body" } }

كود	HTTP	المعنى
`unauthorized`	`401`	Missing, invalid, or revoked API key.
`invalid_request`	`400`	Bad input or unsupported field.
`insufficient_credits`	`402`	Not enough credits on the balance.
`rate_limited`	`429`	Too many requests — limit is 30 requests per 60 seconds per account. Retry after the Retry-After response header (in seconds).
`idempotency_conflict`	`409`	Same Idempotency-Key reused with a different body, or still running.
`service_busy`	`503`	Temporary upstream or credit-concurrency issue. Retry.
`not_found`	`404`	Task does not exist or does not belong to this key owner.
`internal_error`	`500`	Unexpected server-side failure.

استخدم مع Claude Code

انقر على زر النسخ ليحصل الذكاء الاصطناعي على واجهة API كاملة بصيغة Markdown نظيفة، ثم ألصقها في Claude Code أو Codex ودعها تقوم بتوصيل التكامل. أو وجّه الوكيل مباشرة إلى نقطة النهاية للنص الخام.

افتح llms.txt

Skill

ثبّت مهارة Seedance في Claude Code أو Codex أو أي وكيل — فهي تكتب أوامر سينمائية وتولّدها لك عبر API.

bash

# Clone into Claude Code's skills folder
git clone https://github.com/tkaptop/seedance-skill ~/.claude/skills/seedance

عرض على GitHub

الأسئلة الشائعة

من يمكنه استخدام API؟

أي شخص لديه أرصدة. لا يوجد حاجز خطة — أي حساب لديه أرصدة يمكنه إنشاء مفتاح واستدعاء API.

كيف أحصل على الرصيد؟

اشحن رصيدك أو اشترك من صفحة الأسعار. تُضاف الأرصدة إلى رصيدك فورًا.

هل يتم مشاركة الرصيد بين الموقع الإلكتروني وواجهة API؟

نعم — رصيد اعتمادك الشخصي يدعم كلاً من التوليد عبر الويب واستدعاءات API. ضمن الفريق، تستخدم استدعاءات API رصيد كل عضو الشخصي، وليس الرصيد المشترك للفريق.

كيف أبدأ؟

أنشئ مفتاح API في لوحة التحكم الخاصة بك، ثم استدعِ نقاط النهاية باستخدام رمز Bearer (راجع Quickstart أعلاه).

ماذا لو أعادت مكالمة خطأ insufficient_credits؟

رصيدك فارغ — اشحن من صفحة الأسعار وحاول مجددًا.