API Referentie
Volledige API-documentatie voor Veo 3.1 AI videogeneratie
Overzicht
De Veo 3.1 API stelt u in staat om programmatisch AI-video's te genereren uit tekstbeschrijvingen of afbeeldingen. Onze RESTful API is ontworpen om eenvoudig, krachtig en gemakkelijk te integreren in uw applicaties.
Basis URL
https://veo3o1.com/apiAuthenticatie
Alle API-verzoeken vereisen authenticatie met een API-sleutel. Voeg uw API-sleutel toe in de Authorization header:
Authorization: Bearer YOUR_API_KEYU kunt API-sleutels genereren vanuit uw account dashboard.
Video genereren
Maak een nieuwe AI-video van tekst of afbeelding.
Endpoint
POST /generate-videoRequest Body
{
"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
}Parameters
| Parameter | Type | Vereist | Beschrijving |
|---|---|---|---|
generationType | string | Ja | Type generatie: text_to_video of image_to_video |
prompt | string | Ja | Beschrijving van de video die u wilt genereren |
aspectRatio | string | Nee | Video beeldverhouding. Standaard: auto |
imageUrl | string | Voorwaardelijk | Vereist als generationType image_to_video is |
imageKey | string | Nee | Opslagsleutel voor geüploade afbeeldingen |
Response
{
"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"
}
}Voorbeeld
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"
}'Videostatus ophalen
Controleer de status van een videogeneratieverzoek.
Endpoint
GET /video-status/{uuid}Parameters
| Parameter | Type | Vereist | Beschrijving |
|---|---|---|---|
uuid | string | Ja | Video UUID van het generatieverzoek |
Response
{
"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
}
}Statuswaarden
pending: Video staat in de wachtrij voor verwerkingprocessing: Video wordt gegenereerdcompleted: Video is klaar en beschikbaar voor downloadfailed: Generatie mislukt (controleer foutmelding)
Afbeelding uploaden
Upload een afbeelding voor afbeelding-naar-video generatie.
Endpoint
POST /upload-video-imageRequest
Gebruik multipart/form-data om het afbeeldingsbestand te uploaden.
curl -X POST https://veo3o1.com/api/upload-video-image \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg"Response
{
"code": 0,
"msg": "Upload successful",
"data": {
"imageUrl": "https://...",
"imageKey": "r2-key-123"
}
}Ondersteunde formaten
- JPEG/JPG
- PNG
- WebP
- Maximale bestandsgrootte: 50MB
Foutcodes
| Code | Beschrijving |
|---|---|
| 0 | Succes |
| 1000 | Ongeldige parameters |
| 1001 | Onvoldoende credits |
| 1002 | Authenticatie mislukt |
| 1003 | Snelheidslimiet overschreden |
| 5000 | Serverfout |
Voorbeeld foutrespons
{
"code": 1001,
"msg": "Insufficient credits",
"data": {
"required": 2,
"current": 0
}
}Best practices
- Verantwoord pollen: Controleer videostatus elke 5-10 seconden, niet continu
- Foutafhandeling: Implementeer retry-logica met exponentiële backoff
- Resultaten cachen: Sla gegenereerde video's op om regeneratie te voorkomen
- Gebruik webhooks: Efficiënter dan polling voor voltooiingsmeldingen
- Valideer invoer: Controleer promptlengte en afbeeldingsformaten voor API-aanroepen
Ondersteuning
Hulp nodig met de API?