Hoppa till huvudinnehåll
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 API:et måste du först gå till Veo Videos Generation API motsvarande sida för att ansöka om den tjänst som behövs. När du kommer till sidan, klicka på knappen “Acquire”, som visas i bilden: Om du inte har loggat in eller registrerat dig kommer du automatiskt att omdirigeras till inloggningssidan där du blir inbjuden 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 API:et gratis.

​
Grundläggande användning

Först och främst, förstå den grundläggande användningsmetoden, 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, så får du det bearbetade resultatet. Först behöver du enkelt skicka ett action-fält, vars värde är text2video. Det innehåller huvudsakligen 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 veo2, veo2-fast, veo3, veo31, veo31-fast, veo31-fast-ingredients och veo3-fast modeller, 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: API-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 veo2, veo2-fast, veo3, veo31, veo31-fast, veo31-fast-ingredients och veo3-fast modeller.
  • 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 för första och sista bild laddas upp, med högst tre referensbilder.
  • 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-upplösning som standard, som huvudsakligen delas in i: 1080p, gif, 4k.
  • prompt: promptord.
  • callback_url: URL för att få tillbaka resultatet.

​
📌 Sammanfattning av modellbeskrivning

ModellnamnStödda lägenBildinmatningsregler
veo2-fastText till video (utan bild)
Bild till video-läge (med bild)		Stöder endast 1 bild → Första bildläge
veo3-fastText till video (utan bild)
Bild till video-läge (med bild)		1 bild → Första bildläge
3 bilder → Första och sista bildläge
veo31-fastText till video (utan bild)
Bild till video-läge (med bild)		1 bild → Första bildläge
3 bilder → Första och sista bildläge
veo31-fast-ingredients❌ Text till video (stöds inte)
✅ Tvingad flerbildssammanslagning (måste skicka bild)		1-3 bilder → Flerbildssammanslagningsläge (max 3 bilder)
veo2Text till video (utan bild)
Bild till video-läge (med bild)		1 bild → Första bildläge
3 bilder → Första och sista bildläge
veo3Text till video (utan bild)
Bild till video-läge (med bild)		1 bild → Första bildläge
3 bilder → Första och sista bildläge
veo31Text till video (utan bild)
Bild till video-läge (med bild)		1 bild → Första bildläge
3 bilder → Första och sista bildläge

​
🔑 Viktiga regler

  1. Allmän logik:
    • Ingen bildinmatning → Utlöser automatiskt text till video-läge.
    • Med bildinmatning → Utlöser bild till video-läge (specifik åtgärd bestäms av antalet bilder).
  2. 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.
    • Flerbildssammanslagningsläge (1-3 bilder): Endast veo31-fast-ingredients stöder detta, som sammanfogar innehållet från flera bilder för att generera video.
  3. Klassificering av lägen:
    • Snabbt läge: veo2-fast, veo3-fast, veo31-fast, veo31-fast-ingredients.
    • Kvalitetsläge: veo2, 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:
    • Förutom veo31-fast-ingredients stöder andra modeller högst 3 bilder som inmatning.
När du har valt kan du se att motsvarande kod också har genererats till höger, som visas i bilden:

Klicka på knappen “Try” för att testa, som visas i bilden ovan, här får vi följande resultat: 
{
  "success": true,
  "task_id": "dd01fc69-e1f7-4b68-aa8c-463f6b748d11",
  "trace_id": "9906dac0-1516-41dc-9fe3-067ca1ba8269",
  "data": [
    {
      "id": "253eedc47f1c4eb2a370ed2312168f4b",
      "video_url": "https://platform.cdn.acedata.cloud/veo/dd01fc69-e1f7-4b68-aa8c-463f6b748d11.mp4",
      "created_at": "2025-07-25 16:07:43",
      "complete_at": "2025-07-25 16:10:28",
      "state": "succeeded"
    }
  ]
}
Det returnerade resultatet har 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": "veo2",
  "prompt": "Vit keramik kaffekopp på glänsande marmorarbetsyta med morgonsolens ljus. Kameran roterar långsamt 360 grader runt koppen och pausar kort vid handtaget."
}'

​
Bild till video-funktion

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 länkar till första och sista bildramar image_urls. Därefter måste vi fylla i nästa steg med utökade promptord för att anpassa den genererade videon, så kan vi specificera följande innehåll:
  • model：modellen för den genererade videon, huvudsakligen veo2 、veo2-fast、veo3 och veo3-fast.
  • image_urls：när du väljer bild till video-beteendet image2video måste du ladda upp länkar till referensbilder för första och sista bildramar.
  • prompt：promptord.
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": "veo2",
    "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ör 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 videofunktionen för bild till video.

​
Hämta 1080p video-funktion

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 videon som ska hämtas i 1080p, videons ID kan hämtas baserat på grundläggande användning, som visas nedan:

Vid denna tidpunkt kan du se att videons ID är: 
"id": "59f12222b1fa4fbe9331ff2400ad1583"
Observera att videons video_id här är ID 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 utökade promptord för att anpassa den genererade videon, så kan vi specificera följande innehåll:
  • model：modellen för den genererade videon, huvudsakligen veo2 、veo2-fast、veo3 och veo3-fast.
  • video_id：referensvideons ID, 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ör 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 videofunktionen för att hämta 1080p-video.

​
Specifiera videostorlek för generering

Om du vill specificera 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 utökade promptord för att anpassa den genererade videon, så kan vi specificera följande innehåll:
  • model：modellen för den genererade videon, huvudsakligen veo2 、veo2-fast、veo3 och veo3-fast.
  • 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 promptord 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ör 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. Därför erbjuder denna API 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 går vi igenom ett exempel för att förstå hur man gör detta. Först är Webhook-återkopplingen en tjänst som kan ta emot HTTP-förfrågningar, utvecklaren 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 se att ett resultat omedelbart erhålls, 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, och 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 för första ramen. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda denna API. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.