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 Video

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

POST

/api/v1/video/seedance

المعلمات

المعامل	النوع	مطلوب	افتراضي	القيم المسموحة
`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/seedance \
  -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"
  }'

GPT Image 2

توليد صور عالية الدقة.

POST

/api/v1/image/gpt-image-2

المعلمات

المعامل	النوع	مطلوب	افتراضي	القيم المسموحة
`type` Generation type.	`string`	مطلوب	`—`	`text-to-imageimage-to-image`
`channel` Generation channel. economy is lower-cost with polling-based delivery.	`string`	اختياري	`standard`	`standardeconomy`
`prompt` Text prompt.	`string`	مطلوب	`—`	`3–20000 chars`
`resolution` Output resolution. auto only supports 1K; 1:1 cannot use 4K on the standard channel.	`string`	مطلوب	`—`	`1K2K4K`
`aspectRatio` Aspect ratio.	`string`	مطلوب	`—`	`auto1:15:49:1621:916:94:33:24:53:42:32:11:23:11:39:21`
`batchCount` Number of images.	`integer`	اختياري	`1`	`1–4`
`imageUrls` Required for image-to-image.	`string[] (URL)`	اختياري	`—`	`1–10 public https URLs`

تقديم مهمة

bash

curl -X POST https://seedance2ai.io/api/v1/image/gpt-image-2 \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-gpt-image-001" \
  -d '{
    "type": "text-to-image",
    "prompt": "Editorial product photo of a transparent running shoe on chrome",
    "resolution": "1K",
    "aspectRatio": "1:1"
  }'

Nano Banana Pro

مخرجات صور أنيقة ومتميزة.

POST

/api/v1/image/nano-banana-pro

المعلمات

المعامل	النوع	مطلوب	افتراضي	القيم المسموحة
`type` Generation type.	`string`	مطلوب	`—`	`text-to-imageimage-to-image`
`prompt` Text prompt.	`string`	مطلوب	`—`	`3–10000 chars`
`image_size` Aspect ratio.	`string`	اختياري	`auto`	`1:19:1616:93:44:33:22:35:44:521:9auto`
`output_format` Image format.	`string`	اختياري	`png`	`pngjpeg`
`resolution` Output resolution.	`string`	اختياري	`1K`	`1K2K4K`
`image_urls` Required for image-to-image.	`string[] (URL)`	اختياري	`—`	`1–8 public https URLs`

تقديم مهمة

bash

curl -X POST https://seedance2ai.io/api/v1/image/nano-banana-pro \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-nbp-001" \
  -d '{
    "type": "text-to-image",
    "prompt": "A premium packaging mockup for an AI video studio",
    "image_size": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }'

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

استعلِم حتى اكتمال الحالة أو فشلها.

bash

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

json

{
  "id": "sd2_xxxxx",
  "status": "completed",
  "model": "seedance",
  "output": { "video_url": "https://..." },
  "credits_used": 30
}

رموز الأخطاء

كود	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 for this account.
`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.

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

استخدم مع Claude Code

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

افتح llms.txt

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

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

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

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

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

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

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

كيف أبدأ؟

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

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

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