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

לחץ על 'העתק' כדי שה-AI ייקח את ה-API המלא כ-Markdown נקי, הדבק אותו ב-Claude Code או ב-Codex, ותן לו לחבר את האינטגרציה. או כוון את הסוכן ישירות לנקודת הקצה של טקסט גולמי.

פתח llms.txt

שאלות נפוצות

מי יכול להשתמש ב-API?

כל מי שיש לו קרדיטים. אין חסם תוכנית — כל חשבון שיש לו קרדיטים יכול ליצור מפתח ולהפעיל את ה-API.

איך משיגים קרדיטים?

הטען או הירשם בדף המחירים. הקרדיטים מתווספים ליתרה שלך מיד.

האם הקרדיטים משותפים בין האתר ל-API?

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

איך מתחילים?

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

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

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