Hoppa till huvudinnehåll
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 detaljerat beskriva Veo Tasks API:s integrationsanvisningar, för att hjälpa dig att enkelt integrera och fullt utnyttja denna APIs kraftfulla funktioner. Genom Veo Tasks API kan du enkelt kontrollera statusen för uppgifter från Veo Videos Generation API.

​
Ansökningsprocess

För att använda Veo Tasks API måste du först gå till ansökningssidan Veo Videos Generation API för att ansöka om den aktuella tjänsten, och sedan kopiera uppgiftens ID från Veo Videos Generation API, som visas i bilden:

Slutligen går du till Tasks API-sidan Veo Tasks API för att ansöka om den aktuella tjänsten. När du kommer till sidan klickar du på “Acquire”-knappen, som visas i bilden: Ansökningssidan 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. Efter att ha loggat in eller registrerat dig kommer du automatiskt att återvända till den aktuella sidan. Vid första ansökan kommer det att finnas en gratis kvot som ges, så att du kan använda denna API gratis.

​
Begärningsexempel

Veo Tasks API kan användas för att kontrollera resultaten från Veo Videos Generation API. För information om hur man använder Veo Videos Generation API, se dokumentet Veo Videos Generation API. Vi tar ett exempel med ett uppgifts-ID som returnerats av Veo Videos Generation API för att demonstrera hur man använder denna API. Anta att vi har ett uppgifts-ID: 1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed, och vi visar hur man gör detta genom att ange ett 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 visas nedan:

​
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,
  "credential_id": "1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae",
  "request": {
    "callback_url": "https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc",
    "action": "text2video",
    "model": "veo2",
    "prompt": "Vit keramik kaffekopp på glänsande marmor bänkskiva 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 vid uppgiftsstart, medan response-fältet är svaret som returneras efter att uppgiften har slutförts. Fälten beskrivs nedan.
  • id, ID:t för att generera denna videouppgift, används för att unikt identifiera denna videoproduktionsuppgift.
  • request, begärningsinformationen i videouppgiften.
  • response, svarsinformationen i videouppgiften.

​
Batchfrågeoperation

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: en 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 visas nedan:

​
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,
      "credential_id": "1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae",
      "request": {
        "callback_url": "https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc",
        "action": "text2video",
        "model": "veo2",
        "prompt": "Vit keramik kaffemugg på glänsande marmorarbetsyta med morgonljus från fönstret. Kameran roterar långsamt 360 grader runt muggen 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,
      "credential_id": "1f64eaaa-eff0-4f18-bfc2-8c5b1e7949ae",
      "request": {
        "callback_url": "https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc",
        "action": "text2video",
        "model": "veo2",
        "prompt": "Vit keramik kaffemugg på glänsande marmorarbetsyta med morgonljus från fönstret. Kameran roterar långsamt 360 grader runt muggen 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，批batch video tasks’ all specific detail information. It is an array, each element of the array has the same format as the previous query for a single task’s return result.
  • count，此处批量查询视频任务的个数。

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

​
错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：
  • 400 token_mismatched：Bad request, possibly due to missing or invalid parameters.
  • 400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
  • 401 invalid_token：Unauthorized, invalid or missing authorization token.
  • 429 too_many_requests：Too many requests, you have exceeded the rate limit.
  • 500 api_error：Internal server error, something went wrong on the server.

​
错误响应示例

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

​
结论

通过本文档，您已经了解了如何使用 Veo Tasks API 进行查询单个或批量视频任务的所有具体详情信息。希望本文档能帮助您更 bättre att integrera och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.