ID ▾
Dapatkan kunci API

BerandaPanduan

Diperbarui

Cara Meminta AI Menulis Naskah: Struktur Prompt

Jika Anda ingin tahu cara meminta AI menulis naskah yang bisa Anda syuting atau voiceover, jawabannya adalah struktur: beri tahu model untuk siapa naskah itu, berapa lama durasinya, dan bentuk output yang diperlukan.

Ubin catatan terkait yang mengarah ke tumpukan halaman naskah dan papan klapper, menunjukkan penulisan naskah berbasis garis besar
Wadah kaca mengisi dengan blok bercahaya sementara panah berputar melingkar, menggambarkan jendela konteks agen

Poin utama

  1. Beri model peran, panjang dalam kata, nada, dan format output. Setiap item yang hilang menjadi tebakan.
  2. Naskah pendek muat dalam satu panggilan. Naskah panjang memerlukan kerangka terlebih dahulu, lalu panggilan per bagian.
  3. Gunakan suhu sekitar 0,8 untuk draf dan lebih rendah untuk suntingan; atur urutan henti jika Anda memerlukan akhir yang tegas.
  4. Jendela 100.000 token memuat kerangka lengkap plus semua bagian sebelumnya, jadi Anda jarang memerlukan trik.

Tidak perlu kartu. Setelah mendaftar, klaim $0,50 kredit uji coba gratis dengan satu klik (sekali per orang).

Dapatkan kunci API

Jawaban singkatnya: lima bagian dalam prompt

Sebagian besar naskah lemah berasal dari prompt yang lemah. Permintaan seperti "tulis naskah tentang kopi" membiarkan model memilih panjang, suara, format, dan sudut pandang. Berikan lima bagian ini sebagai gantinya:

  1. Tujuan: apa yang harus dirasakan atau dilakukan penonton di akhir.
  2. Penonton dan nada: "orang tua baru, hangat dan sedikit lelah" lebih baik daripada "ramah".
  3. Panjang: dalam kata, karena model menghitung kata lebih baik daripada detik. Sekitar 150 kata adalah satu menit bicara.
  4. Format: naskah layar, pengisi suara dua kolom dan visual, atau narasi polos.
  5. Batasan: hal-hal yang harus dihindari, nama yang harus dipertahankan, baris akhir yang wajib.

Berikut perbedaannya dalam praktik. Prompt yang lemah: "Tulis naskah tentang tidur." Prompt yang lebih kuat: "Tulis narasi 120 kata untuk video 50 detik yang membujuk pekerja kantor untuk berhenti memeriksa email di tempat tidur. Nada: lembut, sedikit lucu. Buka dengan pertanyaan. Akhiri dengan satu tindakan konkret yang bisa mereka lakukan malam ini. Jangan sebutkan obat-obatan." Prompt kedua membutuhkan sekitar empat puluh token lebih banyak dan menghilangkan sebagian besar putaran penulisan ulang. Anggap kata-kata tambahan itu sebagai pengeditan termurah yang pernah Anda lakukan.

Itulah seluruh metodenya. Sisa halaman ini menunjukkan cara mengubahnya menjadi panggilan API, dan cara skalakan ketika naskah panjang. Jika Anda hanya membutuhkan tes cepat, halaman kunci API memberikan kredit uji coba kecil untuk akun baru.

Pilih format dan sebutkan

Model meniru format yang Anda tunjukkan. Jika Anda menginginkan naskah dua kolom, tunjukkan satu baris. Contoh kecil dalam prompt mengalahkan paragraf deskripsi.

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."}
    ]
  }'

Permintaan yang sama berfungsi dengan klien OpenAI apa pun setelah base URL adalah https://api.aivideogenapi.com/v1. Detail tentang autentikasi dan bidang ada di dokumentasi.

Untuk naskah dialog, beri nama pembicara dalam prompt dan berikan catatan suara satu baris untuk masing-masing ("Mara: blak-blakan, kalimat pendek. Ilya: terlalu menjelaskan"). Tanpanya, karakter cenderung terdengar sama pada halaman kedua.

Pengaturan yang mengubah hasil

Beberapa parameter lebih penting daripada yang lain.

ItemGunakan untukNilai tipikal
temperatureKeragaman pilihan kata0,7 hingga 0,9 untuk draf, 0,3 hingga 0,5 untuk suntingan
top_pMemangkas kata-kata yang tidak mungkin0,9 hingga 0,95; ubah ini atau suhu, bukan keduanya
max_tokensBatas keras pada panjang balasanOpsional; atur saat Anda ingin pengaman terhadap output yang tidak terkendali
stopAkhiri dengan penandaMisalnya "AKHIR ADEGAN"
frequency_penaltyMengurangi frasa berulang0,2 hingga 0,5 untuk naskah panjang
seedDraf yang dapat diulangBilangan bulat apa pun

Ini diteruskan ke model. Jangan mengharapkan output identik dari seed yang sama setelah Anda mengubah prompt hanya satu kata.

Naskah pendek: satu panggilan sudah cukup

