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/apiKimlik 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_KEYAPI 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
| Parametre | Tip | Gerekli | Açıklama |
|---|---|---|---|
generationType | string | Evet | Oluşturma türü: text_to_video veya image_to_video |
prompt | string | Evet | Oluşturmak istediğiniz videonun açıklaması |
aspectRatio | string | Hayır | Video en-boy oranı. Varsayılan: auto |
imageUrl | string | Koşullu | generationType image_to_video ise gerekli |
imageKey | string | Hayır | Yü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
| Parametre | Tip | Gerekli | Açıklama |
|---|---|---|---|
uuid | string | Evet | Oluş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ıradaprocessing: Video oluşturuluyorcompleted: Video hazır ve indirilebilirfailed: 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ı
| Kod | Açıklama |
|---|---|
| 0 | Başarılı |
| 1000 | Geçersiz parametreler |
| 1001 | Yetersiz kredi |
| 1002 | Kimlik doğrulama başarısız |
| 1003 | Hız limiti aşıldı |
| 5000 | Sunucu hatası |
Hata Yanıtı Örneği
{
"code": 1001,
"msg": "Insufficient credits",
"data": {
"required": 2,
"current": 0
}
}En İyi Uygulamalar
- Sorumlu yoklama: Video durumunu her 5-10 saniyede bir kontrol edin, sürekli değil
- Hata işleme: Üstel geri çekilme ile yeniden deneme mantığı uygulayın
- Sonuçları önbelleğe al: Yeniden oluşturmayı önlemek için oluşturulan videoları saklayın
- Webhook kullan: Tamamlanma bildirimleri için yoklamadan daha verimli
- 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?
- 📧 E-posta: aiprocessingrobot@gmail.com
- 💬 Destek ile iletişime geçin