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": "veo3-fast",
    "watermark": "veo"
  }'

Ü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) veya veo3-fast (hızlı üretim, 25 kredi) arasında seçim yapın
`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": "veo3-fast",
  "watermark": "veo"
}

Yanıt

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv"
  }
}

Kredi Tüketimi

Model Türü	Krediler	Maliyet
`veo3-fast`	25 credits	$0.25
`veo3`	180 credits	$1.80
`extend`	Orijinali ile aynı	-
`get-1080p`	Ücretsiz	$0.00

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": "veo3-fast",
      "watermark": "veo"
    },
    "response": [
      "https://cdn.veo3api.com/video/example_watermarked.mp4"
    ],
    "status": "COMPLETED",
    "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": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
  "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": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
    "credits_consumed": 25
  }
}

Not: Yalnızca tamamlanmış video görevleri uzatılabilir. 1080P’ye dönüştürülmüş videolar 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": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
    "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
  }
}

💡 İpucu: Bu uç nokta tamamen ücretsizdir. Herhangi bir tamamlanmış videonun 1080P sürümünü kredi harcamadan alabilirsiniz.

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ı