Instruktioner för integration av SeeDance Videos Generation API

Den här artikeln introducerar en typ av integrationsinstruktioner för SeeDance Videos Generation API, som kan generera officiella videor från SeeDance genom att ange anpassade parametrar.

Ansökningsprocess

För att använda SeeDance Videos Generation API, gå först till Ace Data Cloud-konsolen för att hämta din API Token och spara den för senare användning.

Om du ännu inte har loggat in eller registrerat dig kommer du automatiskt att omdirigeras till inloggningssidan där du uppmanas att registrera dig och logga in. När detta är klart återvänder du automatiskt till den aktuella sidan. En API Token kan anropa alla tjänster på plattformen, och behöver inte ansökas om separat för varje tjänst. Vid första ansökan får du en gratis kvot för kostnadsfri testning; när kvoten är otillräcklig kan du fylla på det gemensamma saldot i konsolen.

📘 Fullständig dokumentation: SeeDance Videos Generation API →

Grundläggande användning

Börja med att förstå det grundläggande användningssättet: ange prompten content.text, typen content.type=text samt modellen model, så kan du få det bearbetade resultatet. Det specifika innehållet är följande:

Här kan vi se att vi har angett Request Headers, inklusive:

accept: vilket format på svarsresultatet som ska tas emot, här anges application/json, det vill säga JSON-format.
authorization: nyckeln för att anropa API:t, som kan väljas direkt i rullgardinsmenyn efter ansökan.

Dessutom har vi angett Request Body, inklusive:

model: modellen för att generera videon.
- Seedance 1.x-serien: doubao-seedance-1-0-pro-250528, doubao-seedance-1-0-pro-fast-251015, doubao-seedance-1-5-pro-251215, doubao-seedance-1-0-lite-t2v-250428, doubao-seedance-1-0-lite-i2v-250428.
- Seedance 2.0-serien (stöder multimodala referenser för karaktärer samt ljud och video): doubao-seedance-2-0-260128 (standard), doubao-seedance-2-0-fast-260128 (snabb), doubao-seedance-2-0-mini-260615 (lättviktig).
- Seedance 2.5: doubao-seedance-2-5-260628, stöder upp till 30 sekunder, rena ljudreferenser, fler material, videoredigering och förlängning.
content: inmatningsinnehållsarray, type kan vara text (prompt), image_url (referensbild), audio_url (referensljud), video_url (referensvideo). Bilder kan ange användningsområde via role: first_frame (första bildrutan) / last_frame (sista bildrutan) / reference_image (referens för karaktär / motiv).
resolution: utdataupplösning, valbart 480p / 720p / 1080p / 4k. 2.5 stöder 480p, 720p och 1080p; 2.0 Fast/Mini stöder 480p och 720p; 2.0 Standard stöder upp till 4k.
ratio: bildförhållande, valbart 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive.
duration: videolängd (sekunder, heltal). 1.0-serien 2–12; 1.5 Pro 4–12; 2.0-serien 4–15; 2.5 4–30. 1.5/2.x stöder -1 (automatisk längd).
seed: slumpmässigt frö, heltal, -1 till 4294967295.
camerafixed: om kameran ska vara fast, true / false.
watermark: om vattenstämpel ska läggas till, true / false.
generate_audio: om video med ljud ska genereras, true / false, stöds av Seedance 1.5 Pro och 2.x-serien.
return_last_frame: om bild-URL:en för videons sista bildruta ska returneras i resultatet.
omni_reference_task_type: endast 2.5; auto / reference / edit / extend.
output_format: endast 2.5; mp4 / mov, standard är mp4.
tools: endast 2.5; stöder för närvarande online-sökverktyget web_search, som kan begränsa antalet resultat, antalet nyckelord och sökkällor.
priority: valbar uppgiftsprioritet för 2.5, heltal 0–9, standard är 0.
safety_identifier: stabil anonym identifierare för slutanvändare med högst 64 tecken; använd hash eller internt anonymt ID och skicka inte namn, e-postadress eller telefonnummer.
execution_expires_after: tidsgräns för uppgiften (sekunder), intervall 3600–259200.
callback_url: asynkron återanropsadress. När den har angetts returnerar API:t omedelbart task_id, och när uppgiften är klar POST:as resultatet till denna adress.
async: valfritt. När den anges som true returnerar gränssnittet omedelbart task_id, utan att callback_url behöver anges. Hämta sedan resultatet genom att polla motsvarande gränssnitt för uppgiftsfråga.

