Veo Videos Generation API Integrationsbeskrivning

Denna artikel kommer att introducera en Veo Videos Generation API integrationsbeskrivning, som kan generera officiella Veo-videor genom att ange anpassade parametrar.

Ansökningsprocess

För att använda Veo 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 kan användas för att anropa alla tjänster på plattformen, det krävs ingen separat ansökan för varje tjänst. Första ansökan ger 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 →

Grundläggande användning

Först bör du förstå den grundläggande användningen, vilket innebär att ange en prompt prompt, en åtgärd action, en array av referensbilder för första och sista bild image_urls samt modellen model, för att få det bearbetade resultatet. Först behöver du enkelt skicka ett action-fält, vars värde är text2video, som huvudsakligen innehåller tre typer av åtgärder: text till video (text2video), bild till video (image2video), hämta 1080p-video (get1080p). Sedan behöver vi också ange modellen model, som för närvarande huvudsakligen inkluderar veo31-fast, veo3, veo31, veo3-fast och veo31-fast-ingredients, med specifikt innehåll som följer:

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

accept: vilken format av svar du vill ta emot, här anges som application/json, det vill säga 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, huvudsakligen veo31-fast, veo3, veo31, veo3-fast och veo31-fast-ingredients.
action: åtgärden för denna videogenereringsuppgift, som huvudsakligen innehåller tre typer av åtgärder: text till video (text2video), bild till video (image2video), hämta 1080p-video (get1080p).
image_urls: när bild till video-åtgärden image2video väljs, måste referensbildlänkar laddas upp. veo31-fast-ingredients stöder upp till 3 bilder (flera bildfusioner), medan övriga modeller stöder upp till 2 bilder (första och sista bildläge).
resolution: välj upplösningen för den genererade videon, där veo31-modellen stöder 4k-upplösning, medan andra modeller inte gör det. Alla modeller stöder 1080p och gif-upplösning, om detta värde inte anges används 720p som standard, som huvudsakligen delas in i: 1080p, gif, 4k.
prompt: promptord.
callback_url: URL för att få tillbaka resultatet.
async: valfritt, om det sätts till true 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.

📌 Modellbeskrivning Sammanfattning

Modellnamn	Stödda lägen	Bildinmatningsregler
veo3-fast	Text till video (utan bild) Bild till video-läge (med bild)	1 bild → Första bildläge 2 bilder → Första och sista bildläge
veo31-fast	Text till video (utan bild) Bild till video-läge (med bild)	1 bild → Första bildläge 2 bilder → Första och sista bildläge
veo31-fast-ingredients	❌ Text till video (stöds inte) ✅ Tvingad flera bildfusioner (måste skicka bild)	1-3 bilder → Flera bildfusioner (max 3 bilder)
veo3	Text till video (utan bild) Bild till video-läge (med bild)	1 bild → Första bildläge 2 bilder → Första och sista bildläge
veo31	Text till video (utan bild) Bild till video-läge (med bild)	1 bild → Första bildläge 2 bilder → Första och sista bildläge

🔑 Viktiga regler

Allmän logik:
- Ingen bildinmatning → Automatisk aktivering av text till video-läge.
- Med bildinmatning → Aktiverar bild till video-läge (specifik åtgärd bestäms av antalet bilder).
Typer av bild till video-läge:
- Första bildläge (1 bild): Första bilden är fastställd som inmatad bild.
- Första och sista bildläge (2 bilder): Första och sista bilden är fastställda som inmatade bilder.
- Flera bildfusioner (1-3 bilder): Endast veo31-fast-ingredients stöder detta, fusionerar flera bildinnehåll för att generera video.
Klassificering av lägen:

Snabbt läge: veo3-fast, veo31-fast, veo31-fast-ingredients.
Kvalitetsläge: veo3, veo31 (genererar högre kvalitet).

⚠️ Viktiga punkter

Enda tvingande bildmodell: veo31-fast-ingredients måste ha bilder (1-3 bilder), annars kan den inte köras.
Begränsning av antal bilder:
- veo31-fast-ingredients stöder 1-3 bilder inmatning (flera bildfusioner).
- Övriga modeller stöder högst 2 bilder inmatning (första och sista bildläge).

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

