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 Video

Text, bild eller media till video.

POST

/api/v1/video/seedance

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`	`standardpro`
`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:16`
`duration` Clip duration.	`string`	Valfritt	`5`	`4–15 (seconds)`
`resolution` Output resolution.	`string`	Valfritt	`720p`	`720p1080p`
`image_url` Start frame — required for image-to-video.	`string (URL)`	Valfritt	`—`	`public https URL`
`end_image_url` Optional end frame.	`string (URL)`	Valfritt	`—`	`public https URL`
`media_urls` Required for media-to-video.	`string[] (URL)`	Valfritt	`—`	`≤ 12 public https URLs`
`generate_audio` Generate an audio track.	`boolean`	Valfritt	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	Valfritt	`false`	`truefalse`
`seed` Not supported on the real channel.	`integer`	Valfritt	`—`	`-1 – 4294967295`

Skicka in ett jobb

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

Högkvalitativ bildgenerering.

POST

/api/v1/image/gpt-image-2

Parametrar

Parameter	Typ	Obligatorisk	Standard	Tillåtna värden
`type` Generation type.	`string`	Obligatoriskt	`—`	`text-to-imageimage-to-image`
`channel` Generation channel. economy is lower-cost with polling-based delivery.	`string`	Valfritt	`standard`	`standardeconomy`
`prompt` Text prompt.	`string`	Obligatoriskt	`—`	`3–20000 chars`
`resolution` Output resolution. auto only supports 1K; 1:1 cannot use 4K on the standard channel.	`string`	Obligatoriskt	`—`	`1K2K4K`
`aspectRatio` Aspect ratio.	`string`	Obligatoriskt	`—`	`auto1:15:49:1621:916:94:33:24:53:42:32:11:23:11:39:21`
`batchCount` Number of images.	`integer`	Valfritt	`1`	`1–4`
`imageUrls` Required for image-to-image.	`string[] (URL)`	Valfritt	`—`	`1–10 public https URLs`

Skicka in ett jobb

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

Stiliserad, premium bildutdata.

POST

/api/v1/image/nano-banana-pro

Parametrar

Parameter	Typ	Obligatorisk	Standard	Tillåtna värden
`type` Generation type.	`string`	Obligatoriskt	`—`	`text-to-imageimage-to-image`
`prompt` Text prompt.	`string`	Obligatoriskt	`—`	`3–10000 chars`
`image_size` Aspect ratio.	`string`	Valfritt	`auto`	`1:19:1616:93:44:33:22:35:44:521:9auto`
`output_format` Image format.	`string`	Valfritt	`png`	`pngjpeg`
`resolution` Output resolution.	`string`	Valfritt	`1K`	`1K2K4K`
`image_urls` Required for image-to-image.	`string[] (URL)`	Valfritt	`—`	`1–8 public https URLs`

Skicka in ett jobb

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

Kontrollera uppgiftsstatus

Pollning tills statusen är slutförd eller misslyckad.

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
}

Felkoder

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

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

# Clone into Claude Code's skills folder
git clone https://github.com/tkaptop/seedance-skill ~/.claude/skills/seedance

Visa på GitHub

Använd med Claude Code

Klicka på Kopiera för att AI ska hämta hela API:t som ren Markdown, klistra in det i Claude Code eller Codex och låt den koppla ihop integrationen. Eller peka agenten direkt mot den råa text-ändpunkten.

Öppna llms.txt

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

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.