SeeDance Videos Generation API Integrationsbeskrivning

Detta dokument kommer att introducera en SeeDance Videos Generation API integrationsbeskrivning, som kan generera officiella SeeDance-videor genom att ange anpassade parametrar.

Ansökningsprocess

För att använda SeeDance Videos Generation API, börja med att gå till Ace Data Cloud-konsolen för att hämta din API-token, som du ska spara.

Om du 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 kommer du automatiskt att återvända till den aktuella sidan. En API-token räcker för att anropa alla tjänster på plattformen, du behöver inte ansöka separat för varje tjänst. Första ansökan ger en gratis kvot, så att du kan prova gratis; om kvoten tar slut kan du ladda på allmän balans i konsolen.

📘 Fullständig dokumentation: SeeDance Videos Generation API →

Grundläggande användning

Först bör du förstå den grundläggande användningen, vilket innebär att du anger en prompt content.text, typ content.type=text samt modell model, för att få det bearbetade resultatet. Detaljerna är som följer:

Här kan vi se att vi har ställt in Request Headers, inklusive:

accept: vilken typ av svar du vill ta emot, här anges application/json, vilket innebär JSON-format.
authorization: nyckeln för att anropa API:et, som kan väljas direkt efter ansökan.

Dessutom har vi ställt in 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ödjer multimodal referens för karaktärer och ljud/video): doubao-seedance-2-0-260128 (standard), doubao-seedance-2-0-fast-260128 (snabb), doubao-seedance-2-0-mini-260615 (lätt).
- Seedance 2.5: doubao-seedance-2-5-260628, stödjer upp till 30 sekunder, ren ljudreferens, 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 specificeras med role: first_frame (första bildruta) / last_frame (sista bildruta) / reference_image (karaktär / huvudreferens).
resolution: utdataupplösning, valbar 480p / 720p / 1080p / 4k. 2.5 stödjer 480p, 720p, 1080p; 2.0 Fast/Mini stödjer 480p, 720p; 2.0 Standard stödjer upp till 4k.
ratio: bildförhållande, valbar 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 är 4–30. 1.5/2.x stödjer -1 (automatisk längd).
seed: slumpmässig 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 ljudvideo ska genereras, true / false, Seedance 1.5 Pro och 2.x-serien stödjer detta.
return_last_frame: om den sista bildrutan av videon ska returneras i resultatet.
omni_reference_task_type: endast 2.5; auto / reference / edit / extend.
output_format: endast 2.5; mp4 / mov, standard mp4.
tools: endast 2.5; för närvarande stödjer web_search online sökverktyg, kan begränsa antal resultat, antal nyckelord och sökkällor.
priority: 2.5 valbar uppgiftprioritet, heltal 0–9, standard 0.
safety_identifier: stabil anonym terminalanvändaridentifierare med max 64 tecken; använd hash eller intern anonym ID, ange inte namn, e-post eller telefonnummer.
execution_expires_after: uppgiftens tidsgräns (sekunder), intervall 3600–259200.
callback_url: asynkron återkopplingsadress, efter inställning returnerar API:et omedelbart task_id, och när uppgiften är klar kommer resultatet att POST:as till den adressen.
async: valbar, sätt till true så returnerar gränssnittet omedelbart task_id, utan att behöva ange callback_url, och sedan kan resultatet hämtas genom att fråga motsvarande uppgiftsgränssnitt.

När du har gjort dina val kan du se att motsvarande kod också genererades till höger, som visas i bilden:

Klicka på “Try” knappen för att testa, som visas i bilden ovan, här fick 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://platform2.cdn.acedata.cloud/seedance/036f24ed-a9b1-49b3-92c4-30049a3bc152.mp4"
  }
}

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

success, status för videogenereringsuppgiften.
task_id, ID för videogenereringsuppgiften.
trace_id, spårnings-ID för videogenereringen.
data, resultatlistan för videogenereringsuppgiften.
- task_id, server-ID för videogenereringsuppgiften.
- video_url, videolänken för videogenereringsuppgiften.
- status, status för videogenereringsuppgiften.
  - model, modellen som användes 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 baserat på videolänken i data i resultatet. Om du vill generera motsvarande integrationskod kan du direkt kopiera den som genererats, till exempel CURL-koden nedan:

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":"En vit keramik kaffekopp på en glänsande marmorarbetsyta med mjukt morgonljus från fönstret. Kameran snurrar långsamt 360 grader runt koppen, ångan stiger försiktigt."}],
  "model": "doubao-seedance-2-0-fast-260128",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5
}'

Inline parameterbeskrivning

I content[].text kan du i slutet av prompten lägga till --parameter value för att skicka in genereringsparametrar (gammal metod, svag validering, om du fyller i fel används automatiskt standardvärden). Den kompletta parameterlistan är som följer:

Inlineparameter	Motsvarande fält	Beskrivning	Värdeintervall
`--rs`	`resolution`	Utdataupplö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`	Videoramar	Hela tal som uppfyller 25+4n inom [29, 289] (endast 1.0-serien stöder)
`--fps`	`framespersecond`	Bildfrekvens	Endast `24`
`--seed`	`seed`	Slumptal	-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 direkt motsvarande toppnivåfält i Request Body (som resolution, ratio osv.) för stark validering, om parametrarna är felaktiga kommer ett tydligt felmeddelande att returneras, vilket gör det lättare att felsöka.

Generera videor med ljud

Seedance 1.5 Pro och 2.x-serien stöder att generera videor med ljud genom generate_audio-parametern:

{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "En flicka håller en räv, vinden blåser i hennes hår, du kan höra ljudet av vinden"
    }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "duration": 5
}

1.0-serien stöder inte denna parameter.

Seedance 2.5 Fullmodal 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 gränsen för material till 30 referensbilder, 10 referensvideor, 10 referensljud (totalt högst 50). 2.5 stöder också att endast skicka referensljud, utan krav på att samtidigt tillhandahålla bilder eller videor. Vanlig fullmodal generering kan utelämna omni_reference_task_type, sätta den till auto, eller uttryckligen sätta den till reference. Videoredigering och förlängning måste skicka in reference_video:

{
  "model": "doubao-seedance-2-5-260628",
  "content": [
    {"type": "text", "text": "Byt ut himlen mot en varm solnedgång samtidigt som ämnet och kamerarörelsen bevaras."},
    {"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: Minst en reference_image, reference_video eller reference_audio måste skickas; 2.5 stöder endast att skicka referensljud.
edit: Måste använda ratio: adaptive och duration: -1; utdata längd debiteras baserat på 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å prompt och material.
Om uppgiftstypen inte matchar material eller prompt kommer uppgiften att misslyckas och returnera en spårbar parameterfel; justera enligt ovanstående begränsningar och skicka in igen.

Bild till video första bildruta

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

Observera: image_url stöder inte att direkt skicka in strängformat (som "image_url": "https://cdn.acedata.cloud/e724d7f13d.png"), det måste använda objektformatet "image_url": {"url": "https://..."}, annars kommer det att returnera 400-fel.

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": "En flicka håller en räv i sina armar. Hon öppnar ögonen och ser ömt på kameran, medan räven kärleksfullt håller tillbaka. När kameran långsamt drar sig tillbaka, blåser vinden försiktigt i hennes hår. --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å kan du se att du omedelbart får ett resultat, som följer:

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

Du kan se att den genererade effekten är bild till video, resultatet liknar det ovanstående.

Bild till video första och sista bildruta

Om du vill göra en bild till video första och sista bildruta, måste parametern content först skicka in typ image_url, och ställa in role till first_frame och last_frame, så kan du specificera följande innehåll:

role: Specificera första eller sista bildruta.
image_url
- url bildlänk Samtidigt måste content också ange typ text som prompt.

Motsvarande kod:

```python
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-graders bild"
        },
        {
            "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örning, så kan du se att du omedelbart får ett resultat, som följer:

{
  "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 kan ses att den genererade effekten är att karaktären genererar video, resultatet liknar det ovan.

Karaktär och ljud- och videomultimodal referens (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. Du kan använda egna eller licensierade material för att behålla karaktärens, subjektets, rörelsens, kamerarörelsens, ljudets och rytmens konsekvens.

Vänligen ladda endast upp egna eller licensierade verkliga och karaktärsmaterial. Olika modeller stöder verkligt material på olika sätt; begärningsformatet förblir oförändrat, om materialet inte uppfyller kraven kommer ett tydligt felmeddelande att returneras.

Användningspunkter:

Endast Seedance 2.0-serien modeller stöder reference_image; 1.x-modeller bör använda first_frame / last_frame (bild genererar video första och sista ram).
Bild genererar video första ram, bild genererar video första och sista ram och full multimodal referens är tre ömsesidigt uteslutande scenarier: first_frame / last_frame kan inte blandas med reference_image / reference_video / reference_audio.
Om du vill specificera första och sista ram i full multimodal referens, märk bilden som reference_image och skriv i prompten “bild 1 som första ram” eller “bild 2 som sista ram”; om du behöver strikt låsa första och sista ram, använd endast first_frame / last_frame.
Multimodal referens antal gräns: image_url högst 9 bilder; 2.0 stöder också audio_url (role är reference_audio, högst 3 stycken) och video_url (role är reference_video, högst 3 stycken).
Referensljud (audio_url) material krav: format wav / mp3; enstaka längd 2~15 sekunder, högst 3 stycken och total längd får inte överstiga 15 sekunder; enstaka får inte överstiga 15 MB. Överskridande av längdgränsen kommer att misslyckas under materialbehandlingssteget.
Referensvideo (video_url) material krav: format mp4 / mov; enstaka längd 2~15 sekunder, högst 3 stycken och total längd får inte överstiga 15 sekunder.
Referensbilder rekommenderas att använda en person, rakt fram, tydlig, utan hinder foton, ju tydligare ansiktet, desto högre likhet.

Exempel ett: Bevara karaktärens utseende i närbild

Skicka in ett foto av ett ansikte, låt den personen le mot kameran och vinka. 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": "Kvinnan ser på kameran, ger ett varmt naturligt leende och vinkar med handen, mjukt studiobelysning, försiktig kameraskjutning."
        },
        {
            "type": "image_url",
            "role": "reference_image",
            "image_url": {
                "url": "https://platform2.cdn.acedata.cloud/nanobanana/8e075897-0f50-4443-8500-666751791c6c.jpg"
            }
        }
    ],
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 5
}

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