Klicka på “Try” knappen för att testa, som visas i bilden ovan, här har vi fått följande resultat:

{
  "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://platform2.cdn.acedata.cloud/veo/f5389ec0-2eb5-4212-b4a8-04b513b0129a.mp4",
      "created_at": "2026-06-30T04:01:50.364Z",
      "complete_at": "2026-06-30T04:03:20.495Z",
      "state": "succeeded"
    }
  ]
}

Det returnerade resultatet innehåller flera fält, som beskrivs nedan:

success，status för videoproduktionsuppgiften vid denna tidpunkt.
task_id，videoproduktionsuppgiftens ID vid denna tidpunkt.
data，resultatet av videoproduktionsuppgiften vid denna tidpunkt.
- id，videoproduktionsuppgiftens video-ID vid denna tidpunkt.
- video_url，videoproduktionsuppgiftens videolänk vid denna tidpunkt.
- created_at，skapelsedatum för videoproduktionsuppgiften vid denna tidpunkt.
- complete_at，slutförandedatum för videoproduktionsuppgiften vid denna tidpunkt.
- state，status för videoproduktionsuppgiften vid denna tidpunkt.

Vi kan se att vi har fått tillfredsställande videoinformation, vi behöver bara hämta den genererade Veo-videon baserat på videolänken i data. 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/veo/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "text2video",
  "model": "veo31-fast",
  "prompt": "Vit keramik kaffekopp på glänsande marmorarbetsyta med morgonljus från fönstret. Kameran roterar långsamt 360 grader runt koppen och pausar kort vid handtaget."
}'

Funktion för att generera video från bilder

Om du vill generera en video baserat på första och sista bildramar kan du ställa in parametern action till image2video och ange en array av bildlänkar för första och sista bildramar image_urls. Därefter måste vi fylla i nästa steg med de utökade promptarna för att anpassa den genererade videon, så att vi kan specificera följande innehåll:

model：modellen för den genererade videon, huvudsakligen veo31-fast、veo3、veo31、veo3-fast och veo31-fast-ingredients.
image_urls：när du väljer videogenerering från bilder image2video måste du ladda upp referensbildlänkar.
prompt：prompt.

Exempel på ifyllning:

När du har fyllt i det genereras automatiskt koden nedan:

Motsvarande Python-kod:

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": "Låt den dansa",
    "image_urls": ["https://cdn.acedata.cloud/7p1jhy.png"]
}

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

När du klickar på körning kan du se att du får ett resultat, som nedan:

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

Det kan ses att resultatinnehållet är konsekvent med det ovanstående, vilket också uppnår funktionen för att generera video från bilder.

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

Om du vill hämta 1080p för en redan genererad Veo-video kan du ställa in parametern action till get1080p och ange ID för den video som behöver hämtas i 1080p. Video-ID:t kan hämtas baserat på grundläggande användning, som visas i bilden nedan:

Vid denna tidpunkt kan du se att video-ID:t är:

"id": "59f12222b1fa4fbe9331ff2400ad1583"

Observera att video-ID:t här är ID:t för den genererade videon. Om du inte vet hur du genererar en video kan du hänvisa till den grundläggande användningen ovan för att generera videon.

Därefter måste vi fylla i nästa steg med de utökade promptarna för att anpassa den genererade videon, så att vi kan specificera följande innehåll:

model：modellen för den genererade videon, huvudsakligen veo31-fast、veo3、veo31、veo3-fast och veo31-fast-ingredients.
video_id：referensvideo-ID:t, som används för att hämta 1080p-videon.

Exempel på ifyllning:

När du har fyllt i det genereras automatiskt koden nedan:

När du klickar på körning kan du se att du får ett resultat, som nedan:

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

Det kan ses att resultatinnehållet är konsekvent med det ovanstående, vilket också uppnår funktionen för att hämta 1080p-video.

Generera video med angiven storlek