Efter valet kan du se att motsvarande kod också genereras på höger sida, som visas i bilden:

Klicka på knappen ”Try” för att testa. Som visas i bilden ovan får vi följande resultat:

{
  "success": true,
  "task_id": "9777f36b-4f44-47ff-962d-45cd2f7aeaa8",
  "trace_id": "ce5da2ca-6695-4459-9d2c-2ef9f86db752",
  "data": {
    "task_id": "7e4e1773-510a-4a73-9ab4-98dd1a0b2a7f",
    "status": "succeeded",
    "model": "doubao-seedance-2-0-fast-260128",
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "video_url": "https://cdn.acedata.cloud/assets/examples/seedance/036f24ed-a9b1-49b3-92c4-30049a3bc152-102bf9f98e35.mp4"
  }
}

Det returnerade resultatet har flera fält, som introduceras nedan:

success, statusen för videogenereringsuppgiften vid denna tidpunkt.
task_id, ID:t för videogenereringsuppgiften vid denna tidpunkt.
trace_id, spårnings-ID:t för videogenereringen vid denna tidpunkt.
data, resultatlistan för videogenereringsuppgiften vid denna tidpunkt.
- task_id, server-ID:t för videogenereringsuppgiften vid denna tidpunkt.
- video_url, videolänken för videogenereringsuppgiften vid denna tidpunkt.
- status, statusen för videogenereringsuppgiften vid denna tidpunkt.
  - model, modellen som används för att generera videon.

Vi kan se att vi har fått tillfredsställande videoinformation. Vi behöver bara hämta den genererade SeeDance-videon enligt videolänkadressen i data i resultatet. Om du dessutom vill generera motsvarande integrationskod kan du kopiera den direkt. Till exempel är CURL-koden följande:

curl -X POST 'https://api.acedata.cloud/seedance/videos' \
-H 'authorization: Bearer ${bearer_token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
  "content": [{"type":"text","text":"A white ceramic coffee mug on a glossy marble countertop with soft morning window light. The camera slowly orbits 360 degrees around the mug, steam gently rising."}],
  "model": "doubao-seedance-2-0-fast-260128",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5
}'

Beskrivning av inline-parametrar

I slutet av prompten content[].text kan genereringsparametrar skickas genom att lägga till --parameter value (gammal metod, svag validering, standardvärdet används automatiskt vid felaktig ifyllnad). Den fullständiga parameterlistan är följande:

Inline-parameter	Motsvarande fält	Beskrivning	Värdeintervall
`--rs`	`resolution`	Utdatupplösning	`480p` / `720p` / `1080p`
`--rt`	`ratio`	Bildförhållande	`16:9` / `4:3` / `1:1` / `3:4` / `9:16` / `21:9` / `adaptive`
`--dur`	`duration`	Videolängd (sekunder)	2–12
`--frames`	`frames`	Antal videobildrutor	Heltal i [29, 289] som uppfyller 25+4n (stöds endast av 1.0-serien)
`--fps`	`framespersecond`	Bildfrekvens	Stöder endast `24`
`--seed`	`seed`	Slumpmässigt frö	-1 till 4294967295
`--cf`	`camerafixed`	Om kameran är fast	`true` / `false`
`--wm`	`watermark`	Om vattenstämpel ska läggas till	`true` / `false`

Rekommenderad metod: Använd motsvarande fält på toppnivå direkt i Request Body (såsom resolution, ratio osv.). Detta är ett läge med stark validering och ger tydliga felmeddelanden om parametrarna är felaktigt ifyllda, vilket gör det enklare att felsöka problem.

Generera videor med ljud

Seedance 1.5 Pro- och 2.x-serierna stöder generering av videor med ljud via parametern generate_audio:

{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "A girl holds a fox, the wind blows her hair, you can hear the sound of the wind"
    }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "duration": 5
}

1.0-serien stöder inte denna parameter.

Seedance 2.5 multimodal generering, redigering och förlängning

doubao-seedance-2-5-260628 stöder 480p / 720p / 1080p, 4–30 sekunder eller automatisk längd, och höjer materialgränsen till 30 referensbilder, 10 referensvideor och 10 referensljudklipp (högst 50 totalt). 2.5 stöder även att endast skicka referensljud, utan att längre kräva att bilder eller videor tillhandahålls samtidigt. Vid vanlig multimodal generering kan omni_reference_task_type utelämnas, anges som auto eller uttryckligen anges som reference. Videoredigering och förlängning måste skicka in reference_video:

