SeeDance Tasks API:s integration och användning

SeeDance Tasks API:s huvudfunktion är att genom att ange det uppdrag ID som genererats av SeeDance Video Generation API för att kontrollera statusen för det uppdraget. Detta dokument kommer att ge en detaljerad beskrivning av integrationen av SeeDance Tasks API, vilket hjälper dig att enkelt integrera och fullt utnyttja den kraftfulla funktionen hos detta API. Genom SeeDance Tasks API kan du enkelt kontrollera statusen för uppdrag som utförs av SeeDance Video Generation API.

Ansökningsprocess

För att använda SeeDance Video Generation API, börja med att gå till Ace Data Cloud-konsolen för att få din API-token, som du kan spara för framtida bruk.

Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan för att registrera dig och logga in, och efter att ha slutfört detta 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; när kvoten är slut kan du ladda på allmän balans i konsolen.

📘 Fullständig dokumentation: SeeDance Video Generation API →

Begärningsexempel

SeeDance Tasks API kan användas för att kontrollera resultaten från SeeDance Video Generation API. För information om hur man använder SeeDance Video Generation API, se dokumentationen SeeDance Video Generation API. Vi tar ett exempel med ett uppdrag ID som returnerats av SeeDance Video Generation API och visar hur man använder detta API. Anta att vi har ett uppdrag ID: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0, och vi visar hur man skickar in detta uppdrag ID.

Uppdragsexempelbild

Ställ in begärningshuvuden och begärningskropp

Begärningshuvuden inkluderar:

accept: anger att du tar emot svar i JSON-format, här anges som application/json.
authorization: nyckeln för att anropa API:t, som kan väljas direkt efter ansökan.

Begärningskropp inkluderar:

id: det uppladdade uppdrag ID:t.
action: hur uppdraget ska hanteras.

Inställningarna visas i bilden nedan:

Kodexempel

Det kan noteras att olika språkets kod redan har genererats automatiskt på högra sidan, som visas i bilden:

Några kodexempel är som följer:

CURL

curl -X POST 'https://api.acedata.cloud/seedance/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "a6e0d456-189b-4c78-9232-2fe72166ab39",
  "action": "retrieve"
}'

Svarsexempel

När begäran lyckas kommer API:t att returnera detaljerad information om detta uppdrag. Till exempel:

{
    "_id": "69480c5cff2676299c7b351d",
    "id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
    "api_id": "44e45d2b-8754-4a93-b793-c63271335f6f",
    "application_id": "1456a4bf-e2f4-4247-9b2d-fb49effc6eca",
    "created_at": 1766329436.091,
    "started_at": 1766329436.151,
    "finished_at": 1766329518.051,
    "elapsed": 81.9,
    "credential_id": "3e20b461-f750-48d3-a1f7-3aea48d15d77",
    "request": {
        "model": "doubao-seedance-1-0-pro-250528",
        "content": [
            {
                "type": "text",
                "text": "Flera kameravinklar. En detektiv går in i ett svagt upplyst rum. Han undersöker ledtrådar på bordet och plockar upp ett föremål från bordet. Kameran skiftar till honom när han funderar. --ratio 16:9"
            }
        ],
        "callback_url": "dummy"
    },
    "trace_id": "24b1b09c-5649-4290-98db-eab23e5efcac",
    "type": "videos",
    "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
    "response": {
        "success": true,
        "task_id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
        "trace_id": "24b1b09c-5649-4290-98db-eab23e5efcac",
        "data": {
            "task_id": "cgt-20251221230356-sxgt7",
            "status": "succeeded",
            "video_url": "https://platform.cdn.acedata.cloud/seedance/d1c2e49e-d854-4a2e-b0c0-88e520f82e2e.mp4",
            "last_frame_url": null,
            "model": "doubao-seedance-1-0-pro-250528"
        }
    }
}

Det returnerade resultatet innehåller flera fält, där request-fältet är begärningskroppen vid uppdragets start, medan response-fältet är svaret som returneras efter att uppdraget har slutförts. Fälten beskrivs nedan.

id, det genererade uppdragets ID, används för att unikt identifiera detta genererade uppdrag.
request, begärningsinformationen i uppdraget.
response, svarsinformationen i uppdraget.
created_at, tidpunkten då uppdraget skapades, Unix-tidsstämpel (sekunder, flyttal).
started_at, tidpunkten då uppdraget började utföras, Unix-tidsstämpel (sekunder, flyttal).
finished_at, tidpunkten då uppdraget slutfördes, Unix-tidsstämpel (sekunder, flyttal). Detta fält returneras inte om uppdraget inte är slutfört.
elapsed, den tid som uppdraget tog att utföra, i sekunder (flyttal, med 3 decimaler). Detta fält returneras inte om uppdraget inte är slutfört.

Batchfrågeoperation

Detta är för att fråga detaljer om flera uppdrag ID:n, och till skillnad från ovan måste action väljas som retrieve_batch. Begärningskropp inkluderar:

ids: en array av uppladdade uppdrag ID:n.
action: hur uppdraget ska hanteras.

Inställningarna visas i bilden nedan:

Kodexempel

Det kan noteras att olika språkets kod redan har genererats automatiskt på högra sidan, som visas i bilden:

Några kodexempel är som följer:

Svarsexempel

När begäran lyckas kommer API:t att returnera detaljerad information om alla batchuppdrag. Till exempel:

{
    "items": [
        {
            "_id": "69480c5cff2676299c7b351d",
            "id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
            "api_id": "44e45d2b-8754-4a93-b793-c63271335f6f",
            "application_id": "1456a4bf-e2f4-4247-9b2d-fb49effc6eca",
            "created_at": 1766329436.091,
            "started_at": 1766329436.151,
            "finished_at": 1766329518.051,
            "elapsed": 81.9,
            "credential_id": "3e20b461-f750-48d3-a1f7-3aea48d15d77",
            "request": {
                "model": "doubao-seedance-1-0-pro-250528",
                "content": [
                    {
                        "type": "text",
                        "text": "Flera kameravinklar. En detektiv går in i ett svagt upplyst rum. Han undersöker ledtrådar på bordet och plockar upp ett föremål från bordet. Kameran zoomar in på honom när han funderar. --ratio 16:9"
                    }
                ],
                "callback_url": "dummy"
            },
            "trace_id": "24b1b09c-5649-4290-98db-eab23e5efcac",
            "type": "videos",
            "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
            "response": {
                "success": true,
                "task_id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
                "trace_id": "24b1b09c-5649-4290-98db-eab23e5efcac",
                "data": {
                    "task_id": "cgt-20251221230356-sxgt7",
                    "status": "succeeded",
                    "video_url": "https://platform.cdn.acedata.cloud/seedance/d1c2e49e-d854-4a2e-b0c0-88e520f82e2e.mp4",
                    "last_frame_url": null,
                    "model": "doubao-seedance-1-0-pro-250528"
                }
            }
        },
        {
            "_id": "69480e0dff2676299c7cb98b",
            "id": "d9e576bd-ca14-4c6f-a541-f4734e941dbe",
            "api_id": "44e45d2b-8754-4a93-b793-c63271335f6f",
            "application_id": "1456a4bf-e2f4-4247-9b2d-fb49effc6eca",
            "created_at": 1766329436.091,
            "started_at": 1766329436.151,
            "finished_at": 1766329518.051,
            "elapsed": 81.9,
            "credential_id": "3e20b461-f750-48d3-a1f7-3aea48d15d77",
            "request": {
                "model": "doubao-seedance-1-0-pro-250528",
                "content": [
                    {
                        "type": "text",
                        "text": "Flera kameravinklar. En detektiv går in i ett svagt upplyst rum. Han undersöker ledtrådar på bordet och plockar upp ett föremål från bordet. Kameran zoomar in på honom när han funderar. --ratio 16:9"
                    }
                ],
                "callback_url": "dummy"
            },
            "trace_id": "e3da01aa-5026-4653-8d07-c68c4fcf466a",
            "type": "videos",
            "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
            "response": {
                "success": true,
                "task_id": "d9e576bd-ca14-4c6f-a541-f4734e941dbe",
                "trace_id": "e3da01aa-5026-4653-8d07-c68c4fcf466a",
                "data": {
                    "task_id": "cgt-20251221231109-cnkhp",
                    "status": "succeeded",
                    "video_url": "https://platform.cdn.acedata.cloud/seedance/eb99ba03-178c-4616-8d19-e625fee2e884.mp4",
                    "last_frame_url": null,
                    "model": "doubao-seedance-1-0-pro-250528"
                }
            }
        }
    ],
    "count": 2
}

返回结果一共有多个字段，其中items是包含了批量任务的具体详情信息，每个任务的具体信息与上文的字段一样，字段信息如下。

items，批量uppgiftens alla specifika detaljer. Det är en array, varje element i arrayen har samma format som resultatet av att fråga en enskild uppgift.
count，antalet uppgifter i denna batchfråga.

CURL

curl -X POST 'https://api.acedata.cloud/seedance/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["9462ca25-468b-45a5-9e75-6f516dedcc80","d9e576bd-ca14-4c6f-a541-f4734e941dbe"],
  "action": "retrieve_batch"
}'

Felhantering

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

400 token_mismatched：Felaktig begäran, troligen på grund av saknade eller ogiltiga parametrar.
400 api_not_implemented：Felaktig begäran, troligen 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ärningar, du har överskridit hastighetsgränsen.
500 api_error：Intern serverfel, något gick fel på servern.

Felrespons Exempel

{
  "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 Tasks API för att fråga om specifika detaljer för enskilda eller batchuppgifter. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Proxy

Advanced

Coding

SeeDance Tasks API:s integration och användning

Ansökningsprocess

Begärningsexempel

Uppdragsexempelbild

Ställ in begärningshuvuden och begärningskropp

Kodexempel

CURL

Svarsexempel

Batchfrågeoperation

Kodexempel

Svarsexempel

CURL

Felhantering

Felrespons Exempel

Slutsats

​Ansökningsprocess

​Begärningsexempel

​Uppdragsexempelbild

​Ställ in begärningshuvuden och begärningskropp

​Kodexempel

​CURL

​Svarsexempel

​Batchfrågeoperation

​Kodexempel

​Svarsexempel

​CURL

​Felhantering

​Felrespons Exempel

​Slutsats

Ansökningsprocess

Begärningsexempel

Uppdragsexempelbild

Ställ in begärningshuvuden och begärningskropp

Kodexempel

CURL

Svarsexempel

Batchfrågeoperation

Kodexempel

Svarsexempel

CURL

Felhantering

Felrespons Exempel

Slutsats