API-viite
Täydellinen API-dokumentaatio Veo 3.1 AI -videon luomiseen
Yleiskatsaus
Veo 3.1 API mahdollistaa AI-videoiden ohjelmallisen luomisen tekstikuvauksista tai kuvista. RESTful API on suunniteltu yksinkertaiseksi, tehokkaaksi ja helposti integroitavaksi sovelluksiisi.
Perus-URL
https://veo3o1.com/apiTodennus
Kaikki API-pyynnöt vaativat todennuksen API-avaimella. Sisällytä API-avaimesi Authorization-otsikkoon:
Authorization: Bearer YOUR_API_KEYVoit luoda API-avaimia tilisi hallintapaneelista.
Luo video
Luo uusi AI-video tekstistä tai kuvasta.
Päätepiste
POST /generate-videoPyynnön runko
{
"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
}Parametrit
| Parametri | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
generationType | string | Kyllä | Luontityyppi: text_to_video tai image_to_video |
prompt | string | Kyllä | Kuvaus videosta, jonka haluat luoda |
aspectRatio | string | Ei | Videon kuvasuhde. Oletus: auto |
imageUrl | string | Ehdollinen | Pakollinen jos generationType on image_to_video |
imageKey | string | Ei | Tallennusavain ladatuille kuville |
Vastaus
{
"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"
}
}Esimerkki
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"
}'Hae videon tila
Tarkista videon luontipyynnön tila.
Päätepiste
GET /video-status/{uuid}Parametrit
| Parametri | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
uuid | string | Kyllä | Videon UUID luontipyynnöstä |
Vastaus
{
"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
}
}Tila-arvot
pending: Video on jonossa käsittelyä vartenprocessing: Videota luodaancompleted: Video on valmis ja ladattavissafailed: Luonti epäonnistui (tarkista virheilmoitus)
Lataa kuva
Lataa kuva kuvasta videoksi -luontia varten.
Päätepiste
POST /upload-video-imagePyyntö
Käytä multipart/form-data kuvatiedoston lataamiseen.
curl -X POST https://veo3o1.com/api/upload-video-image \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg"Vastaus
{
"code": 0,
"msg": "Upload successful",
"data": {
"imageUrl": "https://...",
"imageKey": "r2-key-123"
}
}Tuetut muodot
- JPEG/JPG
- PNG
- WebP
- Maksimitiedostokoko: 50MB
Virhekoodit
| Koodi | Kuvaus |
|---|---|
| 0 | Onnistui |
| 1000 | Virheelliset parametrit |
| 1001 | Riittämättömät krediitit |
| 1002 | Todennus epäonnistui |
| 1003 | Nopeusraja ylitetty |
| 5000 | Palvelinvirhe |
Virhevasteen esimerkki
{
"code": 1001,
"msg": "Insufficient credits",
"data": {
"required": 2,
"current": 0
}
}Parhaat käytännöt
- Vastuullinen kysely: Tarkista videon tila 5-10 sekunnin välein, ei jatkuvasti
- Virheiden käsittely: Toteuta uudelleenyrityslogiikka eksponentiaalisella viiveellä
- Tulosten välimuistitus: Tallenna luodut videot uudelleenluonnin välttämiseksi
- Käytä webhookeja: Tehokkaampi kuin kysely valmistumisilmoituksiin
- Validoi syötteet: Tarkista kehotteen pituus ja kuvamuodot ennen API-kutsuja
Tuki
Tarvitsetko apua API:n kanssa?
- 📧 Sähköposti: aiprocessingrobot@gmail.com
- 💬 Ota yhteyttä tukeen