Veo 3.1 API Dokümantasyonu

Google’ın yapay zeka video üretimini uygulamalarınıza entegre etmek için eksiksiz rehber.

Hızlı Başlangıç Rehberi

Veo 3.1 API’yi sadece birkaç dakika içinde kullanmaya başlayın.

API Anahtarınızı Alın

Öncelikle kontrol panelinizden bir API anahtarı edinmeniz gerekir.

İlk İsteğinizi Yapın

curl -X POST "https://veo3api.com/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a dog running",
    "model": "veo4",
    "duration": 5,
    "resolution": "720p"
  }'

Üretim Durumunu Kontrol Edin

Video üretimi eşzamansızdır. https://veo3api.com/feed uç noktasını kullanarak durumu kontrol edin veya

cURL

curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

API Referansı

Tüm Veo 3.1 API uç noktaları, parametreler ve yanıt formatları için eksiksiz referans.

Temel URL

https://veo3api.com

Uç noktalar /api öneki kullanmaz — https://veo3api.com/ adresini çağırın (örneğin https://veo3api.com/generate).

Kimlik Doğrulama

Tüm API istekleri, Authorization başlığında Bearer token kullanılarak kimlik doğrulaması gerektirir.

Authorization: Bearer YOUR_API_KEY

POSThttps://veo3api.com/generate

Metin veya görsel isteminden video oluştur

İstek Gövdesi

Parametre	Tür	Gerekli	Açıklama
`prompt`	string	*	Video üretimi için metin istemi
`model`	string	*	veo3 (yüksek kalite, 180 kredi), veo3-fast (hızlı üretim, 25 kredi) veya veo4 (süre ve çözünürlüğe göre fiyatlandırma; aşağıdaki tabloya bakın) arasından seçim yapın
`duration`	integer		Veo 4 süresi: 5, 10 veya 15 saniye (varsayılan: 5)
`resolution`	string		Veo 4 çıktı çözünürlüğü: 480p, 720p (varsayılan) veya 1080p
`aspect_ratio`	string		En-boy oranı: 16:9 (varsayılan, 1080P HD), 9:16 (dikey) veya Auto (görüntüyle eşleştir)
`image_urls`	string[]		Görüntüden videoya üretim için görsel URL’lerinin dizisi
`watermark`	string		Özel filigran metni. Filigran olmaması için null olarak ayarlayın

Örnek İstek

JSON

{
  "prompt": "a dog running",
  "model": "veo4",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16: 9"
}

Yanıt

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n90a1b2c3d4e5f6sd20",
    "status": "IN_PROGRESS",
    "consumed_credits": 240,
    "model": "veo4"
  }
}

Kredi Tüketimi

Model Türü	Krediler	Maliyet
`veo3-fast`	25 credits	$0.25
`veo3`	180 credits	$1.80
`veo4`480p · 5s / 10s / 15s	160 / 320 / 480 credits	$1.60 / $3.20 / $4.80
`veo4`720p · 5s / 10s / 15s	240 / 480 / 720 credits	$2.40 / $4.80 / $7.20
`veo4`1080p · 5s / 10s / 15s	360 / 720 / 1080 credits	$3.60 / $7.20 / $10.80
`extend`	Orijinali ile aynı	-
`get-1080p`	Ücretsiz	$0.00

Veo 4 fiyatı süre ve çözünürlüğe göre belirlenir; metinden videoya ve görüntüden videoya aynı ücret uygulanır.

Not: Krediler yalnızca video üretimi başarıyla tamamlandığında düşülür. Başarısız görevler kredi tüketmez.

GEThttps://veo3api.com/feed

Video üretim görevinin durumunu kontrol et

Örnek İstek

GET https://veo3api.com/feed?task_id=YOUR_TASK_ID

Yanıt

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "request": {
      "prompt": "a dog running",
      "model": "veo4",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16: 9"
    },
    "response": [
      "https://cdn.veo3api.com/video/example_watermarked.mp4"
    ],
    "status": "COMPLETED",
    "consumed_credits": 240,
    "type": "text-to-video",
    "model": "veo4",
    "created_at": "2025-10-29 12: 20: 46"
  }
}

💡 İpucu: Oluşturulan video URL’si data.response dizisinden alınabilir.

POSThttps://veo3api.com/extend

Mevcut bir videoyu yeni bir istemle uzat. Uzatılan video, orijinal videonun bittiği yerden devam eder.

İstek Gövdesi

Parametre	Tür	Gerekli	Açıklama
`task_id`	string	*	Uzatılacak orijinal tamamlanmış videonun task_id’si
`prompt`	string	*	Videonun nasıl devam edeceğini/uzatılacağını açıklayan metin istemi
`seeds`	integer		Tekrarlanabilir üretim için rastgele seed (10000-99999). Aynı seed benzer sonuçlar üretir
`watermark`	string		Özel filigran metni. Filigran olmaması için null olarak ayarlayın

Örnek İstek

JSON

{
  "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
  "prompt": "The dog continues running and jumps over a fence",
  "watermark": "veo"
}

Yanıt

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
    "original_task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
    "credits_consumed": 25
  }
}

Not: Bu uç nokta yalnızca tamamlanmış veo3 ve veo3-fast görevlerini destekler. Veo 4 görevlerinde kullanılamaz; 1080P’ye dönüştürülmüş videolar da uzatılamaz.

GEThttps://veo3api.com/get-1080pÜcretsiz

Tamamlanmış bir video görevinin yüksek çözünürlüklü 1080P sürümünü alın. Bu uç nokta ücretsizdir ve kredi tüketmez.

Örnek İstek

GET https://veo3api.com/get-1080p?task_id=YOUR_TASK_ID

Yanıt

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
    "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
  }
}

💡 İpucu: Bu uç nokta yalnızca tamamlanmış veo3 ve veo3-fast görevlerini destekler. Ücretsizdir ve kredi tüketmez. Veo 4 doğrudan 1080p olarak oluşturulabilir.

HTTP Durum Kodları

Durum Kodu	Açıklama
`200`	İstek başarılı
`400`	Hatalı istek - Geçersiz parametreler
`401`	Yetkisiz - Geçersiz API anahtarı
`429`	İstek limiti aşıldı
`500`	Sunucu iç hatası