Veo 3 API: Tek uç noktada istemler ve senaryolar
Veo 3 pipeline'larınız için sansürsüz metin motoruyla başlayın. Yaratıcı reddetmeler olmadan senaryo, altyazı ve istem oluşturmak için OpenAI uyumlu uç noktamızı kullanın.
https://api.veo3apis.com/v1
Ön Koşullar ve Kimlik Doğrulama
İlk isteğinizi yapmadan önce geçerli bir API anahtarınız olduğundan emin olun. Sadece bir e-posta ve şifre ile API anahtarını alın sayfasında kaydolun. 7 gün boyunca geçerli olan ve kredi kartı gerektirmeyen $0.50 değerinde ücretsiz deneme kredisi alırsınız. Üretim iş yükleri için devam eden erişimi güvence altına almak üzere en az $10 ile bakiye yükleyin.
Temel URL'miz https://api.veo3apis.com/v1.'dir. API anahtarınızı Authorization başlığında Bearer token olarak ekleyin. Bu uç nokta tamamen OpenAI ile uyumludur; bu nedenle temel URL'mizi işaret ederek standart SDK'ları kullanabilirsiniz.
Temel Sohbet Tamamlama
Metin oluşturmak için /v1/chat/completions uç noktasına standart bir POST isteği gönderin. Model kimliği "uncensored"dir. Bu, gerçek zamanlı güncellemelere ihtiyaç duymadığınız basit istem oluşturma veya senaryo yazma görevleri için ideal olan tam yanıtı tek bir JSON nesnesi olarak döndürür.
Python SDK Entegrasyonu
Temiz entegrasyon için resmi OpenAI Python SDK'sını kullanın. İstemciyi temel URL'miz ve API anahtarınızla yapılandırın. Bu yaklaşım çok modlu pipeline'larınız için hata yönetimini ve token sayımını basitleştirir.
Node SDK Entegrasyonu
JavaScript/TypeScript projeleri için OpenAI Node SDK'sı doğrudan çalışır. İstemciyi temel URL'mize işaret edin. Bu, Veo 3 iş akışınızdaki sunucu tarafı senaryo oluşturma veya son işleme adımları için kullanışlıdır.
Akış Yanıtları (SSE)
Daha düşük algılanan gecikme süresi için stream: true ayarlayarak akışı etkinleştirin. API, kısmi yanıtların Sunucu Tarafı Olayları (SSE) akışını döndürür. Bu, uygulamanızın tokenları oluşturulurken görüntülemesini sağlar; bu da uzun senaryo oluşturma veya karmaşık akıl yürütme görevleri için kritiktir.
Limitler, Hatalar ve Bağlam
İstekleriniz anahtar başına dakikada 300 isteklik bir hız limitine tabidir. Bu limiti aşarsanız 429 hatası alırsınız. Kimlik doğrulama hataları 401, yetersiz kredi ise 402 döndürür. Bağlam penceresi toplam 100.000 token (istem + tamamlama) içindir. Yüklerinizin 8 MB altında kaldığından emin olun. Tek katı içerik sınırı, her zaman engellenen reşit olmayanlarla ilgili cinsel içeriktir.
cURL
curl https://api.veo3apis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.veo3apis.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.veo3apis.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Akış
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Teknik özellikler
Kredi yüklemeden önce kontrol edebilmeniz için API'nin gerçek limitleri ve özellikleri tek yerde.
| Öğe | Değer |
|---|---|
| Biçim | OpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Model kimliği | uncensored |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.veo3apis.com/v1 |
| JSON modu | response_format: {"type": "json_object"} |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Hız limiti | anahtar başına dakikada 300 istek |
| İstek boyutu | en fazla 8 MB |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Ücretsiz deneme | $0,50, 7 gün, kart gerekmez · Deneme anahtarı: 2 paralel istek, dakikada 60; ilk yüklemeden sonra tam limitler (8 ve 300) |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
| Giriş | Google veya e-posta ve şifre |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
Hata kodları
Hatalar sabit bir type ile JSON olarak döner; başarısız veya reddedilen istekler ücretlendirilmez.
| Kod | Tür | Anlamı |
|---|---|---|
400 | bad_request | geçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun |
401 | missing_key · invalid_key · key_revoked | anahtar yok, yanlış veya değiştirilmiş |
402 | no_credit | kredi bitti — yükleyin, hemen devam eder |
403 | content_blocked | reşit olmayanları içeren cinsel içerik — reddedildi, ücret yok |
404 | not_found | bilinmeyen uç nokta |
413 | request_too_large | gövde 8 MB'tan büyük |
429 | rate_limited · concurrency | dakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin |
503 | upstream_busy | model meşgul — birkaç saniye sonra tekrar deneyin |
Sorular ve cevaplar
Bu resmi Veo 3 video oluşturma API'si mi?
Hayır. Bu bağımsız bir metin API'sidir. Veo 3 pipeline'ınızdaki metin adımlarını (istemler, senaryolar, altyazılar) destekleyen sansürsüz LLM motorunu sağlıyoruz, ancak videoyu kendimiz oluşturmuyoruz.
Deneme için kredi kartı gerekiyor mu?
Hayır. Yeni hesaplar, yalnızca e-posta ve şifre ile 7 gün geçerli $0.50 ücretsiz deneme kredisi alır. $10 veya daha fazla bakiye yüklemek için kripto para (USDT veya USDC) kullanmanız yeterlidir.
Bunu fonksiyon çağırma için kullanabilir miyim?
Evet. Uç noktamız fonksiyon çağırma desteği sunar. İsteğinizde araçları tanımlayabilir ve model, uygulama mantığınıza entegre edilebilecek yapılandırılmış JSON çıktısı döndürür.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın ve temel URL'yi değiştirin. Kurulumun tamamı budur.