{
  "model": "doubao-seedance-2-5-260628",
  "content": [
    {"type": "text", "text": "Replace the sky with a warm sunset while preserving the subject and camera motion."},
    {"type": "video_url", "role": "reference_video", "video_url": {"url": "https://cdn.acedata.cloud/input.mp4"}}
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": -1,
  "omni_reference_task_type": "edit",
  "output_format": "mov"
}

reference: Skicka in minst en reference_image, reference_video eller reference_audio; 2.5 stöder att endast skicka referensljud.
edit: Måste använda ratio: adaptive och duration: -1; utdatalängden debiteras enligt det faktiska resultatet.
extend: Måste använda ratio: adaptive; duration kan vara 4–30 eller -1.
auto: Modellen väljer automatiskt generering, redigering eller förlängning baserat på prompten och materialet.
Om uppgiftstypen inte matchar materialet eller prompten misslyckas uppgiften och returnerar ett lokaliserbart parameterfel; justera enligt ovanstående begränsningar och skicka in igen.

Första bildrutan för bild-till-video

Om du vill ha en bild-till-video-uppgift måste parametern content först innehålla ett objekt med type som image_url, och fältet image_url måste vara i objektformat: {"url": "https://..."} eller Base64-format {"url": "data:image/png;base64,..."}.

Obs: image_url stöder inte att en sträng skickas direkt (t.ex. "image_url": "https://cdn.acedata.cloud/e724d7f13d.png"). Objektformatet "image_url": {"url": "https://..."} måste användas, annars returneras fel 400.

Motsvarande kod:

import requests

url = "https://api.acedata.cloud/seedance/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "content": [
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
            }
        },
        {
            "type": "text",
            "text": "A girl holds a fox in her arms. She opens her eyes and gazes tenderly at the camera, while the fox affectionately holds her back. As the camera slowly pulls away, her hair is gently blown by the wind. --ratio adaptive  --dur 5"
        }
    ],
    "model": "doubao-seedance-1-0-pro-250528"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Klicka på kör, så ser du att ett resultat erhålls omedelbart, enligt följande:

{
  "success": true,
  "task_id": "dc7cceb5-3c12-4de7-a5f4-abcbba3e8e39",
  "trace_id": "b3b09de3-b7fa-4bb0-88b5-aad4b4a96fd4",
  "data": {
    "task_id": "cgt-20251222072003-x2259",
    "status": "succeeded",
    "video_url": "https://platform.cdn.acedata.cloud/seedance/6afb78b8-5ba8-424f-adcd-69423a700b50.mp4",
    "model": "doubao-seedance-1-0-pro-250528"
  }
}

Det går att se att den genererade effekten är bild-till-video, och resultatet liknar det ovan.

Första och sista bildrutan för bild-till-video

Om du vill ha första och sista bildrutan för bild-till-video måste parametern content först skicka in typen image_url, och role måste ställas in som first_frame respektive last_frame, så att följande innehåll kan anges:

role: Anger första bildrutan eller sista bildrutan.
image_url
- url Bildlänk Samtidigt måste content även mata in typen text som prompt

Motsvarande kod:

import requests

url = "https://api.acedata.cloud/seedance/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
   "model": "doubao-seedance-1-0-pro-250528",
    "content": [
         {
            "type": "text",
            "text": "360-degree shot"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
            },
            "role": "first_frame"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
            },
            "role": "last_frame"
        }
    ]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Klicka på kör, så ser du att ett resultat erhålls omedelbart, enligt följande:

{
  "success": true,
  "task_id": "f7096c6c-9430-4392-8201-d259632d7afd",
  "trace_id": "4a4a3721-00fb-43d2-aff2-3b516ac01a8a",
  "data": {
    "task_id": "cgt-20251222073134-54qcw",
    "status": "succeeded",
    "video_url": "https://platform.cdn.acedata.cloud/seedance/95f9f5f0-fc50-4c71-bc6f-e154582c141e.mp4",
    "model": "doubao-seedance-1-0-pro-250528"
  }
}

Det går att se att den genererade effekten är en video med en karaktär, och resultatet liknar det ovan.

Karaktärs- och ljud-/videomultimodala referenser (Seedance 2.0)

Seedance 2.0-serien (doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, doubao-seedance-2-0-mini-260615) stöder reference_image, reference_audio och reference_video. Eget eller auktoriserat material kan användas för att bibehålla konsekvens i karaktärer, motiv, rörelser, kamerarörelser, ljud och rytm.

