API ציבורי

צור סרטונים ותמונות מהכלים שלך

צור מפתח, קרא ל-API עם אימות Bearer, ובדוק את סטטוס המשימה עד שהתוצאה מוכנה. עובד עם Claude Code, Codex וכל לקוח HTTP.

ניהול מפתחות

התחלה מהירה

שלב 1

צור מפתח

צור מפתח API בלוח הבקרה שלך. הוא מוצג פעם אחת בלבד, לכן שמור אותו במקום בטוח.

שלב 2

קרא ל-API

שלח בקשת POST עם מפתח ה-Bearer שלך וכותרת Idempotency-Key.

שלב 3

בדוק את התוצאה

בצע פולינג לנקודת הקצה של סטטוס המשימה עד שהסטטוס יהיה completed או failed, ולאחר מכן קרא את הפלט.

אימות

כל בקשה מאומתת באמצעות מפתח 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?

כן — יתרת הקרדיטים האישית שלך משמשת גם ליצירה בדפדפן (web generation) וגם לקריאות API. בצוות, קריאות API מתבצעות מהיתרה האישית של כל חבר, ולא ממאגר הקרדיטים המשותף של הצוות.

איך מתחילים?

צור מפתח API בלוח הבקרה שלך, ולאחר מכן גש לנקודות הקצה באמצעות טוקן Bearer (ראה Quickstart למעלה).

מה אם קריאה מחזירה insufficient_credits?

יתרתך ריקה — השלם יתרה בדף התמחור ונסה שוב.