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/api

Todennus

Kaikki API-pyynnöt vaativat todennuksen API-avaimella. Sisällytä API-avaimesi Authorization-otsikkoon:

Authorization: Bearer YOUR_API_KEY

Voit luoda API-avaimia tilisi hallintapaneelista.


Luo video

Luo uusi AI-video tekstistä tai kuvasta.

Päätepiste

POST /generate-video

Pyynnö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

ParametriTyyppiPakollinenKuvaus
generationTypestringKylläLuontityyppi: text_to_video tai image_to_video
promptstringKylläKuvaus videosta, jonka haluat luoda
aspectRatiostringEiVideon kuvasuhde. Oletus: auto
imageUrlstringEhdollinenPakollinen jos generationType on image_to_video
imageKeystringEiTallennusavain 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

ParametriTyyppiPakollinenKuvaus
uuidstringKyllä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ä varten
  • processing: Videota luodaan
  • completed: Video on valmis ja ladattavissa
  • failed: Luonti epäonnistui (tarkista virheilmoitus)

Lataa kuva

Lataa kuva kuvasta videoksi -luontia varten.

Päätepiste

POST /upload-video-image

Pyyntö

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

KoodiKuvaus
0Onnistui
1000Virheelliset parametrit
1001Riittämättömät krediitit
1002Todennus epäonnistui
1003Nopeusraja ylitetty
5000Palvelinvirhe

Virhevasteen esimerkki

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

Parhaat käytännöt

  1. Vastuullinen kysely: Tarkista videon tila 5-10 sekunnin välein, ei jatkuvasti
  2. Virheiden käsittely: Toteuta uudelleenyrityslogiikka eksponentiaalisella viiveellä
  3. Tulosten välimuistitus: Tallenna luodut videot uudelleenluonnin välttämiseksi
  4. Käytä webhookeja: Tehokkaampi kuin kysely valmistumisilmoituksiin
  5. Validoi syötteet: Tarkista kehotteen pituus ja kuvamuodot ennen API-kutsuja

Tuki

Tarvitsetko apua API:n kanssa?