BerandaPanduan
Diperbarui
Generator Naskah Video AI Berbasis API LLM
Generator naskah video AI adalah model teks dengan prompt yang baik di sekitarnya. Panduan ini menunjukkan cara membuatnya di atas API yang kompatibel dengan OpenAI, dengan template Python dan biaya nyata per skrip.


Poin utama
- API hanya menulis teks: naskah, daftar bidikan, dan narasi. Ini tidak merender video.
- Minta JSON agar setiap adegan masuk ke bidang yang dapat dibaca editor atau alat video Anda.
- Skrip 60 detik dengan daftar shot berharga sekitar sepersepuluh sen pada $0,15 dan $0,50 per 1M token.
- Pertahankan ringkasan, nada, dan adegan sebelumnya dalam prompt; jendelanya adalah 100.000 token.
Tidak perlu kartu. Setelah mendaftar, klaim $0,50 kredit uji coba gratis dengan satu klik (sekali per orang).
Dapatkan kunci APIApa yang sebenarnya dilakukan generator naskah
Generator naskah video AI mengambil ide singkat dan mengembalikan teks yang dibutuhkan video: hook, adegan, narasi, teks layar, dan catatan untuk visual. Model melakukan penulisan. Kode Anda melakukan sisanya: membuat prompt, mengirimkannya, memeriksa jawaban, dan menyerahkan bagian-bagiannya ke alat apa pun yang membuat gambar.
API ini hanya teks. API ini tidak akan menghasilkan gambar, audio, atau video. Hal ini sangat sesuai dengan tugasnya, karena skrip adalah langkah di mana sebagian besar proyek video terhenti, dan juga langkah termurah untuk diotomatisasi. Gambar dan suara berasal dari alat lain yang sudah Anda gunakan. Model, yang dijalankan oleh penyedia independen, disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, yang penting jika skrip Anda mencakup fiksi dewasa, horor, cerita kriminal, atau humor gelap. Jika Anda ingin gambaran lebih luas tentang bagaimana teks masuk ke dalam pipeline video, lihat panduan API video AI.
Tiga output layak diminta dalam satu panggilan: teks narasi (apa yang dikatakan narator), daftar bidikan (apa yang dilihat penonton), dan estimasi waktu per adegan. Memisahkannya ke bidang yang berbeda membuat langkah selanjutnya sederhana.
Siapkan klien
Endpoint ini kompatibel dengan OpenAI, sehingga SDK standar berfungsi. Dapatkan kunci di halaman kunci API, lalu arahkan klien ke URL dasar dan gunakan ID model uncensored.
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)
Permintaan yang sama berfungsi di curl atau Node dengan hanya URL dasar dan kunci yang berubah. Detail parameter lengkap ada di dokumentasi API. Akun baru dapat mengklaim $0,50 kredit uji coba dengan satu klik di halaman kunci, yang cukup untuk menguji semuanya di artikel ini berkali-kali.
Template prompt yang mengembalikan adegan yang dapat digunakan
Permintaan yang kabur memberikan naskah yang kabur. Template yang baik memperbaiki empat hal: audiens, panjang, nada, dan format output. Masukkan aturan dalam pesan sistem dan ide dalam pesan pengguna.
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"])
Mode JSON (response_format dengan json_object) menjaga agar balasan dapat diuraikan. Tetap bungkus json.loads dalam blok coba dan coba lagi sekali pada kegagalan, karena model apa pun dapat secara berkala menghasilkan string yang rusak. Suhu 0,7 hingga 0,9 memberikan variasi kata; turunkan ke 0,3 ketika Anda membutuhkan struktur yang hampir identik di seluruh batch.
Periksa panjang sebelum Anda mempercayainya
Model kurang akurat dalam menghitung detik. Aturan yang andal adalah sekitar 150 kata diucapkan per menit untuk narator yang tenang, sedikit lebih banyak untuk klip sosial yang cepat. Setelah setiap panggilan, hitung kata-kata di semua bidang narasi dan bandingkan dengan target.
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.")
Jika skrip terlalu panjang, kirim pesan kedua dengan angka aktual: "Narasi berjalan sekitar 78 detik; potong menjadi 60 tanpa kehilangan hook." Umpan balik konkret bekerja lebih baik daripada "memendekkannya". Simpan balasan pertama dalam daftar pesan agar model melihat apa yang ditulisnya.
Daftar bidikan dan narasi sebagai langkah terpisah
Untuk video yang lebih panjang, satu panggilan untuk semuanya menjadi tipis. Gunakan dua langkah sebagai gantinya. Pertama, minta garis besar judul adegan dan tujuan satu baris. Kemudian hasilkan setiap adegan dalam panggilannya sendiri, meneruskan garis besar dan narasi adegan sebelumnya agar nada tetap terjaga.
- Langkah 1, garis besar: 6 hingga 12 adegan, masing-masing dengan tujuan dan durasi kasar.
- Langkah 2, adegan: narasi dan bidikan untuk satu adegan pada satu waktu, dengan garis besar dan dua adegan terakhir dalam konteks.
- Langkah 3, perbaikan: baca kembali narasi lengkap dan minta frasa yang diulang bervariasi.
Jendela konteks adalah 100.000 token untuk prompt ditambah balasan, sehingga bahkan skrip dokumenter 20 menit dengan garis besar lengkapnya muat dalam satu percakapan. Untuk cara jendela konteks bekerja dalam sesi panjang, halaman tentang jendela konteks mencakup batasan praktis. Streaming (stream: true) berguna jika Anda menampilkan skrip kepada seseorang saat skrip ditulis.
Biaya skrip
Harga adalah $0,15 per 1 juta token input dan $0,50 per 1 juta token output, dibayar dari saldo prabayar. Ambil skrip 60 detik tipikal dengan daftar bidikan. Katakan promptnya adalah 1.200 token (aturan plus ide) dan balasannya adalah 1.800 token.
| Bagian | Token | Matematika | Biaya |
|---|---|---|---|
| Input | 1.200 | 1.200 / 1.000.000 x $0,15 | $0,00018 |
| Output | 1.800 | 1.800 / 1.000.000 x $0,50 | $0,0009 |
| Total | 3.000 | $0,00108 |
Itu sekitar sepersepuluh sen per skrip. Saluran yang membuat 1.000 skrip membayar sekitar $1,08 dalam biaya model. Pencobaan ulang dan langkah perbaikan menambah biaya ini, tetapi bahkan tiga panggilan per skrip tetap dekat dengan satu sen per skrip. Permintaan yang gagal atau ditolak tidak dibebankan. Saldo tidak pernah kedaluwarsa, dan halaman harga mencantumkan jumlah isi ulang, mulai dari $20 hingga $500, dan tingkat bonus.
Bidang usage dalam setiap respons memberikan jumlah token yang tepat, sehingga Anda dapat mencatat biaya nyata per naskah daripada memperkirakan.
Batas dan kebiasaan yang menghemat waktu
Kunci penuh mengizinkan 8 permintaan paralel dan 300 permintaan per menit. Kunci uji coba mengizinkan 2 paralel dan 60 per menit. Saat Anda membuat banyak skrip, gunakan kumpulan pekerja kecil berukuran 4 hingga 6 dan kurangi laju ketika Anda melihat HTTP 429. Kode kesalahan memberi tahu Anda batas mana yang Anda capai: rate_limited untuk permintaan per menit, concurrency untuk terlalu banyak sekaligus. Saat beban sementara, balasan membawa header Retry-After: 5, jadi tunggu lima detik dan coba lagi.
- Simpan setiap skrip dengan promptnya, agar Anda dapat mereproduksi skrip yang bagus. Parameter
seedditeruskan jika Anda ingin eksekusi yang dapat direproduksi. - Pertahankan lembar gaya (frasa yang dilarang, nama karakter yang berulang, suara merek) dalam prompt sistem dan gunakan kembali di seluruh video.
- Log
X-Request-Iddari setiap respons; itu membantu ketika Anda meminta dukungan tentang panggilan API tertentu. - Baca setiap naskah sebelum menerbitkannya. Model menulis teks yang lancar, bukan fakta yang diverifikasi.
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
Prompt tidak digunakan untuk pelatihan. Konten seksual yang melibatkan anak di bawah umur tidak diizinkan, apa pun bingkainya.
Panduan lainnya
Tanya jawab
Dapatkah API ini membuat videonya sendiri?
Tidak. Ini hanya menghasilkan teks. Gunakan untuk naskah, daftar bidikan, subtitel dan teks narasi, lalu kirimkan ke alat video dan suara yang sudah Anda gunakan.
Berapa panjang skrip yang diizinkan?
Jendela konteks adalah 100.000 token untuk prompt dan balasan bersama-sama, dan max_tokens bersifat opsional, sehingga skrip yang sangat panjang muat. Untuk durasi di atas beberapa menit, langkah garis besar diikuti dengan panggilan per adegan memberikan kualitas yang lebih baik.
Apakah saya perlu membayar untuk mencobanya?
Tidak. Pengguna baru dapat mengklaim $0,50 kredit uji coba dengan satu klik di halaman kunci API setelah masuk. Pengisian ulang selanjutnya dilakukan dengan kripto (USDT di TRC20 atau USDC di Base).
Apakah akan menolak topik cerita gelap atau dewasa?
Model ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Konten yang melibatkan anak di bawah umur dalam konteks seksual tidak pernah diizinkan.
Kunci Anda hanya satu formulir lagi
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.