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`	`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

לחץ על 'העתק' כדי שה-AI ייקח את ה-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?

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

איך מתחילים?

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

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

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