API Referansı

Veo 3.1 AI video oluşturma için eksiksiz API dokümantasyonu

Genel Bakış

Veo 3.1 API, metin açıklamalarından veya görsellerden programatik olarak AI videoları oluşturmanıza olanak tanır. RESTful API'miz basit, güçlü ve uygulamalarınıza kolayca entegre edilebilecek şekilde tasarlanmıştır.

Temel URL

https://veo3o1.com/api

Kimlik Doğrulama

Tüm API istekleri bir API anahtarı ile kimlik doğrulama gerektirir. API anahtarınızı Authorization başlığına ekleyin:

Authorization: Bearer YOUR_API_KEY

API anahtarlarını hesap panelinizden oluşturabilirsiniz.


Video Oluştur

Metin veya görselden yeni bir AI videosu oluşturun.

Endpoint

POST /generate-video

İstek Gövdesi

{
  "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
}

Parametreler

ParametreTipGerekliAçıklama
generationTypestringEvetOluşturma türü: text_to_video veya image_to_video
promptstringEvetOluşturmak istediğiniz videonun açıklaması
aspectRatiostringHayırVideo en-boy oranı. Varsayılan: auto
imageUrlstringKoşullugenerationType image_to_video ise gerekli
imageKeystringHayırYüklenen görseller için depolama anahtarı

Yanıt

{
  "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"
  }
}

Örnek

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"
  }'

Video Durumunu Al

Bir video oluşturma isteğinin durumunu kontrol edin.

Endpoint

GET /video-status/{uuid}

Parametreler

ParametreTipGerekliAçıklama
uuidstringEvetOluşturma isteğinden video UUID

Yanıt

{
  "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
  }
}

Durum Değerleri

  • pending: Video işleme için sırada
  • processing: Video oluşturuluyor
  • completed: Video hazır ve indirilebilir
  • failed: Oluşturma başarısız (hata mesajını kontrol edin)

Görsel Yükle

Görselden videoya oluşturma için bir görsel yükleyin.

Endpoint

POST /upload-video-image

İstek

Görsel dosyasını yüklemek için multipart/form-data kullanın.

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

Yanıt

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

Desteklenen Formatlar

  • JPEG/JPG
  • PNG
  • WebP
  • Maksimum dosya boyutu: 50MB

Hata Kodları

KodAçıklama
0Başarılı
1000Geçersiz parametreler
1001Yetersiz kredi
1002Kimlik doğrulama başarısız
1003Hız limiti aşıldı
5000Sunucu hatası

Hata Yanıtı Örneği

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

En İyi Uygulamalar

  1. Sorumlu yoklama: Video durumunu her 5-10 saniyede bir kontrol edin, sürekli değil
  2. Hata işleme: Üstel geri çekilme ile yeniden deneme mantığı uygulayın
  3. Sonuçları önbelleğe al: Yeniden oluşturmayı önlemek için oluşturulan videoları saklayın
  4. Webhook kullan: Tamamlanma bildirimleri için yoklamadan daha verimli
  5. Girdileri doğrula: API çağrılarından önce prompt uzunluğunu ve görsel formatlarını kontrol edin

Destek

API ile ilgili yardıma mı ihtiyacınız var?