API-referanse

Komplett API-dokumentasjon for Veo 3.1 AI videogenerering

Oversikt

Veo 3.1 API lar deg programmatisk generere AI-videoer fra tekstbeskrivelser eller bilder. Vårt RESTful API er designet for å være enkelt, kraftig og lett å integrere i applikasjonene dine.

Basis-URL

https://veo3o1.com/api

Autentisering

Alle API-forespørsler krever autentisering med en API-nøkkel. Inkluder API-nøkkelen din i Authorization-headeren:

Authorization: Bearer YOUR_API_KEY

Du kan generere API-nøkler fra kontopanelet ditt.


Generer video

Opprett en ny AI-video fra tekst eller bilde.

Endepunkt

POST /generate-video

Forespørselskropp

{
  "generationType": "text_to_video" | "image_to_video",
  "prompt": "Your video description",
  "aspectRatio": "auto" | "16:9" | "9:16",
  "imageUrl": "https://...", // Required if generationType is "image_to_video"
  "imageKey": "r2-key" // Optional, for uploaded images
}

Parametere

ParameterTypePåkrevdBeskrivelse
generationTypestringJaGenereringstype: text_to_video eller image_to_video
promptstringJaBeskrivelse av videoen du vil generere
aspectRatiostringNeiVideoens sideforhold. Standard: auto
imageUrlstringBetingetPåkrevd hvis generationType er image_to_video
imageKeystringNeiLagringsnøkkel for opplastede bilder

Svar

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "pending",
    "generationType": "text_to_video",
    "prompt": "Your video description",
    "aspectRatio": "16:9",
    "createdAt": "2025-10-16T10:00:00Z"
  }
}

Eksempel

curl -X POST https://veo3o1.com/api/generate-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "generationType": "text_to_video",
    "prompt": "A beautiful sunset over the ocean with waves gently lapping the shore",
    "aspectRatio": "16:9"
  }'

Hent videostatus

Sjekk statusen til en videogenereringsforespørsel.

Endepunkt

GET /video-status/{uuid}

Parametere

ParameterTypePåkrevdBeskrivelse
uuidstringJaVideo UUID fra genereringsforespørselen

Svar

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "completed" | "pending" | "processing" | "failed",
    "videoUrl": "https://...", // Available when status is "completed"
    "progress": 85, // Processing progress (0-100)
    "estimatedTime": 120 // Estimated seconds remaining
  }
}

Statusverdier

  • pending: Video er i kø for behandling
  • processing: Video genereres
  • completed: Video er klar og tilgjengelig for nedlasting
  • failed: Generering mislyktes (sjekk feilmelding)

Last opp bilde

Last opp et bilde for bilde-til-video generering.

Endepunkt

POST /upload-video-image

Forespørsel

Bruk multipart/form-data for å laste opp bildefilen.

curl -X POST https://veo3o1.com/api/upload-video-image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

Svar

{
  "code": 0,
  "msg": "Upload successful",
  "data": {
    "imageUrl": "https://...",
    "imageKey": "r2-key-123"
  }
}

Støttede formater

  • JPEG/JPG
  • PNG
  • WebP
  • Maksimal filstørrelse: 50MB

Feilkoder

KodeBeskrivelse
0Suksess
1000Ugyldige parametere
1001Utilstrekkelige kreditter
1002Autentisering mislyktes
1003Hastighetsgrense overskredet
5000Serverfeil

Eksempel på feilsvar

{
  "code": 1001,
  "msg": "Insufficient credits",
  "data": {
    "required": 2,
    "current": 0
  }
}

Beste praksis

  1. Ansvarlig polling: Sjekk videostatus hvert 5-10 sekund, ikke kontinuerlig
  2. Feilhåndtering: Implementer retry-logikk med eksponentiell backoff
  3. Cache resultater: Lagre genererte videoer for å unngå regenerering
  4. Bruk webhooks: Mer effektivt enn polling for fullføringsvarslinger
  5. Valider input: Sjekk promptlengde og bildeformater før API-kall

Support

Trenger du hjelp med API-et?