Publikt API

Skapa video och bilder med dina egna verktyg

Skapa en nyckel, anropa API:t med Bearer-autentisering och polla uppgiftsstatus tills ditt resultat är klart. Fungerar med Claude Code, Codex och valfri HTTP-klient.

Hantera nycklar

Snabbstart

Steg 1

Skapa en nyckel

Skapa en API-nyckel i din dashboard. Den visas en gång, så förvara den på en säker plats.

Steg 2

Anropa API

Skicka en POST-förfrågan med din Bearer-nyckel och en Idempotency-Key-header.

Steg 3

Avfråga resultatet

Polla statusändpunkten för uppgiften tills status är slutförd eller misslyckad, läs sedan utdata.

Autentisering

Varje begäran autentiseras med en Bearer API-nyckel i Authorization-headern.

http

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

Seedance 2 Video

Text, bild eller media till video.

Skicka in ett jobb

POST

/api/v1/video/seedance2

Parametrar

Parameter	Typ	Obligatorisk	Standard	Tillåtna värden
`mode` Generation mode.	`string`	Valfritt	`text-to-video`	`text-to-videoimage-to-videomedia-to-video`
`quality_tier` Quality tier.	`string`	Valfritt	`standard`	`ministandardpro`
`channel` Rendering channel.	`string`	Valfritt	`standard`	`standardrealwild`
`prompt` Text prompt.	`string`	Obligatoriskt	`—`	`3–10000 chars`
`aspect_ratio` Aspect ratio.	`string`	Valfritt	`16:9`	`1:121:94:33:416:99:16adaptive`
`duration` Clip duration.	`string`	Valfritt	`5`	`4–15 (seconds)`
`resolution` Output resolution. 1080p-plus and 4k are available on pro only.	`string`	Valfritt	`720p`	`720p1080p1080p-plus4k`
`image_url` Start frame — required for image-to-video.	`string (URL)`	Valfritt	`—`	`public https URL, ≤ 30 MB`
`end_image_url` Optional end frame.	`string (URL)`	Valfritt	`—`	`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)`	Valfritt	`—`	`≤ 12 public https image/video URLs`
`generate_audio` Generate an audio track.	`boolean`	Valfritt	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	Valfritt	`false`	`truefalse`
`seed` Optional deterministic seed.	`integer`	Valfritt	`—`	`-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.

Begäran

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

Svar202

json

{
  "id": "sd2_xxxxx",
  "status": "processing",
  "model": "seedance2",
  "quality_tier": "standard",
  "channel": "standard",
  "credits_used": 30
}

Värdena för credits_used i dessa exempel är endast illustrativa. Den faktiska förbrukningen beräknas vid skickandet och returneras av API:et.

Kontrollera uppgiftsstatus

GET

/api/v1/tasks/{id}

Begäran

bash

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

Svar200

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

Felkoder

All errors share this shape:

json

{ "error": { "code": "invalid_request", "message": "Invalid request body" } }

Kod	HTTP	Betydelse
`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.

Använd med Claude Code

Använd Copy for AI för att exportera hela API:t som ren Markdown, klistra in det i Claude Code eller Codex och låt agenten koppla ihop integrationen. Eller peka agenten direkt mot råtext-endpointen.

Öppna llms-api.txt DeepSeek Harness plugin

Skill

Installera Seedance-skillen i Claude Code, Codex eller vilken agent som helst — den skriver filmiska prompts och renderar dem via API:et åt dig.

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

Ladda ner skill

Vanliga frågor

Vem kan använda API:et?

Alla med krediter. Det finns ingen planbegränsning — alla konton med krediter kan skapa en nyckel och anropa API:et.

Hur får jag krediter?

Ladda på eller prenumerera på prissidan. Krediterna läggs till ditt saldo omedelbart.

Delas krediter mellan webbplatsen och API:et?

Ja — din personliga kreditbalans används både för din webbgenerering och dina API-anrop. I ett team använder API-anrop varje medlems egen personliga balans, inte den gemensamma team-potten.

Hur börjar jag?

Skapa en API-nyckel i din dashboard och anropa sedan endpoints med en Bearer-token (se Quickstart ovan).

Vad händer om ett anrop returnerar insufficient_credits?

Ditt saldo är tomt — fyll på via prissidan och försök igen.