Anslutningsinstruktioner för Veo Videos Generation API

​

Ansökningsprocess

📘 Fullständig dokumentation: Veo Videos Generation API →

​

Grundläggande användning

• 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.

• model: modellen för att generera video, huvudsakligen modellerna veo31-fast, veo3, veo31, veo3-fast och veo31-fast-ingredients.
• action: åtgärden för denna videogenreringsuppgift, som huvudsakligen omfattar tre åtgärder: text-till-video (text2video), bild-till-video (image2video) och hämta 1080p-video (get1080p).
• image_urls: länkar till referensbilder som måste laddas upp när åtgärden bild-till-video image2video väljs. veo31-fast-ingredients stöder högst 3 bilder (flerbildsfusion), medan övriga modeller stöder högst 2 bilder (läge för första och sista bildruta).
• resolution: välj videoupplösningen som ska genereras. Modellen veo31 stöder 4k-upplösning, medan andra modeller inte stöder det. Alla modeller stöder 1080p- och gif-upplösning. Om detta värde inte anges används 720p-upplösning som standard. Alternativen är huvudsakligen: 1080p, gif, 4k.
• prompt: prompt.
• callback_url: URL:en som ska ta emot återanropsresultatet.
• async: valfritt; när den sätts till true returnerar gränssnittet omedelbart task_id, utan att callback_url behöver anges. Resultatet hämtas sedan genom polling via motsvarande gränssnitt för uppgiftsfrågor.

​

📌 Sammanfattning av modellbeskrivning

​

🔑 Förklaring av viktiga regler

1. Allmän logik:
   • Ingen bildinmatning → utlöser automatiskt text-till-video-läge.
   • Bildinmatning finns → utlöser bild-till-video-läge (det specifika beteendet avgörs av antalet bilder).
2. Lägestyper för bild-till-video:
   • Läge för första bildruta (1 bild): den första bildrutan fixeras till den inmatade bilden.
   • Läge för första och sista bildruta (2 bilder): den första och sista bildrutan fixeras till de inmatade bilderna.
   • Flerbildsfusionsläge (1–3 bilder): stöds endast av veo31-fast-ingredients och genererar video genom att sammanfoga innehållet från flera bilder.
3. Lägesklassificering:

• Fast-läge: veo3-fast, veo31-fast, veo31-fast-ingredients.
• Quality-läge: veo3, veo31 (högre genereringskvalitet).

​

⚠️ Observera

• Den enda modellen som kräver bildinmatning: veo31-fast-ingredients måste ta emot bilder (1–3 bilder), annars kan den inte köras.
• Begränsning av antal bilder:
  • veo31-fast-ingredients stöder 1–3 bilder som inmatning (flerbildsfusionsläge).
  • Övriga modeller stöder högst 2 bilder som inmatning (läge för första och sista bildruta).

{
  "success": true,
  "task_id": "697ea2fc-58fd-48c8-8191-29041ff23c3c",
  "trace_id": "70e1cb12-c619-4292-a416-90191205996b",
  "data": [
    {
      "id": "24ac06a5-9cc7-448f-802e-0b4db19f6e96",
      "video_url": "https://cdn.acedata.cloud/assets/examples/veo/f5389ec0-2eb5-4212-b4a8-04b513b0129a-0b0c3113d691.mp4",
      "created_at": "2026-06-30T04:01:50.364Z",
      "complete_at": "2026-06-30T04:03:20.495Z",
      "state": "succeeded"
    }
  ]
}

• success, statusen för videogenereringsuppgiften vid denna tidpunkt.
• task_id, ID:t för videogenereringsuppgiften vid denna tidpunkt.
• data, resultatet för videogenereringsuppgiften vid denna tidpunkt.
  • id, video-ID:t för videogenereringsuppgiften vid denna tidpunkt.
  • video_url, videolänken för videogenereringsuppgiften vid denna tidpunkt.
  • created_at, skapandetiden för videogenereringsuppgiften vid denna tidpunkt.
  • complete_at, slutförandetiden för videogenereringsuppgiften vid denna tidpunkt.
  • state, statusen för videogenereringsuppgiften vid denna tidpunkt.

curl -X POST 'https://api.acedata.cloud/veo/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "text2video",
  "model": "veo31-fast",
  "prompt": "White ceramic coffee mug on glossy marble countertop with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle."
}'

​

Bild-till-video-funktion

• model: modellen för att generera video, huvudsakligen veo31-fast, veo3, veo31, veo3-fast och veo31-fast-ingredients.
• image_urls: när bild-till-video-åtgärden image2video väljs måste länkar till de referensbilder som ska laddas upp anges.
• prompt: promptord.

import requests

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

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

payload = {
    "action": "image2video",
    "model": "veo31-fast",
    "prompt": "Let it dance",
    "image_urls": ["https://cdn.acedata.cloud/7p1jhy.png"]
}

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

{
  "success": true,
  "task_id": "98e309f3-35bc-438d-8cb3-4015fc864b87",
  "trace_id": "8bc68066-36de-41ef-ae5e-b7d61ff6aee8",
  "data": [
    {
      "id": "59f12222b1fa4fbe9331ff2400ad1583",
      "video_url": "https://platform.cdn.acedata.cloud/veo/98e309f3-35bc-438d-8cb3-4015fc864b87.mp4",
      "created_at": "2025-07-25 16:13:07",
      "complete_at": "2025-07-25 16:16:12",
      "state": "succeeded"
    }
  ]
}

​

Funktion för att hämta 1080p-video

"id": "59f12222b1fa4fbe9331ff2400ad1583"

Observera att video_id i videon här är ID:t för den genererade videon. Om du inte vet hur man genererar video kan du läsa den grundläggande användningen ovan för att generera video.

• model: modellen för att generera video, huvudsakligen veo31-fast, veo3, veo31, veo3-fast och veo31-fast-ingredients.
• video_id: referensvideo-ID:t, används för att hämta 1080p-videon.

{
  "success": true,
  "task_id": "47a51cfe-2e24-4aba-93b3-546c2dc52984",
  "trace_id": "a8922eec-6f50-4f77-8104-00ded071d59d",
  "data": [
    {
      "id": "59f12222b1fa4fbe9331ff2400ad1583",
      "video_url": "https://platform.cdn.acedata.cloud/veo/47a51cfe-2e24-4aba-93b3-546c2dc52984.mp4",
      "created_at": "2025-07-25 16:13:07",
      "complete_at": "2025-07-25 16:16:12",
      "state": "succeeded"
    }
  ]
}

​

Generering med angiven videostorlek

• model: modellen för att generera video, huvudsakligen veo31-fast, veo3, veo31, veo3-fast och veo31-fast-ingredients.
• aspect_ratio: videons storlek, stöder för närvarande: 16:9, 16:9, 3:4, 4:3, 1:1, standardvärdet är 16:9.
• translation: om automatisk översättning av promptord ska aktiveras, standardvärdet är false. Ett ifyllningsexempel är följande:

{
  "success": true,
  "task_id": "d2b93290-ab0e-4d20-ae45-60c062a32687",
  "trace_id": "9834e64d-c8fe-43ae-8114-ee2b5f93d886",
  "data": [
    {
      "id": "fc667e7d3b8f44beaa61a3c339af0e50",
      "video_url": "https://platform.cdn.acedata.cloud/veo/d2b93290-ab0e-4d20-ae45-60c062a32687.mp4",
      "created_at": "2025-08-24 20:09:06",
      "complete_at": "2025-08-24 20:10:45",
      "state": "succeeded"
    }
  ]
}

​

Asynkron återuppringning

{
  "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed"
}

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

​

Felhantering

• 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