API عام

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

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

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

في هذه الصفحة

بداية سريعة

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

استدعاء API

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

curl -X POST https://www.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"
  }'

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

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

while true; do
  TASK=$(curl -s https://www.seedance2ai.io/api/v1/tasks/sd2_xxxxx \
    -H "Authorization: Bearer $SEEDANCE_API_KEY")
  STATUS=$(echo "$TASK" | jq -r '.status')
  if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
    echo "$TASK" | jq
    break
  fi
  sleep 10
done

المصادقة

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

Base URL: https://www.seedance2ai.io/api/v1
Idempotency-Key: Send a unique value with every POST. Retrying with the same key and body within 24 hours returns the original task instead of charging for a second one.
Credits: Calls spend credits from the key owner's personal balance. Team credits are not used.
Media URLs: Reference images, videos and audio must be public HTTPS URLs that can be fetched without cookies or a login.

http

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

Seedance 2.0 Video

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

Modes: Text, image, reference media
Duration: 4 to 15 seconds
Quality tiers: mini, standard, pro
Task ID: sd2_…

تقديم مهمة

POST

/api/v1/video/seedance2

المعلمات

modestringاختياريافتراضي text-to-video
Generation mode.
text-to-videoimage-to-videomedia-to-video
quality_tierstringاختياريافتراضي standard
Quality tier.
ministandardpro
channelstringاختياريافتراضي standard
Rendering channel.
standardrealwild
promptstringمطلوب
Text prompt.
3–10000 chars
aspect_ratiostringاختياريافتراضي 16:9
Aspect ratio.
1:121:94:33:416:99:16adaptive
durationstringاختياريافتراضي 5
Clip duration.
4–15 (seconds)
resolutionstringاختياريافتراضي 720p
Output resolution. 1080p-plus and 4k are available on pro only.
720p1080p1080p-plus4k
image_urlstring (URL)اختياري
Start frame — required for image-to-video.
public https URL, ≤ 30 MB
end_image_urlstring (URL)اختياري
Optional end frame.
public https URL, ≤ 30 MB
media_urlsstring[] (URL)اختياري
Required for media-to-video. Images are limited to 30 MB; video URLs must support duration probing.
≤ 12 public https image/video URLs
generate_audiobooleanاختياريافتراضي true
Generate an audio track.
truefalse
fixed_lensbooleanاختياريافتراضي false
Lock the camera lens.
truefalse
seedintegerاختياري
Optional deterministic seed.
-1 – 4294967295

Seedance prompt guide

Seedance prompts work best as concrete director instructions. Describe the subject, action, scene, camera motion, visual style, and constraints, then map every reference asset to the right API parameter.

Use image_url for the opening frame, end_image_url for the closing frame, and media_urls for character, motion, style, source-video, or extension references.
Describe asset roles in natural language inside prompt. Do not send raw asset ids, asset:// URLs, or in-app-only labels such as @图片1.
For edits say “strictly edit the supplied source video”; for extensions say “continue from the supplied previous clip.”
For complex scenes, use ordered shots plus a style and constraint package: stable faces, natural motion, no deformation, no watermark, no logo, and no subtitles unless intended.

طلب

curl -X POST https://www.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
}

قيم credits_used المعروضة في هذه الأمثلة توضيحية. يُحسب الاستهلاك الفعلي عند الإرسال وتعيده واجهة API.

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

GET

/api/v1/tasks/{id}

status

processing: Accepted and running. Keep polling.
completed: Finished. Read output, or result_urls for a flat list of files.
failed: Ended without a result. error says why and credits_refunded shows what was returned.

Poll every 10 seconds or so and stop at completed or failed. Status reads have their own rate limit, so polling never uses up your submit budget.

طلب

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

استجابة200

json

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

Wait for the result

while true; do
  TASK=$(curl -s https://www.seedance2ai.io/api/v1/tasks/sd2_xxxxx \
    -H "Authorization: Bearer $SEEDANCE_API_KEY")
  STATUS=$(echo "$TASK" | jq -r '.status')
  if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
    echo "$TASK" | jq
    break
  fi
  sleep 10
done

Tasks and balance

Read endpoints for building a task history, showing remaining credits, or discovering models at runtime. They share the read rate limit.

List tasks

GET

/api/v1/tasks

Returns the tasks this account created through the API in the last 30 days, newest first. Each item has the same shape as a single task. Use limit (1 to 50, default 20) and pass next_cursor as before to fetch the next page.

curl "https://www.seedance2ai.io/api/v1/tasks?limit=20" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

json