Returresultatet ser ut som följer, den genererade videon har karaktären som ö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://platform2.cdn.acedata.cloud/seedance/e71d3cc5-27e7-4719-be34-1f0e254eccaf.mp4",
    "model": "doubao-seedance-2-0-fast-260128",
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 5
  }
}

Exempel två: Sätt samma person i en helt ny scen

Styrkan med reference_image ligger i att: endast karaktärens identitet bevaras, medan scen, kläder och rörelser helt bestäms av prompten. Här används samma ansiktsfoto, låt den personen bära en beige kappa och gå i en höstpark:

{
  "model": "doubao-seedance-2-0-fast-260128",
  "content": [
    {
      "type": "text",
      "text": "Samma kvinna i en beige kappa går genom en solig höstpark, gyllene löv faller runt henne, hon ler mjukt mot kameran, filmisk spårning."
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://platform2.cdn.acedata.cloud/nanobanana/8e075897-0f50-4443-8500-666751791c6c.jpg"
      }
    }
  ],
  "resolution": "720p",
  "ratio": "9:16",
  "duration": 5
}

Returresultatet ser ut som följer, karaktärens utseende bevaras, medan scenen 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://platform2.cdn.acedata.cloud/seedance/44f47593-556b-4fda-afa5-7a71eefcd228.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 “en annan scen med samma person”), kan du använda first_frame (den första ramen av videon), så att videon börjar röra sig från denna bild.

Asynkron återkoppling

Eftersom SeeDance Videos Generation API:s genereringstid är ganska lång (ungefär 1-2 minuter), kan du använda callback_url-fältet för att använda asynkron mode, för att undvika att HTTP-anslutningen upptar tid. Övergripande process: När klienten initierar en begäran anger den callback_url, API:n returnerar omedelbart ett svar som innehåller task_id; när uppgiften är klar kommer plattformen att skicka det genererade resultatet i POST JSON-format till callback_url, där resultatet också innehåller task_id för att möjliggöra koppling.

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

När uppgiften är klar, är innehållet som plattformen skickar till callback_url som följer:

{
  "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 genom detta fält kan uppgiften kopplas.

Felhantering

När du anropar API:t, om du stöter på fel, kommer API:t att returnera motsvarande felkod och information. Till exempel:

400 token_mismatched: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
400 api_not_implemented: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
401 invalid_token: Obefogad, ogiltig eller saknad auktoriseringstoken.
429 too_many_requests: För många begärningar, du har överskridit hastighetsgränsen.
500 api_error: Intern serverfel, något gick fel på servern.

Exempel på felrespons

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

Slutsats

Genom detta dokument har du fått en förståelse för hur du använder Seedance Videos Generation API för att generera video från text, första och sista ram samt multimodal referensgenerering, samt hur du använder Seedance 2.5 för att redigera eller förlänga videon. Vi hoppas att detta dokument kan hjälpa dig att slutföra API-integrationen; om du har några frågor, vänligen kontakta teknisk support.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Proxy

Advanced

Coding

SeeDance Videos Generation API Integrationsbeskrivning

Ansökningsprocess

Grundläggande användning

Inline parameterbeskrivning

Generera videor med ljud

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

Bild till video första bildruta

Bild till video första och sista bildruta

Karaktär och ljud- och videomultimodal referens (Seedance 2.0)

Exempel ett: Bevara karaktärens utseende i närbild

Exempel två: Sätt samma person i en helt ny scen

Asynkron återkoppling

Felhantering

Exempel på felrespons

Slutsats

​Ansökningsprocess

​Grundläggande användning

​Inline parameterbeskrivning

​Generera videor med ljud

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

​Bild till video första bildruta

​Bild till video första och sista bildruta

​Karaktär och ljud- och videomultimodal referens (Seedance 2.0)

​Exempel ett: Bevara karaktärens utseende i närbild

​Exempel två: Sätt samma person i en helt ny scen

​Asynkron återkoppling

​Felhantering

​Exempel på felrespons

​Slutsats

Ansökningsprocess

Grundläggande användning

Inline parameterbeskrivning

Generera videor med ljud

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

Bild till video första bildruta

Bild till video första och sista bildruta

Karaktär och ljud- och videomultimodal referens (Seedance 2.0)

Exempel ett: Bevara karaktärens utseende i närbild

Exempel två: Sätt samma person i en helt ny scen

Asynkron återkoppling

Felhantering

Exempel på felrespons

Slutsats