Ana SayfaKılavuz
güncellendi
LLM API'si Üzerine Kurulu AI Video Senaryo Üreticisi
Bir AI video senaryo üreticisi, etrafında iyi bir istem olan bir metin modelidir. Bu kılavuz, bir Python şablonu ve senaryo başına gerçek maliyet ile bir OpenAI uyumlu API üzerinde nasıl oluşturulacağını gösterir.


Temel noktalar
- API sadece metin yazar: senaryolar, çekim listeleri ve seslendirme. Videoyu render etmez.
- Editörünüzün veya video aracınızın okuyabileceği bir alanda her sahneyi elde etmek için JSON isteyin.
- 60 saniyelik bir senaryo ve çekim listesi, 1 milyon token başına $0,15 ve $0,50 fiyatla yaklaşık bir santın onda biri tutarındadır.
- Kısa metni, tonu ve önceki sahneleri istemde tutun; pencere 100.000 token.
Kart gerekmez. Kayıt olduktan sonra, tek tıkla (kişi başı bir kez) $0,50 ücretsiz deneme kredisi talep edebilirsiniz.
API anahtarı alBir senaryo üreticisinin aslında ne yaptığı
Bir AI video senaryo üreticisi kısa bir fikir alır ve bir videonun ihtiyacı olan metni döndürür: bir kanca, sahneler, anlatım, ekrandaki metin ve görseller için notlar. Model yazar. Kodunuz geri kalanını yapar: istemi oluşturur, gönderir, yanıtı kontrol eder ve resimleri üreten herhangi bir şeye parçaları verir.
Bu API sadece metindir. Resim, ses veya video üretmez. Bu işe iyi uyar, çünkü senaryo çoğu video projesinin takıldığı adımdır ve otomatikleştirilmesi için en ucuz adımdır. Resimler ve sesler zaten kullandığınız diğer araçlardan gelir. Bağımsız bir sağlayıcı tarafından çalıştırılan model, yasal yetişkin kullanımı için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır; bu, senaryolarınız olgun kurgu, korku, suç hikayeleri veya karanlık mizah içeriyorsa önemlidir. Metnin video boru hatlarına nasıl uyduğunun daha geniş resmini görmek için AI video API kılavuzu'ne bakın.
Bir çağrıda istemek için değerli üç çıktı vardır: seslendirme metni (anlatıcının söylediği şey), çekim listesi (izleyicinin gördüğü şey) ve sahne başına bir süre tahmini. Bunları ayrı alanlara bölmek sonraki adımları basitleştirir.
İstemciyi kurun
Uç nokta OpenAI uyumludur, bu nedenle standart SDK çalışır. API anahtarı sayfası'den bir anahtar alın, ardından istemciyi temel URL'ye yönlendirin ve uncensored model kimliğini kullanın.
from openai import OpenAI
client = OpenAI(
base_url="https://api.aivideogenapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a 3-line hook for a video about night trains."}],
)
print(resp.choices[0].message.content)
print(resp.usage)
Aynı istek, sadece temel URL ve anahtar değiştirilerek curl veya Node ile de çalışır. Tam parametre ayrıntıları API belgeleri'ndadır. Yeni hesaplar, anahtar sayfasında tek tıkla $0,50 deneme kredisi talep edebilir; bu, bu makaledeki her şeyi birçok kez test etmek için yeterlidir.
Kullanılabilir sahneler döndüren bir istem şablonu
Belirsiz bir istek belirsiz senaryolar verir. İyi bir şablon dört şeyi düzeltir: hedef kitle, uzunluk, ton ve çıktı formatı. Kuralları sistem mesajına ve fikri kullanıcı mesajına koyun.
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.aivideogenapi.com/v1", api_key="YOUR_KEY")
SYSTEM = """You write short video scripts.
Return JSON only, with this shape:
{"title": str, "hook": str,
"scenes": [{"n": int, "seconds": int, "voiceover": str,
"shot": str, "on_screen_text": str}]}
Rules:
- Total length matches the requested duration.
- Voiceover is spoken language: short sentences, no stage directions.
- 'shot' describes what the camera shows, in one sentence.
- First scene is a hook that works without sound."""
def make_script(idea, seconds=60, tone="dry, curious", audience="adults"):
user = f"Idea: {idea}\nDuration: {seconds} seconds\nTone: {tone}\nAudience: {audience}"
r = client.chat.completions.create(
model="uncensored",
temperature=0.8,
response_format={"type": "json_object"},
messages=[{"role": "system", "content": SYSTEM},
{"role": "user", "content": user}],
)
return json.loads(r.choices[0].message.content), r.usage
script, usage = make_script("why night trains are coming back")
for s in script["scenes"]:
print(s["n"], s["seconds"], s["voiceover"])
JSON modu (response_format ile json_object) yanıtın ayrıştırılabilir olmasını sağlar. Yine de json.loads'i bir try bloğunun içine sarın ve başarısızlık durumunda bir kez yeniden deneyin, çünkü herhangi bir model bazen bozuk bir dize üretebilir. 0,7 ile 0,9 arasında bir sıcaklık çeşitli sözcükler verir; bir toplu işlem boyunca neredeyse özdeş yapı gerektiğinde bunu 0,3'e düşürün.
Güvenmeden önce uzunluğu kontrol edin
Modeller saniye saymada zayıftır. Güvenli bir kural, sakin bir anlatıcı için dakika başına yaklaşık 150 konuşulan kelimedir, hızlı sosyal klipler için biraz daha fazlasıdır. Her çağrının ardından, tüm seslendirme alanlarındaki kelimeleri sayın ve hedefle karşılaştırın.
def spoken_seconds(script, wpm=150):
words = sum(len(s["voiceover"].split()) for s in script["scenes"])
return round(words / wpm * 60)
est = spoken_seconds(script)
if abs(est - 60) > 8:
print("Off target:", est, "seconds. Ask for a rewrite.")
Senaryo çok uzunsa, gerçek sayılarla ikinci bir mesaj gönderin: "Seslendirme yaklaşık 78 saniye sürüyor; kancayı kaybetmeden 60 saniyeye indirin." Somut geri bildirim "kısalt"tan daha iyi çalışır. Modelin ne yazdığını görmesi için ilk yanıtı mesaj listesine ekleyin.
Çekim listeleri ve seslendirme ayrı aşamalar olarak
Daha uzun videolar için tek bir çağrı her şeyi inceltir. Bunun yerine iki aşamalı yaklaşım kullanın. İlk olarak sahne başlıklarının ve tek satırlık hedeflerin bir taslağını isteyin. Ardından her sahneyi kendi çağrısında oluşturun; tonun devam etmesi için taslağı ve önceki sahnelerin voiceover'ını iletin.
- Aşama 1, taslak: 6 ila 12 sahne, her biri bir hedef ve kabaca bir süre ile.
- Aşama 2, sahneler: voiceover ve çekim, bir seferde tek bir sahne için, bağlamda taslak ve son iki sahne ile.
- Aşama 3, cilalama: tam seslendirmeyi geri okuyun ve tekrarlanan ifadelerin çeşitlendirilmesini isteyin.
Bağlam penceresi istem ve yanıt için 100.000 token kapasitesine sahiptir; bu nedenle tam taslağıyla birlikte 20 dakikalık bir belgesel senaryosu bile tek bir konuşmaya sığar. Uzun oturumlarda belleğin nasıl davrandığı hakkında bilgi için bağlam penceresi sayfası pratik sınırları açıklar. Senaryo yazılırken bir kişiye gösteriliyorsa akış (stream: true) kullanışlıdır.
Bir betiğin maliyeti
Fiyatlandırma 1M girdi token başına $0,15 ve 1M çıktı token başına $0,50 olup, ön ödemeli krediden düşülür. Kamera planı listesi olan tipik bir 60 saniyelik senaryoyu ele alalım. İstem 1.200 token (kurallar ve fikir) ve yanıt 1.800 token olsun.
| Parça | Tokenlar | Matematik | Maliyet |
|---|---|---|---|
| Girdi | 1.200 | 1.200 / 1.000.000 x $0,15 | $0,00018 |
| Çıktı | 1.800 | 1.800 / 1.000.000 x $0,50 | $0,0009 |
| Toplam | 3.000 | $0,00108 |
Bu, senaryo başına yaklaşık bir santimin onda biri demektir. 1.000 senaryo üreten bir kanal, model ücretleri için yaklaşık $1,08 öder. Yeniden denemeler ve cilama aşamaları buna eklenir, ancak senaryo başına üç çağrı bile bunu her seferinde bir santime yakın tutar. Başarısız veya reddedilen istekler için ücret alınmaz. Kredi asla sona ermez ve fiyatlandırma sayfası bakiye yükleme miktarlarını ($20'den $500'e) ve bonus katmanlarını listeler.
Her yanıtta usage alanı kesin token sayılarını verir, böylece tahmin etmek yerine senaryo başına gerçek maliyeti günlüğe kaydedebilirsiniz.
Zaman kazandıran sınırlar ve alışkanlıklar
Tam anahtar 8 eşzamanlı istek ve dakika başına 300 istek izni verir. Deneme anahtarı dakikada 2 eşzamanlı ve 60 istek izni verir. Çok sayıda senaryo toplu olarak işlenirken 4 ila 6 arası bir worker pool kullanın ve HTTP 429 gördüğünüzde geri çekilin. Hata kodu hangi limite ulaştığınızı gösterir: dakika başı istekler için rate_limited, aynı anda çok fazla istek için concurrency. Geçici aşırı yüklenme durumunda yanıt Retry-After: 5 başlığını taşır, bu yüzden beş saniye bekleyip yeniden deneyin.
- Her senaryoyu istemiyle birlikte kaydedin, böylece iyi bir sonucu tekrarlayabilirsiniz. Tekrarlanabilir çalıştırmalar istiyorsanız
seedparametresi iletilir. - Sistem isteminde bir stil sayfası (yasaklanmış ifadeler, tekrarlanan karakter adları, marka sesi) tutun ve videolar arasında yeniden kullanın.
- Her yanıtta
X-Request-Id'i günlüğe kaydedin; bu, belirli bir çağrı hakkında destek istediğinizde yardımcı olur. - Yayınlamadan önce her senaryoyu okuyun. Model akıcı metin yazar, doğrulanmış gerçekler değil.
import time
def call_with_retry(fn, tries=4):
for i in range(tries):
try:
return fn()
except Exception as e:
if "429" in str(e) and i < tries - 1:
time.sleep(5 * (i + 1))
continue
raise
İstemler eğitim için kullanılmaz. Reşit olmayanların dahil olduğu cinsel içerik, çerçeve ne olursa olsun izin verilmez.
Daha fazla kılavuz
Sorular ve cevaplar
Bu API videoyu kendisi oluşturabilir mi?
Hayır. Sadece metin üretir. Senaryolar, çekim listeleri, altyazılar ve seslendirme metinleri için kullanın; bunları zaten kullandığınız video ve ses araçlarına iletin.
Bir senaryo ne kadar uzun olabilir?
Bağlam penceresi istem ve yanıt birlikte 100.000 token içerebilir ve max_tokens isteğe bağlıdır, bu nedenle çok uzun senaryolar sığar. Birkaç dakikadan uzun sürenler için bir taslak aşaması ardından sahneler halinde yapılan çağrılar daha iyi kalite sağlar.
Denemek için ödeme yapmam gerekiyor mu?
Hayır. Yeni kullanıcılar, kayıt olduktan sonra API anahtarı sayfasında tek tıkla $0,50 deneme kredisi alabilir. Sonraki bakiye yüklemeler kripto ile (TRC20 üzerinde USDT veya Base üzerinde USDC) yapılır.
Koyu veya olgun hikaye konularını reddeder mi?
Model, yasal yetişkin kullanımı için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır. Cinsel bağlamda reşit olmayanları içeren içeriklere asla izin verilmez.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın ve temel URL'yi değiştirin. Kurulum bu kadar basit.