홈가이드
업데이트
LLM API 기반 AI 영상 대본 생성기
AI 영상 대본 생성기는 프롬프트가 잘 구성된 텍스트 모델입니다. 이 가이드는 Python 템플릿과 실제 대본별 비용을 포함하여 OpenAI 호환 API에서 이를 구축하는 방법을 보여줍니다.


주요 포인트
- API는 대본, 샷 리스트 및 보이스오버 텍스트 등 텍스트만 생성합니다. 영상을 렌더링하지 않습니다.
- JSON을 요청하여 각 장면이 편집기나 영상 도구가 읽을 수 있는 필드에 배치되도록 하세요.
- 샷 리스트가 포함된 60초 분량 스크립트의 비용은 토큰 100만 개당 $0.15와 $0.50 기준 약 10분의 1센트 수준입니다.
- 프롬프트에 간결한 설명, 톤, 이전 장면 정보를 포함하세요. 컨텍스트 창은 100,000 토큰입니다.
카드가 필요 없습니다. 가입 후 한 번의 클릭으로 $0.50 무료 체험 크레딧을 받습니다(인당 한 번).
API 키 받기대본 생성기가 실제로 수행하는 작업
AI 영상 대본 생성기는 짧은 아이디어를 입력받아 영상에 필요한 텍스트(후크, 장면, 내레이션, 화면 텍스트 및 시각적 참고 사항)를 반환합니다. 모델이 작문을 수행하고, 귀하의 코드가 나머지 작업을 처리합니다. 프롬프트를 구성하고 전송하며, 응답을 확인하고 이미지를 생성하는 도구에 각 부분을 전달합니다.
이 API는 텍스트 전용입니다. 이미지, 오디오 또는 영상을 생성하지 않습니다. 이는 작업에 잘 부합합니다. 영상 프로젝트의 대부분이 스크립트 단계에서 막히기 때문이며, 이 단계는 자동화 비용이 가장 저렴하기 때문입니다. 이미지와 목소리는 기존에 사용하던 다른 도구에서 제공됩니다. 독립적인 제공업체가 운영하는 이 모델은 합법적인 성인용 사용에 대해 콘텐츠 거부 없이 응답하도록 조정되어 있어, 성숙한 픽션, 공포물, 범죄물 또는 다크 코미디를 다루는 스크립트에 중요합니다. 텍스트가 영상 파이프라인에서 어떻게 활용되는지 더 넓은 관점에서 알고 싶다면 AI 영상 API 가이드를 참조하세요.
한 번의 호출로 세 가지 출력을 요청하는 것이 좋습니다: 보이스오버 텍스트(내레이터가 말하는 내용), 샷 리스트(시청자가 보는 내용) 및 장면별 시간 추정치입니다. 이를 별도의 필드로 나누면 이후 단계를 단순화할 수 있습니다.
클라이언트 설정
엔드포인트는 OpenAI 호환이므로 표준 SDK가 작동합니다. API 키 페이지에서 키를 발급받은 후, 클라이언트를 베이스 URL로 설정하고 모델 ID 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)
curl이나 Node에서도 베이스 URL과 키만 변경하면 동일한 요청이 작동합니다. 전체 파라미터 설명은 API 문서에서 확인할 수 있습니다. 신규 계정은 키 페이지에서 한 번의 클릭으로 $0.50의 체험 크레딧을 청구할 수 있으며, 이는 이 문서의 모든 내용을 여러 번 테스트하기에 충분합니다.
사용 가능한 장면을 반환하는 프롬프트 템플릿
모호한 요청은 모호한 대본을 생성합니다. 좋은 템플릿은 네 가지 요소를 명확히 합니다: 대상, 길이, 어조 및 출력 형식. 규칙은 시스템 메시지에, 아이디어는 사용자 메시지에 넣으세요.
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 모드(response_format에 json_object 적용)는 응답이 파싱 가능하도록 유지합니다. 모든 모델은 간헐적으로 깨진 문자열을 생성할 수 있으므로, json.loads를 try 블록으로 감싸고 실패 시 한 번 재시도하세요. 0.7~0.9의 temperature는 다양한 단어 선택을 제공하며, 배치 전체에서 구조를 거의 동일하게 유지해야 할 때는 0.3으로 낮추세요.
신뢰하기 전에 길이를 확인하세요
모델은 초를 세는 데 서툴러합니다. 신뢰할 만한 규칙은 차분한 내레이터의 경우 분당 약 150단어, 빠른 소셜 클립의 경우 그보다 약간 더 많습니다. 각 호출 후 모든 보이스오버 필드의 단어 수를 세고 목표와 비교하세요.
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.")
대본이 너무 길면 실제 숫자를 포함한 두 번째 메시지를 보내세요. "보이스오버는 약 78초가 소요됩니다. 후크를 잃지 않고 60초로 줄이세요."와 같이요. 구체적인 피드백이 "더 짧게 해줘"보다 더 효과적입니다. 모델이 자신이 작성한 내용을 볼 수 있도록 메시지 목록에 첫 번째 응답을 유지하세요.
별도의 단계로 샷 리스트와 보이스오버 생성
긴 영상의 경우 모든 것을 한 번에 요청하면 품질이 떨어집니다. 대신 두 단계로 진행하세요. 먼저 장면 제목과 한 줄 목표의 개요를 요청하세요. 그런 다음 각 장면을 별도의 호출로 생성하며, 개요와 이전 장면의 보이스오버를 전달하여 어조를 유지하세요.
- 1단계, 개요: 6~12개의 장면, 각 장면에는 목표와 대략적인 지속 시간을 포함하세요.
- 2단계, 장면: 개요와 컨텍스트에 포함된 마지막 두 장면을 바탕으로 한 번에 한 장면의 보이스오버와 샷을 생성하세요.
- 3단계, 다듬기: 전체 보이스오버를 다시 읽고 반복되는 구문이 다양하게 표현되도록 요청하세요.
프롬프트와 응답을 합쳐 컨텍스트 창이 100,000 토큰이므로, 전체 개요가 포함된 20분 분량 다큐멘터리 스크립트도 한 번의 대화로 처리됩니다. 긴 세션에서 메모리 동작 방식에 대해서는 컨텍스트 창 페이지에서 실용적인 한계를 다루고 있습니다. 스크립트가 작성되는 대로 사람에게 보여줄 경우 스트리밍(stream: true)이 유용합니다.
스크립트 비용
가격은 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50이며 선불 크레딧에서 차감됩니다. 샷 리스트가 포함된 일반적인 60초 분량 대본을 가정해 봅시다. 프롬프트가 1,200 토큰(규칙과 아이디어 포함), 응답이 1,800 토큰이라고 가정합니다.
| 파트 | 토큰 | 수학 | 비용 |
|---|---|---|---|
| 입력 | 1,200 | 1,200 / 1,000,000 x $0.15 | $0.00018 |
| 출력 | 1,800 | 1,800 / 1,000,000 x $0.50 | $0.0009 |
| 합계 | 3,000 | $0.00108 |
대본당 비용은 약 0.1센트입니다. 1,000개의 대본을 생성하는 채널은 모델 사용료로 약 $1.08이 발생합니다. 재시도 및 다듬기 과정이 추가되지만, 대본당 3번의 호출을 하더라도 스크립트당 비용은 약 1센트 수준으로 유지됩니다. 실패하거나 거부된 요청에는 요금이 부과되지 않습니다. 크레딧은 만료되지 않으며, 요금제 페이지에는 $20부터 $500까지의 충전 금액과 보너스 등급이 명시되어 있습니다.
각 응답의 usage 필드는 정확한 토큰 수를 제공하므로, 추정치가 아닌 대본별 실제 비용을 로깅할 수 있습니다.
시간을 절약할 수 있는 한도 및 습관
일반 키는 동시 요청 8개와 분당 300개 요청을 허용합니다. 체험 키는 동시 요청 2개, 분당 요청 60개를 허용합니다. 여러 스크립트를 배치할 때는 4~6개의 작은 워커 풀을 사용하고 HTTP 429 응답이 나타나면 백오프하세요. 오류 코드는 도달한 한도를 알려줍니다: 분당 요청 수는 rate_limited, 동시 요청 과다는 concurrency로 표시됩니다. 일시적 과부하 시 Retry-After: 5 헤더가 응답에 포함되므로 5초 후 다시 시도하세요.
- 좋은 프롬프트를 재현할 수 있도록 스크립트와 프롬프트를 모두 저장하세요.
seed매개변수는 재현 가능한 실행을 원할 경우 전달됩니다. - 시스템 프롬프트에 스타일 시트(금지된 어구, 반복되는 캐릭터 이름, 브랜드 톤)를 저장하고 여러 영상에서 재사용하세요.
- 각 응답에서
X-Request-Id를 기록하세요. 이는 특정 호출과 관련해 지원팀에 문의할 때 도움이 됩니다. - 게시하기 전에 모든 스크립트를 확인하세요. 모델은 검증된 사실이 아닌 유창한 텍스트를 생성합니다.
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
프롬프트는 학습에 사용되지 않습니다. 미성년자가 포함된 성적인 콘텐츠는 어떤 방식으로 제시되든 허용되지 않습니다.
더 많은 가이드
질문과 답변
이 API로 영상 자체를 생성할 수 있나요?
아니요. 텍스트만 생성합니다. 대본, 샷 리스트, 자막 및 보이스오버 텍스트를 생성한 후, 기존에 사용하던 영상 및 음성 도구로 전달하세요.
스크립트는 얼마나 길게 작성할 수 있나요?
프롬프트와 응답을 합쳐 컨텍스트 창이 100,000 토큰이며 max_tokens는 선택 사항이므로 매우 긴 대본도 수용됩니다. 몇 분 이상인 경우 개요 생성 후 장면별 호출이 더 나은 품질을 제공합니다.
서비스를 사용해 보시려면 비용을 지불해야 하나요?
아니요. 신규 사용자는 회원가입 후 API 키 페이지에서 한 번의 클릭으로 무료 체험 크레딧 $0.50을 받을 수 있습니다. 이후 충전은 암호화폐(트론 네트워크 TRC20의 USDT 또는 베이스 네트워크의 USDC)로 진행됩니다.
어두운 주제나 성숙한 스토리를 거부하나요?
이 모델은 합법적인 성인 사용에서 콘텐츠 거부 없이 응답하도록 조정되었습니다. 미성년자가 성적인 맥락에 포함된 콘텐츠는 절대 허용되지 않습니다.
키는 폼 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.