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/apiAutentisering
Alle API-forespørsler krever autentisering med en API-nøkkel. Inkluder API-nøkkelen din i Authorization-headeren:
Authorization: Bearer YOUR_API_KEYDu kan generere API-nøkler fra kontopanelet ditt.
Generer video
Opprett en ny AI-video fra tekst eller bilde.
Endepunkt
POST /generate-videoForespø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
| Parameter | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
generationType | string | Ja | Genereringstype: text_to_video eller image_to_video |
prompt | string | Ja | Beskrivelse av videoen du vil generere |
aspectRatio | string | Nei | Videoens sideforhold. Standard: auto |
imageUrl | string | Betinget | Påkrevd hvis generationType er image_to_video |
imageKey | string | Nei | Lagringsnø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
| Parameter | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
uuid | string | Ja | Video 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 behandlingprocessing: Video genererescompleted: Video er klar og tilgjengelig for nedlastingfailed: Generering mislyktes (sjekk feilmelding)
Last opp bilde
Last opp et bilde for bilde-til-video generering.
Endepunkt
POST /upload-video-imageForespø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
| Kode | Beskrivelse |
|---|---|
| 0 | Suksess |
| 1000 | Ugyldige parametere |
| 1001 | Utilstrekkelige kreditter |
| 1002 | Autentisering mislyktes |
| 1003 | Hastighetsgrense overskredet |
| 5000 | Serverfeil |
Eksempel på feilsvar
{
"code": 1001,
"msg": "Insufficient credits",
"data": {
"required": 2,
"current": 0
}
}Beste praksis
- Ansvarlig polling: Sjekk videostatus hvert 5-10 sekund, ikke kontinuerlig
- Feilhåndtering: Implementer retry-logikk med eksponentiell backoff
- Cache resultater: Lagre genererte videoer for å unngå regenerering
- Bruk webhooks: Mer effektivt enn polling for fullføringsvarslinger
- Valider input: Sjekk promptlengde og bildeformater før API-kall
Support
Trenger du hjelp med API-et?
- 📧 E-post: aiprocessingrobot@gmail.com
- 💬 Kontakt support