{
  "data": [
    {
      "id": "sd2_xxxxx",
      "type": "video",
      "status": "completed",
      "model": "seedance2",
      "credits_used": 30,
      "result_urls": ["https://..."]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Check balance

GET

/api/v1/balance

Returns the credits the key owner can spend through the API. subscription_credits is the part that came from a plan and expires at subscription_credits_expire_at.

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

json

{
  "credits": 1200,
  "subscription_credits": 1000,
  "subscription_credits_expire_at": "2026-07-01T00:00:00.000Z"
}

List models

GET

/api/v1/models

Returns every model the API serves with its endpoint, accepted modes and task ID prefix. Useful for building a model picker without hard-coding this page.

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

json

{
  "data": [
    {
      "id": "seedance2",
      "name": "Seedance 2.0",
      "type": "video",
      "method": "POST",
      "endpoint": "/api/v1/video/seedance2",
      "modes": ["text-to-video", "image-to-video", "media-to-video"],
      "task_id_prefix": "sd2_"
    }
  ]
}

رموز الأخطاء

Every error has the same shape. Branch on code, and show message to a person. A task that was accepted can still fail later, so also check status when you poll.

json

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request body: prompt: String must contain at least 3 character(s)"
  }
}

كود	HTTP	المعنى
`unauthorized`	`401`	Missing, invalid, or revoked API key.
`invalid_request`	`400`	Bad input or unsupported field. The message names the first field that failed; details lists them all.
`purchase_required`	`403`	Seedance 2.5 requires a successful credits or plan purchase; free promotional credits alone do not unlock it. The GPT Image 2.5 economy channel has the same requirement.
`insufficient_credits`	`402`	Not enough credits. Seedance 2.5 always returns HTTP 402 with insufficient_credits; when an authoritative quote is available, it may also include required_credits, available_credits, pricing_version, and promotion_applied.
`rate_limited`	`429`	Too many requests for this account. See Rate limits below. Seedance requests that validate reference media are limited to 3 per 60 seconds per account and source IP, with a project-wide safety cap. 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.

Rate limits

A request over the limit returns HTTP 429 with a Retry-After header in seconds, plus X-RateLimit-Limit and X-RateLimit-Reset. Wait that long, then retry with the same Idempotency-Key.

Submit a job: 30 per 60 seconds; Every POST endpoint, counted per account across all of its keys.
Read: 120 per 60 seconds; Task status, task list, balance and models. Counted separately, so polling never uses up the submit budget.
Reference media validation: 3 per 60 seconds; Seedance requests that include reference media, per account and source IP.

استخدم مع Claude Code

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

افتح llms-api.txt DeepSeek Harness plugin

Skill

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

bash

# Download the one-file skill from Seedance 2.0 AI
mkdir -p ~/.claude/skills/seedance
curl --fail --location -H "Authorization: Bearer $SEEDANCE_API_KEY" https://www.seedance2ai.io/downloads/seedance-skill.md -o ~/.claude/skills/seedance/SKILL.md.tmp &&
mv ~/.claude/skills/seedance/SKILL.md.tmp ~/.claude/skills/seedance/SKILL.md

Download skill

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

من يمكنه استخدام API؟: أي شخص لديه أرصدة. لا يوجد حاجز خطة — أي حساب لديه أرصدة يمكنه إنشاء مفتاح واستدعاء API.
كيف أحصل على الرصيد؟: اشحن رصيدك أو اشترك من صفحة الأسعار. تُضاف الأرصدة إلى رصيدك فورًا.
هل يتم مشاركة الرصيد بين الموقع الإلكتروني وواجهة API؟: نعم — رصيدك الشخصي يدعم كلاً من التوليد عبر الويب واستدعاءات API. ضمن الفريق، تستخدم استدعاءات API رصيد كل عضو الشخصي، وليس الرصيد المشترك للفريق.
كيف أبدأ؟: أنشئ مفتاح API في لوحة التحكم الخاصة بك، ثم استدعِ نقاط النهاية باستخدام رمز Bearer (راجع Quickstart أعلاه).
ماذا لو أعادت مكالمة خطأ insufficient_credits؟: رصيدك فارغ — اشحن من صفحة الأسعار وحاول مجددًا.

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

بداية سريعة

إنشاء مفتاح

استدعاء API

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

المصادقة

Seedance 2.0 Video

تقديم مهمة

المعلمات

Seedance prompt guide

طلب

استجابة202

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

status

طلب

استجابة200

Wait for the result

Tasks and balance

List tasks

Check balance

List models

رموز الأخطاء

Rate limits

استخدم مع Claude Code

Skill

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