Ladda endast upp eget eller auktoriserat material med riktiga personer och karaktärer. Olika modeller stöder material med riktiga personer på olika sätt; begärans format förblir oförändrat, och ett tydligt fel returneras om materialet inte uppfyller kraven.

Viktiga punkter:

Endast modeller i Seedance 2.0-serien stöder reference_image; för 1.x-modeller ska first_frame / last_frame användas (första och sista bildrutan för bild-till-video).
Första bildrutan i bild-till-video, första och sista bildrutan i bild-till-video och referens för alla modaliteter är tre ömsesidigt uteslutande scenarier: first_frame / last_frame kan inte användas tillsammans med reference_image / reference_video / reference_audio.
Om du vill ange första och sista bildrutan i en referens för alla modaliteter, märk bilderna som reference_image och skriv i prompten ”bild 1 som första bildruta” eller ”bild 2 som sista bildruta”; om första och sista bildrutan måste låsas strikt, använd endast first_frame / last_frame.
Övre gräns för antalet multimodala referenser: högst 9 image_url; 2.0 stöder även audio_url (role är reference_audio, högst 3 objekt) och video_url (role är reference_video, högst 3 objekt).
Krav för referensljud (audio_url): format wav / mp3; varje enskilt klipp ska vara 2–15 sekunder, högst 3 klipp och den totala längden får inte överstiga 15 sekunder; varje enskilt klipp får inte överstiga 15 MB. Ljud utanför längdintervallet misslyckas under materialbearbetningen.
Krav för referensvideo (video_url): format mp4 / mov; varje enskild video ska vara 2–15 sekunder, högst 3 videor och den totala längden får inte överstiga 15 sekunder.
För referensbilder rekommenderas foton med en person, ansiktet framåt, tydliga och utan skymmande objekt; ju tydligare ansiktet är, desto högre blir likheten.

Exempel ett: Närbild som behåller personens utseende

Skicka in ett ansiktsfoto och låt personen le och vinka mot kameran. Motsvarande kod:

import requests

url = "https://api.acedata.cloud/seedance/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
        {
            "type": "text",
            "text": "The woman looks at the camera, gives a warm natural smile and waves her hand, soft studio lighting, gentle camera push-in."
        },
        {
            "type": "image_url",
            "role": "reference_image",
            "image_url": {
                "url": "https://cdn.acedata.cloud/assets/examples/nanobanana/8e075897-0f50-4443-8500-666751791c6c-4346f66287c0.jpg"
            }
        }
    ],
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 5
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Det returnerade resultatet är följande, och personen i den genererade videon överensstämmer med referensfotot:

{
  "success": true,
  "task_id": "895eb5ea-bbe1-41a3-a9e9-48608e03f93a",
  "trace_id": "83544791-7a84-44de-b8d2-afe171a1c0e4",
  "data": {
    "task_id": "458abf29-cc39-4fd0-bcea-24f89a70d8de",
    "status": "succeeded",
    "video_url": "https://cdn.acedata.cloud/assets/examples/seedance/e71d3cc5-27e7-4719-be34-1f0e254eccaf-a56b2736a4e0.mp4",
    "model": "doubao-seedance-2-0-fast-260128",
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 5
  }
}

Exempel två: Placera samma person i en helt ny miljö

Styrkan hos reference_image är att endast personens identitet behålls, medan miljö, kläder och rörelser helt bestäms av prompten. Nedan används samma ansiktsfoto för att låta personen bära en beige kappa och gå i en höstpark:

{
  "model": "doubao-seedance-2-0-fast-260128",
  "content": [
    {
      "type": "text",
      "text": "The same woman wearing a beige coat walks through a sunny autumn park, golden leaves falling around her, she smiles softly at the camera, cinematic tracking shot."
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://cdn.acedata.cloud/assets/examples/nanobanana/8e075897-0f50-4443-8500-666751791c6c-4346f66287c0.jpg"
      }
    }
  ],
  "resolution": "720p",
  "ratio": "9:16",
  "duration": 5
}

Det returnerade resultatet är följande: personens utseende bevaras, medan miljön har bytts till en höstpark:

{
  "success": true,
  "task_id": "00872de7-16b7-431f-b4f7-6bf38ae86157",
  "trace_id": "577a07c3-4f5f-4cc7-86fe-535bb8332614",
  "data": {
    "task_id": "32fe1537-ba3e-452a-8749-3ef8890d37fd",
    "status": "succeeded",
    "video_url": "https://cdn.acedata.cloud/assets/examples/seedance/44f47593-556b-4fda-afa5-7a71eefcd228-2161efa5dd09.mp4",
    "model": "doubao-seedance-2-0-fast-260128",
    "resolution": "720p",
    "ratio": "9:16",
    "duration": 5
  }
}

