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`	`ministandardpro`
`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:16adaptive`
`duration` Clip duration.	`string`	اختياري	`5`	`4–15 (seconds)`
`resolution` Output resolution. 1080p-plus and 4k are available on pro only.	`string`	اختياري	`720p`	`720p1080p1080p-plus4k`
`image_url` Start frame — required for image-to-video.	`string (URL)`	اختياري	`—`	`public https URL, ≤ 30 MB`
`end_image_url` Optional end frame.	`string (URL)`	اختياري	`—`	`public https URL, ≤ 30 MB`
`media_urls` Required for media-to-video. Images are limited to 30 MB; video URLs must support duration probing.	`string[] (URL)`	اختياري	`—`	`≤ 12 public https image/video URLs`
`generate_audio` Generate an audio track.	`boolean`	اختياري	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	اختياري	`false`	`truefalse`
`seed` Optional deterministic seed.	`integer`	اختياري	`—`	`-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.

طلب

bash

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}

طلب

bash

curl https://www.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",
  "resolution": "720p",
  "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.
`purchase_required`	`403`	Seedance 2.5 requires a successful credits or plan purchase; free promotional credits alone do not unlock it.
`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 — the general limit is 30 requests per 60 seconds per account; 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.

استخدم مع 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 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؟

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