Veo Tasks API:s integration och användning

Veo Tasks API:s huvudfunktion är att genom att ange uppgiftens ID som genererats av Veo Videos Generation API för att kontrollera statusen för den uppgiften. Detta dokument kommer att ge en detaljerad beskrivning av Veo Tasks API:s integration, vilket hjälper dig att enkelt integrera och fullt utnyttja API:ets kraftfulla funktioner. Genom Veo Tasks API kan du enkelt kontrollera statusen för uppgifter i Veo Videos Generation API.

Ansökningsprocess

För att använda Veo Videos 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 som bjuder in dig att registrera dig och logga in, och efter att du har 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 gången du ansöker får du en gratis kvot för att prova; när kvoten är slut kan du ladda på allmän balans i konsolen.

📘 Fullständig dokumentation: Veo Videos Generation API →

Begärningsexempel

Veo Tasks API kan användas för att kontrollera resultaten från Veo Videos Generation API. För information om hur du använder Veo Videos Generation API, se dokumentationen Veo Videos Generation API. Vi tar ett exempel med ett uppgifts-ID som returnerats av Veo Videos Generation API och visar hur man använder detta API. Anta att vi har ett uppgifts-ID: 1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed, och vi visar hur man skickar in detta uppgifts-ID.

Uppgiftsexempelbild

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 uppgifts-ID:t.
action: hur uppgiften 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 följande:

CURL

curl -X POST 'https://api.acedata.cloud/veo/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
  "action": "retrieve"
}'

Python

import requests

url = "https://api.acedata.cloud/veo/tasks"

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

payload = {
    "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
    "action": "retrieve"
}

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

Svarsexempel

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

{
  "_id": "68834c16550a4144a5112589",
  "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
  "api_id": "52a0fa83-3c78-4793-b45a-c1a5c869ae46",
  "application_id": "b7341df0-3a87-40ef-8f3c-a7dda97816a2",
  "created_at": 1753435158.509,
  "started_at": 1753435158.569,
  "finished_at": 1753435250.969,
  "elapsed": 92.4,
  "credential_id": "1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae",
  "request": {
    "callback_url": "https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc",
    "action": "text2video",
    "model": "veo2-fast",
    "prompt": "Vit keramik kaffekopp på glänsande marmorarbetsyta med morgonsolens ljus. Kameran roterar långsamt 360 grader runt koppen och pausar kort vid handtaget."
  },
  "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
  "type": "videos",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "response": {
    "success": true,
    "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
    "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
    "data": [
      {
        "id": "2f43ceed37944b4d836e1a1899dad0a1",
        "video_url": "https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4",
        "created_at": "2025-07-25 17:19:20",
        "complete_at": "2025-07-25 17:21:45",
        "state": "succeeded"
      }
    ]
  }
}

Det returnerade resultatet innehåller flera fält, där request-fältet är begärningskroppen som skickades när uppgiften initierades, medan response-fältet är svaret som returnerades efter att uppgiften slutfördes. Fälten beskrivs nedan.

id, ID:t för att generera denna videouppgift, används för att unikt identifiera denna videoproduktionsuppgift.
request, begärningsinformation i videouppgiften.
response, svarsinformation i videouppgiften.
created_at, tidpunkten då uppgiften skapades, Unix-tidsstämpel (sekunder, flyttal).
started_at, tidpunkten då uppgiften började utföras, Unix-tidsstämpel (sekunder, flyttal).
finished_at, tidpunkten då uppgiften slutfördes, Unix-tidsstämpel (sekunder, flyttal). Detta fält returneras inte om uppgiften inte är slutförd.
elapsed, den tid som uppgiften tog att utföra, i sekunder (flyttal, med 3 decimaler). Detta fält returneras inte om uppgiften inte är slutförd.

Batchfrågeoperationer

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

ids: array av uppladdade uppgifts-ID:n.
action: hur uppgiften 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 följande:

Svarsexempel

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

{
  "items": [
    {
      "_id": "68834c16550a4144a5112589",
      "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
      "api_id": "52a0fa83-3c78-4793-b45a-c1a5c869ae46",
      "application_id": "b7341df0-3a87-40ef-8f3c-a7dda97816a2",
      "created_at": 1753435158.509,
      "started_at": 1753435158.569,
      "finished_at": 1753435250.969,
      "elapsed": 92.4,
      "credential_id": "1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae",
      "request": {
        "callback_url": "https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc",
        "action": "text2video",
        "model": "veo2-fast",
        "prompt": "Vit keramik kaffekopp på glänsande marmorarbetsyta med morgonljus från fönstret. Kameran roterar långsamt 360 grader runt koppen och stannar kort vid handtaget."
      },
      "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
      "type": "videos",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
        "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
        "data": [
          {
            "id": "2f43ceed37944b4d836e1a1899dad0a1",
            "video_url": "https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4",
            "created_at": "2025-07-25 17:19:20",
            "complete_at": "2025-07-25 17:21:45",
            "state": "succeeded"
          }
        ]
      }
    },
    {
      "_id": "68834c16550a4144a5112589",
      "id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
      "api_id": "52a0fa83-3c78-4793-b45a-c1a5c869ae46",
      "application_id": "b7341df0-3a87-40ef-8f3c-a7dda97816a2",
      "created_at": 1753435158.509,
      "started_at": 1753435158.569,
      "finished_at": 1753435250.969,
      "elapsed": 92.4,
      "credential_id": "1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae",
      "request": {
        "callback_url": "https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc",
        "action": "text2video",
        "model": "veo2-fast",
        "prompt": "Vit keramik kaffekopp på glänsande marmorarbetsyta med morgonljus från fönstret. Kameran roterar långsamt 360 grader runt koppen och stannar kort vid handtaget."
      },
      "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
      "type": "videos",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
        "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
        "data": [
          {
            "id": "2f43ceed37944b4d836e1a1899dad0a1",
            "video_url": "https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4",
            "created_at": "2025-07-25 17:19:20",
            "complete_at": "2025-07-25 17:21:45",
            "state": "succeeded"
          }
        ]
      }
    }
  ],
  "count": 2
}

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

items，批量视频uppgifter av 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 av de batchfrågor som görs för videouppgifter.

CURL

curl -X POST 'https://api.acedata.cloud/veo/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed","1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed"],
  "action": "retrieve_batch"
}'

Felhantering

Vid anrop av API:et, om ett fel uppstår, kommer API:et 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：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": "hämtning misslyckades"
  },
  "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 Veo Tasks API för att fråga enskilda eller batchvideouppgifter av alla specifika detaljer. 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

Veo Tasks API:s integration och användning

Ansökningsprocess

Begärningsexempel

Uppgiftsexempelbild

Ställ in begärningshuvuden och begärningskropp

Kodexempel

CURL

Python

Svarsexempel

Batchfrågeoperationer

Kodexempel

Svarsexempel

CURL

Felhantering

Felrespons exempel

Slutsats

​Ansökningsprocess

​Begärningsexempel

​Uppgiftsexempelbild

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

​Kodexempel

​CURL

​Python

​Svarsexempel

​Batchfrågeoperationer

​Kodexempel

​Svarsexempel

​CURL

​Felhantering

​Felrespons exempel

​Slutsats

Ansökningsprocess

Begärningsexempel

Uppgiftsexempelbild

Ställ in begärningshuvuden och begärningskropp

Kodexempel

CURL

Python

Svarsexempel

Batchfrågeoperationer

Kodexempel

Svarsexempel

CURL

Felhantering

Felrespons exempel

Slutsats