Naskah 30 hingga 90 detik adalah beberapa ratus kata. Kirim satu permintaan dengan lima bagian dan minta satu draf. Kemudian gunakan pesan kedua untuk suntingan, karena menyunting draf lebih baik daripada membuat ulang dari awal.

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)

Perhatikan penurunan suhu dalam panggilan kedua. Suntingan harus mengikuti instruksi, bukan menjelajah. Jika Anda ingin melihat naskah muncul, tambahkan stream: true dan cetak setiap bagian saat tiba; total penggunaan ada di akhir aliran. Permintaan streaming memegang salah satu slot konkurensi Anda hingga selesai, yang penting ketika Anda menjalankan beberapa draf secara paralel. Kunci penuh memungkinkan 8 sekaligus.

Naskah panjang: garis besar terlebih dahulu, lalu adegan

Minta 4.000 kata sekaligus dan bagian tengahnya melorot: model terburu-buru di akhir, mengulang ide, dan melupakan fakta kecil. Pola yang lebih baik memiliki tiga langkah.

Langkah 1: garis besar

Minta garis besar bernomor dengan satu kalimat per adegan, tujuan setiap adegan, dan daftar fakta yang harus konsisten (nama, tempat, apa yang diketahui setiap karakter). Sunting ini secara manual. Ini adalah tempat termurah untuk memperbaiki cerita.

Langkah 2: babak demi babak

Untuk setiap babak, kirimkan garis besar, aturan gaya, ringkasan singkat babak sebelumnya, dan teks lengkap babak terakhir. Minta hanya babak berikutnya.

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

Langkah 3: baca ulang

Kirimkan kembali naskah lengkap dan minta daftar kontradiksi dan baris berulang, bukan penulisan ulang. Perbaiki itu dengan suntingan tertarget.

Menggunakan jendela 100.000 token

Prompt plus balasan bisa mencapai 100.000 token, sekitar 70.000 kata. Kerangka lengkap, panduan gaya, dan setiap babak yang selesai dari naskah panjang film muat dengan nyaman. Itu berarti Anda sering bisa melewatkan ringkasan dan cukup mengirim seluruh cerita sejauh ini, yang menjaga detail kecil tetap utuh.

Dua peringatan. Pertama, biaya tumbuh karena setiap panggilan mengirim ulang riwayat. Kedua, prompt yang sangat panjang masih bekerja paling baik ketika instruksi yang paling penting berada di akhir, dekat dengan permintaan. Letakkan tugas saat ini di akhir, setelah materi referensi. Halaman tentang jendela konteks membahas lebih dalam tentang cara mengatur input panjang.

Pemeriksaan harga untuk naskah 10 menit yang dibangun per bab: misalnya panggilan total 6.000 token input dan 4.000 token output. Itu adalah 6.000 / 1.000.000 x $0,15 = $0,0009 untuk input dan 4.000 / 1.000.000 x $0,50 = $0,002 untuk output, sehingga $0,0029 secara keseluruhan. Harga tercantum di halaman harga.

Masalah umum dan perbaikan

  • Naskah terlalu panjang atau terlalu pendek. Nyatakan rentang kata dan tambahkan titik henti. Periksa jumlah kata dalam kode dan minta pemotongan dengan jumlah tepat.
  • Setiap adegan dibuka dengan cara yang sama. Tambahkan penalti frekuensi dan baris seperti "Variasi cara adegan dimulai; jangan pernah membuka dua adegan dengan suara atau detail cuaca."
  • Nada bergeser. Tempelkan dua baris sampel dari suara target ke pesan sistem dan beri tahu model bahwa itu adalah referensi gaya, bukan teks untuk digunakan kembali.
  • Arah panggung bocor ke narasi. Minta bidang terpisah (mode JSON dengan response_format diatur ke json_object) agar narasi dan visual tidak pernah berbagi string.
  • HTTP 429. Anda mencapai batas. Kode rate_limited berarti terlalu banyak permintaan per menit, concurrency berarti terlalu banyak sekaligus. Tunggu dan coba lagi.

Tanya jawab

Berapa banyak kata yang harus saya minta untuk setiap menit video?

Rencanakan sekitar 150 kata yang diucapkan per menit dengan kecepatan tenang. Klip media sosial yang cepat bisa mencapai 170 atau lebih, jadi ujilah dengan pengisi suara asli.

Haruskah saya membuat seluruh skrip dalam satu permintaan?

Untuk di bawah sekitar 800 kata, ya. Untuk naskah yang lebih panjang, buat kerangka terlebih dahulu dan hasilkan bagian demi bagian, dengan meneruskan kerangka dan bagian terakhir setiap kali.

Apakah model menyimpan memori antar permintaan?

Tidak. Setiap permintaan bersifat independen, jadi Anda mengirim riwayat yang ingin dilihatnya dalam daftar pesan.

Apakah model dapat menulis skrip fiksi gelap atau dewasa?

Model ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Konten seksual yang melibatkan anak di bawah umur tidak pernah diizinkan.

Kunci Anda hanya selangkah lagi dari satu formulir

Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.

Dapatkan kunci API