Om du vill ange en anpassad storlek för den genererade Veo-videon kan du ställa in parametern aspect_ratio till den önskade storleken. Därefter måste vi fylla i nästa steg med de utökade promptarna för att anpassa den genererade videon, så att vi kan specificera följande innehåll:

model：modellen för den genererade videon, huvudsakligen veo31-fast、veo3、veo31、veo3-fast och veo31-fast-ingredients.
aspect_ratio：videons storlek, för närvarande stöds: 16:9、16:9、3:4、4:3、1:1, standard är 16:9.
translation：om automatisk översättning av promptar ska aktiveras, standard är false. Exempel på ifyllning:

När du har fyllt i det genereras automatiskt koden nedan:

När du klickar på körning kan du se att du får ett resultat, som nedan:

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

Det kan ses att resultatinnehållet är i linje med ovanstående, vilket också uppnår funktionen att generera video i angiven storlek.

Asynkron återkoppling

Eftersom Veo Videos Generation API:s genereringstid är relativt lång, cirka 1-2 minuter, om API:t inte svarar under en längre tid, kommer HTTP-förfrågan att hålla anslutningen öppen, vilket leder till extra systemresursförbrukning, så detta API erbjuder också stöd för asynkron återkoppling. Den övergripande processen är: när klienten initierar en begäran, specificerar den ett extra callback_url-fält, efter att klienten har initierat API-förfrågan kommer API:t omedelbart att returnera ett resultat som innehåller ett task_id-fält, vilket representerar det aktuella uppdragets ID. När uppdraget är slutfört kommer resultatet av den genererade videon att skickas till klientens angivna callback_url i POST JSON-format, vilket också inkluderar task_id-fältet, så att uppdragsresultatet kan kopplas ihop med ID. Nedan kommer vi att förstå hur man gör detta genom ett exempel. Först är Webhook-återkoppling en tjänst som kan ta emot HTTP-förfrågningar, utvecklare bör ersätta med URL:en till sin egen byggda HTTP-server. Här för att underlätta demonstration använder vi en offentlig Webhook-exempelsida https://webhook.site/, öppna denna webbplats för att få en Webhook-URL, som visas i bilden:

Kopiera denna URL, så kan den användas som Webhook, exemplet här är https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc. Därefter kan vi ställa in fältet callback_url till ovanstående Webhook-URL, samtidigt som vi fyller i motsvarande parametrar, det specifika innehållet visas i bilden:

Klicka på kör, och du kan upptäcka att du omedelbart får ett resultat, som följer:

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

Vänta en stund, så kan vi observera resultatet av den genererade videon på https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc, som visas i bilden:

Innehållet är som följer:

{
  "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 kan ses att resultatet innehåller ett task_id-fält, de andra fälten är liknande som ovan, genom detta fält kan uppdragen kopplas ihop.

Felhantering

Vid anrop av API:t, om ett fel uppstår, kommer API:t att returnera motsvarande felkod och information. Till exempel:

400 token_mismatched: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar.
400 api_not_implemented: Bad request, 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 förfrågningar, 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 Veo Videos Generation API för att generera video genom att ange promptord och en referensbild av första ramen. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda detta API. 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

Veo Videos Generation API Integrationsbeskrivning

Ansökningsprocess

Grundläggande användning

📌 Modellbeskrivning Sammanfattning

🔑 Viktiga regler

⚠️ Viktiga punkter

Funktion för att generera video från bilder

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

Generera video med angiven storlek

Asynkron återkoppling

Felhantering

Exempel på felrespons

Slutsats

​Ansökningsprocess

​Grundläggande användning

​📌 Modellbeskrivning Sammanfattning

​🔑 Viktiga regler

​⚠️ Viktiga punkter

​Funktion för att generera video från bilder

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

​Generera video med angiven storlek

​Asynkron återkoppling

​Felhantering

​Exempel på felrespons

​Slutsats

Ansökningsprocess

Grundläggande användning

📌 Modellbeskrivning Sammanfattning

🔑 Viktiga regler

⚠️ Viktiga punkter

Funktion för att generera video från bilder

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

Generera video med angiven storlek

Asynkron återkoppling

Felhantering

Exempel på felrespons

Slutsats