Ana SayfaKılavuz
güncellendi
Bir AI'a Senaryo Yazdırma: İstem Yapısı
Aslında filme çekebileceğiniz veya seslendirebileceğiniz bir senaryo nasıl oluşturulacağını merak ediyorsanız, cevap yapıdadır: modele senaryonun kime hitap ettiğini, süresini ve çıktının nasıl bir yapıda olması gerektiğini belirtin.


Temel noktalar
- Modele bir rol, kelime cinsinden bir uzunluk, bir ton ve bir çıktı formatı verin. Eksik olan her şey bir tahmin haline gelir.
- Kısa komut dosyaları tek bir çağrıda sığar. Uzunlar için önce bir taslak yazın, sonra bölümler halinde çağrılar yapın.
- Taslaklar için sıcaklığı 0.8 civarında tutun, düzenlemeler için düşürün; sert bir son istiyorsanız durma dizilerini ayarlayın.
- 100.000 tokenlık bağlam penceresi, tam bir taslağı ve tüm önceki bölümleri kapsar; bu nedenle nadiren ekstra taktiklere ihtiyaç duyarsınız.
Kart gerekmez. Kayıt olduktan sonra, tek tıkla (kişi başı bir kez) $0,50 ücretsiz deneme kredisi talep edebilirsiniz.
API anahtarı alKısa cevap: istemde beş parça
Çoğu zayıf senaryo, zayıf istemlerden kaynaklanır. "Kahve hakkında bir senaryo yaz" gibi bir istek, modelin uzunluğu, sesi, formatı ve bakış açısını seçmesine izin verir. Bunun yerine şu beş parçayı verin:
- Amaç: izleyicinin son aşamada ne hissetmesi veya ne yapması gerektiği.
- Kitle ve ton: "yeni ebeveynler, sıcak ve biraz yorgun" ifadesi "dost canlısı" ifadesinden daha iyidir.
- Uzunluk: kelime cinsinden, çünkü modeller saniyeden daha iyi kelime sayar. Yaklaşık 150 kelime bir dakika konuşmaya denk gelir.
- Format: senaryo, iki sütunlu seslendirme ve görseller veya düz anlatım.
- Kısıtlamalar: kaçınılması gerekenler, korunması gereken isimler, gerekli son cümle.
Pratikteki fark şudur. Zayıf bir istem: "Uyku hakkında bir senaryo yaz." Daha güçlü bir istem: "Ofis çalışanlarının yatakta e-posta kontrolü yapmamasını ikna eden, 50 saniyelik bir video için 120 kelimelik bir anlatım yazın. Ton: nazik, hafif komik. Bir soruyla başlayın. Bu gece yapabilecekleri somut bir eylemle bitirin. İlaçlardan bahsetmeyin." İkinci istem yaklaşık kırk token daha harcar ve çoğu yeniden yazma turunu ortadan kaldırır. Ek kelimeleri yapacağınız en ucuz düzenleme olarak görün.
Bu tüm yöntemdir. Bu sayfanın geri kalanı, bunu API çağrılarına nasıl dönüştüreceğinizi ve senaryo uzun olduğunda nasıl ölçeklendireceğinizi gösterir. Sadece hızlı bir test yapmanız gerekiyorsa, API anahtarı sayfası yeni hesaplara küçük bir deneme kredisi verir.
Bir format seçin ve belirtin
Modeller, gösterdiğiniz formatı kopyalar. İki sütunlu bir senaryo istiyorsanız, bir satır gösterin. İstemdeki küçük bir örnek, bir paragraf açıklamadan daha iyidir.
curl https://api.aivideogenapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"temperature": 0.8,
"messages": [
{"role": "system", "content": "You are a scriptwriter. Output a two-column script. Format each row as: VISUAL | NARRATION. About 150 words of narration in total. No headings."},
{"role": "user", "content": "Topic: why airports smell the way they do. Tone: wry. Audience: adults who travel for work."}
]
}'
Aynı istek, temel URL https://api.aivideogenapi.com/v1 olduğunda herhangi bir OpenAI istemcisiyle çalışır. Kimlik doğrulama ve alanlar hakkında ayrıntılar belgeler sayfasında yer almaktadır.
Diyalog komut dosyaları için, istemde konuşmacıları adlandırın ve her birine tek satırlık bir ses notu verin ("Mara: düz, kısa cümleler. Ilya: aşırı açıklama yapıyor"). Bununla birlikte karakterler, sayfa ikiye ulaştığında benzer sesler çıkarma eğilimindedir.
Sonucu değiştiren ayarlar
Diğerlerinden daha fazla önem taşıyan birkaç parametre vardır.
| Öğe | Kullanım alanları | Tipik değer |
|---|---|---|
temperature | Sözcük çeşitliliği | Taslaklar için 0.7 ila 0.9, düzenlemeler için 0.3 ila 0.5 |
top_p | Olası olmayan kelimeleri azaltır | 0.9 ila 0.95; bunu veya sıcaklığı değiştirin, ikisini birden değil |
max_tokens | Yanıt uzunluğu için sert sınır | İsteğe bağlı; kontrolsüz/kaçak çıktıya karşı bir koruma istediğinizde ayarlayın. |
stop | Bir işaretle bitirin | Örneğin "SAHNE BİTTİ" |
frequency_penalty | Tekrarlanan ifadeleri azaltır | Uzun senaryolar için 0.2 ila 0.5 |
seed | Tekrarlanabilir taslaklar | Herhangi bir tamsayı |
Bunlar modele iletilir. İstemi bile bir kelime değiştirdikten sonra aynı tohumdan aynı çıktıyı beklemeyin.
Kısa senaryolar: tek çağrı yeterlidir
30 ila 90 saniyelik bir komut dosyası birkaç yüz kelimedir. Beş parçayı içeren tek bir istek gönderin ve tek bir taslak isteyin. Ardından düzenlemeler için ikinci bir mesaj kullanın, çünkü bir taslağı düzenlemek, sıfırdan yeniden oluşturmadan daha iyi çalışır.
from openai import OpenAI
client = OpenAI(base_url="https://api.aivideogenapi.com/v1", api_key="YOUR_KEY")
messages = [
{"role": "system", "content": "You write tight scripts for short videos. Plain narration, no stage directions."},
{"role": "user", "content": "Purpose: make viewers check their router settings. Tone: calm, a little amused. Length: 140 words."},
]
draft = client.chat.completions.create(model="uncensored", messages=messages, temperature=0.8)
text = draft.choices[0].message.content
messages += [
{"role": "assistant", "content": text},
{"role": "user", "content": "Keep the structure. Replace the opening line with a question, and cut the last sentence."},
]
final = client.chat.completions.create(model="uncensored", messages=messages, temperature=0.4)
print(final.choices[0].message.content)
İkinci çağrıda sıcaklık düşüşüne dikkat edin. Düzenlemeler talimatları izlemeli, keşif yapmamalıdır. Senaryonun ortaya çıkışını izlemek istiyorsanız stream: true ekleyin ve her parça geldiğinde yazdırın; kullanım toplamları akışın sonunda gelir. Akışlı bir istek, bitene kadar eşzamanlı slotlarınızdan birini işgal eder; bu, birkaç taslağı eşzamanlı olarak çalıştırırken önemlidir. Tam bir anahtar aynı anda 8 istek yapmanıza izin verir.
Uzun senaryolar: önce taslak, sonra bölümler
4.000 kelimeyi tek seferde isteyin ve orta kısım zayıflar: model sona acele eder, fikirleri tekrarlar ve küçük gerçekleri unutur. Daha iyi bir desen üç adımdan oluşur.
Adım 1: taslak
Her sahne için bir cümle, her sahnelerin amacı ve tutarlı kalması gereken gerçeklerin (isimler, yerler, her karakterin ne bildiği) sürekli bir listesini içeren numaralı bir taslak isteyin. Bunu elle düzenleyin. Bir hikayeyi düzeltmenin en ucuz yeri budur.
Adım 2: perdelere göre
Her perde için, taslağı, stil kurallarını, önceki perdelere ait kısa bir özetini ve son perdenin tam metnini gönderin. Sadece bir sonraki perdeli isteyin.
acts = []
summary = "None yet."
for n, goal in enumerate(outline_acts, start=1):
prompt = (
f"Outline:\n{outline_text}\n\nStory so far (summary): {summary}\n"
f"Previous act, full text:\n{acts[-1] if acts else '(none)'}\n\n"
f"Write act {n}: {goal}. About 600 words. Match the voice of the previous act."
)
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "system", "content": STYLE_RULES}, {"role": "user", "content": prompt}],
temperature=0.8,
)
acts.append(r.choices[0].message.content)
summary = summarize(acts) # one more short call
Adım 3: senaryo okuması
Tam senaryoyu geri gönderin ve bir yeniden yazma yerine çelişkilerin ve tekrarlanan satırların bir listesini isteyin. Bunları hedefli düzenlemelerle düzeltin.
100.000 tokenlık pencerenin kullanımı
İstem ve yanıt birlikte 100.000 tokena, yaklaşık 70.000 kelimeye ulaşabilir. Tam bir taslak, bir stil rehberi ve tam uzunluktaki bir senaryonun her tamamlanmış perdesi rahatlıkla sığar. Bu, özetleri genellikle atlayıp sadece o ana kadar olan tüm hikayeyi göndererek küçük detayların korunmasını sağladığınız anlamına gelir.
İki uyarı. Birincisi, her çağrı geçmişi yeniden gönderdiği için maliyet artar. İkincisi, çok uzun istemler, en önemli talimatların istemin sonunda, isteğe yakın olması durumunda en iyi şekilde çalışır. Mevcut görevi referans materyalinden sonra sona koyun. bağlam penceresi sayfası, uzun girdilerin nasıl düzenleneceği hakkında daha fazla bilgi verir.
Bölümler halinde oluşturulan 10 dakikalık bir senaryo için fiyat kontrolü: çağrıların toplam 6.000 giriş tokenı ve 4.000 çıkış tokenı oluşturduğunu varsayalım. Bu, giriş için 6.000 / 1.000.000 x $0,15 = $0,0009 ve çıkış için 4.000 / 1.000.000 x $0,50 = $0,002, yani toplam $0,0029 eder. Fiyatlar fiyatlandırma sayfası üzerinde listelenmiştir.
Yaygın sorunlar ve çözümler
- Senaryo çok uzun veya çok kısa. Bir kelime aralığı belirtin ve bir durma noktası ekleyin. Kodda kelime sayısını kontrol edin ve kesin bir sayıyla kısaltma isteyin.
- Her sahne aynı şekilde başlıyor. Bir frekans cezası ve "Sahnelerin başlangıçlarını çeşitlendirin; iki sahneyi asla bir ses veya hava detayıyla açmayın" gibi bir satır ekleyin.
- Ton kayıyor. Hedef sesinin iki örnek satırını sistem mesajına yapıştırın ve modele bunların bir stil referansı olduğunu, tekrar kullanılmaması gerektiğini söyleyin.
- Sahne talimatları anlatıya sızıyor. Anlatım ve görsellerin asla aynı dizeyi paylaşmaması için ayrı alanlar isteyin (
response_format,json_objectolarak ayarlanmış JSON modu ile). - HTTP 429. Bir limite ulaştınız.
rate_limitedkodu, dakika başına çok fazla istek gönderildiğini;concurrencykodu ise aynı anda çok fazla istek yapıldığını gösterir. Bekleyip tekrar deneyin.
Daha fazla kılavuz
Sorular ve cevaplar
Video başına dakika başına kaç kelime istemeliyim?
Sakin bir tempoda dakika başına yaklaşık 150 konuşulan kelime planlayın. Hızlı sosyal medya klipleri 170 kelime veya daha fazla olabilir; bu nedenle gerçek bir seslendirme ile test yapın.
Tüm metni tek bir istekle oluşturmalı mıyım?
Yaklaşık 800 kelimenin altında ise evet. Daha uzun komut dosyaları için önce bir taslak yazın ve her seferinde taslağı ile son bölümü ileterek bölümler halinde üretin.
Model istekler arasında hafıza tutuyor mu?
Hayır. Her istek bağımsızdır; bu nedenle görmek istediğiniz geçmişi mesajlar listesinde gönderirsiniz.
Karanlık veya olgunluk içeren kurgusal metinler yazabilir mi?
Model, yasal yetişkin kullanımı için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır. Reşit olmayanlara yönelik cinsel içerik asla izin verilmez.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.