💡 Om du vill att personen exakt ska återskapa kompositionen i fotot (snarare än ”samma person i en annan scen”), kan du i stället använda first_frame (första bildrutan för bild-till-video), så att videon börjar röra sig från detta foto.

Asynkron återuppringning

Eftersom SeeDance Videos Generation API har en relativt lång genereringstid (cirka 1–2 minuter), kan du använda asynkront läge via fältet callback_url för att undvika att HTTP-anslutningen är upptagen under en lång tid. Övergripande flöde: klienten anger callback_url när begäran initieras, och API:et returnerar omedelbart ett svar som innehåller task_id; efter att uppgiften har slutförts skickar plattformen genereringsresultatet till callback_url i form av POST JSON, och resultatet innehåller också task_id för att möjliggöra koppling.

{
  "task_id": "f7096c6c-9430-4392-8201-d259632d7afd"
}

När uppgiften är slutförd är innehållet som plattformen skickar till callback_url följande:

{
  "success": true,
  "task_id": "f7096c6c-9430-4392-8201-d259632d7afd",
  "trace_id": "4a4a3721-00fb-43d2-aff2-3b516ac01a8a",
  "data": {
    "task_id": "cgt-20251222073134-54qcw",
    "status": "succeeded",
    "video_url": "https://platform.cdn.acedata.cloud/seedance/95f9f5f0-fc50-4c71-bc6f-e154582c141e.mp4",
    "model": "doubao-seedance-1-0-pro-250528"
  }
}

Fältet task_id i resultatet är detsamma som det som returnerades vid begäran, och detta fält kan användas för att koppla samman uppgifterna.

Felhantering

Vid anrop av API:et returnerar API:et motsvarande felkod och information om ett fel uppstår. Till exempel:

400 token_mismatched：Felaktig begäran, möjligen på grund av saknade eller ogiltiga parametrar.
400 api_not_implemented：Felaktig begäran, möjligen på grund av saknade eller ogiltiga parametrar.
401 invalid_token：Obehörig, ogiltig eller saknad auktoriseringstoken.
429 too_many_requests：För många begäranden, du har överskridit hastighetsgränsen.
500 api_error：Internt serverfel, något gick fel på servern.

Exempel på felsvar

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Slutsats

Genom detta dokument har du redan lärt dig hur du använder Seedance Videos Generation API för text-till-video, generering med första och sista bildrutan samt multimodala referenser, och hur du använder Seedance 2.5 för att redigera eller förlänga videor. Vi hoppas att detta dokument kan hjälpa dig att slutföra API-integrationen; om du har frågor, vänligen kontakta teknisk support.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Coding

Fler guider

Instruktioner för integration av SeeDance Videos Generation API

Ansökningsprocess

Grundläggande användning

Beskrivning av inline-parametrar

Generera videor med ljud

Seedance 2.5 multimodal generering, redigering och förlängning

Första bildrutan för bild-till-video

Första och sista bildrutan för bild-till-video

Karaktärs- och ljud-/videomultimodala referenser (Seedance 2.0)

Exempel ett: Närbild som behåller personens utseende

Exempel två: Placera samma person i en helt ny miljö

Asynkron återuppringning

Felhantering

Exempel på felsvar

Slutsats

​Ansökningsprocess

​Grundläggande användning

​Beskrivning av inline-parametrar

​Generera videor med ljud

​Seedance 2.5 multimodal generering, redigering och förlängning

​Första bildrutan för bild-till-video

​Första och sista bildrutan för bild-till-video

​Karaktärs- och ljud-/videomultimodala referenser (Seedance 2.0)

​Exempel ett: Närbild som behåller personens utseende

​Exempel två: Placera samma person i en helt ny miljö

​Asynkron återuppringning

​Felhantering

​Exempel på felsvar

​Slutsats

Ansökningsprocess

Grundläggande användning

Beskrivning av inline-parametrar

Generera videor med ljud

Seedance 2.5 multimodal generering, redigering och förlängning

Första bildrutan för bild-till-video

Första och sista bildrutan för bild-till-video

Karaktärs- och ljud-/videomultimodala referenser (Seedance 2.0)

Exempel ett: Närbild som behåller personens utseende

Exempel två: Placera samma person i en helt ny miljö

Asynkron återuppringning

Felhantering

Exempel på felsvar

Slutsats