Önizleme dokümanı

Veo 4 model API'sini ürün akışınıza entegre edin

Bu geliştirici rehberi Veo 4 API için planlanan akışı gösterir: video görevi oluşturma, durum sorgulama, webhook alma ve halka açık lansman öncesi kredi planlama.

API Keys aç Fiyatları gör

Entegrasyon akışı

API'yi dört adımda bağlayın

Backend entegrasyonu hazırlarken bu akışı kullanın. Anahtarı server-side saklayın, işleri asenkron gönderin ve sonuç URL'lerini tamamlanınca kaydedin.

API key oluşturun

Dashboard > API Keys bölümünü açıp server-side key hazırlayın. Tarayıcı istemcileri anahtarı göstermeden kendi backend'inizi çağırmalıdır.

Video görevi gönderin

Prompt, mode, aspect ratio, quality ve opsiyonel webhook URL ile text-to-video veya image-to-video isteği gönderin.

İlerlemeyi takip edin

task_id ile task endpoint'i succeeded veya failed olana kadar sorgulayın. Production'da Webhooks polling'i azaltır.

Asset'i saklayın

Görev başarılı olunca video_url ve thumbnail_url değerlerini CMS, editör, otomasyon pipeline veya kullanıcı proje kaydına yazın.

Önizleme kontratı

Planlanan REST arayüzü

Aşağıdaki örnekler ekiplerin şimdiden client tasarlayabilmesi için somuttur. Lansman duyurusuna kadar bunları taslak kontrat olarak ele alın.

Base URL

Sunucunuzdan HTTPS kullanın. Lansmanda versioned domain veya ek bölgesel endpoint'ler gelebilir.

https://veo4api.net/api/video/veo4

Kimlik doğrulama

Her istek Bearer token kullanır. API keys server secrets içinde saklanmalı, public frontend bundle içine konmamalıdır.

Authorization: Bearer YOUR_API_KEY

POSThttps://veo4api.net/api/video/veo4/generateDeğişebilir

Yeni bir asenkron Veo 4 video görevi oluşturur. Yanıt task_id değerini hemen döner, rendering arka planda sürer.

Alan	Tip	Gerekli	Açıklama
`prompt`	string	Evet	Üretilen klip için doğal dil talimatı. Konu, kamera hareketi, stil ve sınırları ekleyin.
`image_urls`	string[]	Hayır	Image-to-video işleri için herkese açık kaynak görseller. Mevcut proxy image_urls ve uyumlu görsel URL alias'larını kabul eder.
`aspect_ratio`	string	Hayır	Planlanan değerler 16:9, 9:16 ve 1:1 içerir.
`extend_task_id`	string	Hayır	Extension workflow isterken mevcut tamamlanmış videonun opsiyonel task_id değeri.
`seeds`	number	Hayır	Daha tekrarlanabilir çıktılar için opsiyonel numeric seed. Güncel aralık 10000-99999.
`watermark`	string	Hayır	Video generation backend'e iletilen opsiyonel watermark etiketi.
`enableTranslation`	boolean	Hayır	Üretimden önce prompt çevirisini kontrol eden opsiyonel boolean. Varsayılan true.
`public`	boolean	Hayır	Sonucun public showcase alanlarında görünüp görünemeyeceğini belirten opsiyonel boolean.

cURL

curl -X POST "https://veo4api.net/api/video/veo4/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic dolly shot of a glass greenhouse during sunrise",
    "aspect_ratio": "16:9",
    "watermark": "veo4api",
    "enableTranslation": true
  }'

JavaScript

const response = await fetch("https://veo4api.net/api/video/veo4/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    prompt: "Animate this product photo into a smooth studio orbit shot",
    image_urls: ["https://cdn.example.com/input/product.png"],
    aspect_ratio: "1:1",
    seeds: 12345,
    public: false
  })
});

const data = await response.json();
console.log(data.task_id);

Queued yanıtı

{
  "task_id": "veo4_task_01j9example",
  "status": "queued",
  "model": "veo-4",
  "credits_estimated": 180,
  "created_at": "2026-05-17T08:00:00Z"
}

Tamamlanan görev yanıtı

{
  "task_id": "veo4_task_01j9example",
  "status": "succeeded",
  "progress": 100,
  "video_url": "https://cdn.veo4api.net/results/veo4_task_01j9example.mp4",
  "thumbnail_url": "https://cdn.veo4api.net/results/veo4_task_01j9example.jpg",
  "completed_at": "2026-05-17T08:03:42Z"
}

// Poll the task with:
// GET https://veo4api.net/api/video/veo4/status?task_id={task_id}

Asenkron teslim

Tamamlanma olaylarını webhooks ile alın

Webhook delivery public API contract için planlanan bir özelliktir. Etkinleşene kadar status endpoint'i sorgulayın ve backend'inizi gelecekteki webhook_url alanına hazırlayın.

İmza politikası

Webhook imza detayları henüz final değildir. Gelecekteki signature header doğrulaması, task_id saklama ve duplicate event yok sayma için plan yapın.

Webhook payload örneği

{
  "event": "video.succeeded",
  "task_id": "veo4_task_01j9example",
  "status": "succeeded",
  "model": "veo-4",
  "video_url": "https://cdn.veo4api.net/results/veo4_task_01j9example.mp4",
  "credits_charged": 180,
  "created_at": "2026-05-17T08:00:00Z",
  "completed_at": "2026-05-17T08:03:42Z"
}

Güvenilirlik

Görev durumları ve hata yönetimi

Client'ları açık task states ve retry edilebilir hatalar etrafında kurun. Üretim asenkron olduğu için 200 yalnızca görevin kabul edildiği anlamına gelir.

Durum	Anlam
`queued`	İstek kabul edildi ve kapasite bekliyor.
`processing`	Model videoyu render ediyor veya post-processing yapıyor.
`succeeded`	Video hazır ve result URL'leri mevcut.
`failed`	Üretim başarısız. Hata mesajını gösterin ve prompt revizyonu veya retry sunun.
`canceled`	Görev tamamlanmadan iptal edildi.

Kod	Önerilen işlem
`400`	Retry öncesi prompt length, image_urls, aspect_ratio, seeds ve public visibility doğrulayın.
`401`	API key eksik, süresi dolmuş veya geçersiz. Kullanıcıdan yeni key oluşturmasını isteyin.
`402`	Yetersiz kredi. Kullanıcıyı billing'e yönlendirin veya quality düşürün.
`409`	Çakışan task request. Platform conflict dönerse yeni task oluşturmak yerine mevcut task'ı alın.
`429`	Rate limited. Exponential backoff kullanın ve agresif polling'den kaçının.
`500`	Geçici platform veya model hatası. Daha sonra retry edin ve orijinal task kaydını koruyun.

Kredi planlama

Planlanan kredi maliyetleri

Mevcut pricing etiketleri Veo 4 kapasitesi için bu planlama sayılarını kullanır. Lansmana kadar final faturalama taahhüdü değildir.

Standard video job

180

Standard Veo 4 video üretimi başına tahmini kredi.

HD video job

240

HD Veo 4 video üretimi başına tahmini kredi.

Bu değerleri yalnızca kapasite planlama için kullanın. Gerçek API limitleri, quality tiers ve faturalama değişebilir.