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

התחלה מהירה

1. 1

   צור מפתח

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

   ניהול מפתחות
2. 2

   קרא ל-API

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

   cURLJavaScriptPython

   Copy

   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"
     }'

3. 3

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

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

   cURLJavaScriptPython

   Copy

   while true; do
     TASK=$(curl -s https://www.seedance2ai.io/api/v1/tasks/sd2_xxxxx \
       -H "Authorization: Bearer $SEEDANCE_API_KEY")
     STATUS=$(echo "$TASK" | jq -r '.status')
     if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
       echo "$TASK" | jq
       break
     fi
     sleep 10
   done

אימות

כל בקשה מאומתת באמצעות מפתח API מסוג Bearer בכותרת Authorization.

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
Idempotency-Key: a-unique-id-per-request

Tasks and balance

Read endpoints for building a task history, showing remaining credits, or discovering models at runtime. They share the read rate limit.

curl "https://www.seedance2ai.io/api/v1/tasks?limit=20" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "data": [
    {
      "id": "sd2_xxxxx",
      "type": "video",
      "status": "completed",
      "model": "seedance2",
      "credits_used": 30,
      "result_urls": ["https://..."]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

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

{
  "credits": 1200,
  "subscription_credits": 1000,
  "subscription_credits_expire_at": "2026-07-01T00:00:00.000Z"
}

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

{
  "data": [
    {
      "id": "seedance2",
      "name": "Seedance 2.0",
      "type": "video",
      "method": "POST",
      "endpoint": "/api/v1/video/seedance2",
      "modes": ["text-to-video", "image-to-video", "media-to-video"],
      "task_id_prefix": "sd2_"
    }
  ]
}

קודי שגיאה

Every error has the same shape. Branch on code, and show message to a person. A task that was accepted can still fail later, so also check status when you poll.

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request body: prompt: String must contain at least 3 character(s)"
  }
}

Rate limits

A request over the limit returns HTTP 429 with a Retry-After header in seconds, plus X-RateLimit-Limit and X-RateLimit-Reset. Wait that long, then retry with the same Idempotency-Key.

Submit a job

30 per 60 seconds

Every POST endpoint, counted per account across all of its keys.

Read

120 per 60 seconds

Task status, task list, balance and models. Counted separately, so polling never uses up the submit budget.

Reference media validation

3 per 60 seconds

Seedance requests that include reference media, per account and source IP.

שימוש עם Claude Code

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

Skill

התקן את המיומנות Seedance ב-Claude Code, Codex או בכל סוכן — היא כותבת פרומפטים קולנועיים ומרנדרת אותם דרך ה-API עבורך.

# Download the one-file skill from Seedance 2.0 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

שאלות נפוצות

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

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

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

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

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

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

איך מתחילים?

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

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

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