홈가이드
업데이트
AI가 대본을 작성하는 방법: 프롬프트 구조
실제로 촬영하거나 더빙할 수 있는 대본을 AI에게 작성시키는 방법을 알고 싶다면, 답은 구조에 있습니다. 모델에게 대본의 대상, 길이, 출력 형태를 알려주세요.


주요 포인트
- 모델에 역할, 단어 수, 어조, 출력 형식을 지정하세요. 누락된 항목은 모두 추측으로 이어집니다.
- 짧은 스크립트는 한 번의 호출로 충분합니다. 긴 스크립트는 먼저 개요를 작성한 후 장별로 호출해야 합니다.
- 초안에는 temperature를 약 0.8로, 수정에는 낮게 설정하세요. 명확한 종료가 필요하면 stop 시퀀스를 설정하세요.
- 100,000개의 토큰 창은 전체 개요와 이전 장들을 모두 담을 수 있으므로, 특별한 기법이 거의 필요 없습니다.
카드가 필요 없습니다. 가입 후 한 번의 클릭으로 $0.50 무료 체험 크레딧을 받습니다(인당 한 번).
API 키 받기짧은 답변: 프롬프트에 다섯 가지 부분이 필요합니다
대본이 약한 이유는 프롬프트가 약하기 때문입니다. "커피에 대한 대본을 써줘"라는 요청은 모델에게 길이, 어조, 형식, 관점을 선택하게 만듭니다. 대신 다음 다섯 가지를 제공하세요:
- 목적: 시청자가 끝부분에서 느껴야 할 감정이나 행동.
- 대상과 톤: "새로운 부모, 따뜻하고 약간 지친"이 "친근한"보다 더 잘 작동합니다.
- 길이: 단어로 표시하세요. 모델은 초보다 단어를 더 잘 세기 때문입니다. 약 150단어가 1분 분량의 말에 해당합니다.
- 형식: 시나리오, 두 열 형식의 내레이션과 시각 자료, 또는 일반 내레이션.
- 제약 조건: 피해야 할 것, 유지해야 할 이름, 필수 마지막 문장.
실제 차이입니다. 약한 프롬프트: "수면에 대한 대본을 작성하세요." 더 강력한 프롬프트: "침대에서 이메일을 확인하는 것을 멈추도록 직장인을 설득하는 50초 분량 120단어 내레이션을 작성하세요. 톤: 부드럽고 약간 유머러스함. 질문으로 시작하세요. 오늘 밤에 취할 수 있는 구체적인 행동 하나로 끝내세요. 약물 언급 금지." 두 번째 프롬프트는 약 40개의 토큰이 더 필요하지만 대부분의 수정 라운드를 제거합니다. 추가 단어를 평생 가장 저렴한 편집으로 간주하세요.
이것이 전체 방법입니다. 이 페이지의 나머지는 이를 API 호출로 전환하고 스크립트가 길 때 확장하는 방법을 보여줍니다. 빠른 테스트만 필요하면 API 키 페이지에서 신규 계정에 작은 체험 크레딧을 제공합니다.
형식을 선택하고 명시하세요
모델은 보여준 형식을 복사합니다. 두 열 형식의 대본이 필요하다면 행 하나를 보여주세요. 설명 문단보다 프롬프트의 작은 예시가 더 효과적입니다.
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."}
]
}'
Base URL이 https://api.aivideogenapi.com/v1로 설정되면 동일한 요청이 모든 OpenAI 클라이언트에서 작동합니다. 인증 및 필드 세부 사항은 문서에서 확인하세요.
대화 대본의 경우 프롬프트에 화자를 명시하고 각자에게 1줄 보이스 노트를 제공하세요("마라: 직설적이고 문장이 짧음. 일리아: 과도하게 설명함"). 그렇지 않으면 두 페이지째에는 캐릭터들이 비슷하게 들리기 쉽습니다.
결과에 영향을 주는 설정
몇 가지 매개변수가 나머지보다 더 중요합니다.
| 파라미터 | 사용 용도 | 일반적인 값 |
|---|---|---|
temperature | 어휘의 다양성 | 초안용 0.7~0.9, 수정용 0.3~0.5 |
top_p | 가능성이 낮은 단어 제거 | 0.9에서 0.95; 이 값이나 온도를 변경하세요. 둘 다 변경하지 마세요. |
max_tokens | 응답 길이의 하드 캡 | 선택 사항입니다. 비정상적 출력을 방지하고 싶을 때 설정하세요. |
stop | 마커로 종료 | 예: "END SCENE" |
frequency_penalty | 반복된 구문 감소 | 긴 스크립트용 0.2~0.5 |
seed | 반복 가능한 초안 | 모든 정수 |
이 값들은 모델에 전달됩니다. 프롬프트를 단 한 단어만 변경해도 같은 시드에서 동일한 출력을 기대하지 마세요.
짧은 대본: 하나의 호출로 충분
30~90초 분량 스크립트는 수백 단어 정도입니다. 다섯 가지 부분을 포함한 단일 요청을 보내 단일 초안을 요청하세요. 그런 다음 수정을 위해 두 번째 메시지를 사용하세요. 처음부터 재생성하는 것보다 초안 수정이 더 잘 작동하기 때문입니다.
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)
두 번째 호출에서 temperature가 낮아지는 것을 확인하세요. 수정은 탐색하기보다 지시를 따라야 합니다. 스크립트가 생성되는 과정을 보려면 stream: true를 추가하고 청크가 도착할 때마다 출력하세요. 사용량 합계는 스트림 끝에 표시됩니다. 스트리밍 요청은 완료될 때까지 동시 요청 슬롯 중 하나를 점유하므로 병렬로 여러 초안을 실행할 때 중요합니다. 전체 키는 동시에 8개를 허용합니다.
긴 대본: 먼저 개요 작성, 이후 막별 생성
한 번에 4,000단어를 요청하면 중간부가 늘어집니다: 모델이 끝부분을 서두르고 아이디어를 반복하며 작은 사실을 잊어버립니다. 더 나은 패턴은 세 단계로 구성됩니다.
1단계: 개요 작성
장당 한 문장, 각 장면의 목적, 일관되게 유지해야 할 사실들의 누적 목록(이름, 장소, 각 등장인물이 아는 내용)이 포함된 번호가 매겨진 개요를 요청하세요. 이를 직접 수정하세요. 이것이 이야기를 수정하는 가장 저렴한 방법입니다.
2단계: 막별 작성
각 장에 대해 개요, 스타일 규칙, 이전 장들의 짧은 요약, 마지막 장의 전체 텍스트를 보내세요. 다음 장만 요청하세요.
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
3단계: 통독
전체 대본을 다시 보내고 수정이 아닌 모순과 반복된 문장의 목록을 요청하세요. 그런 다음 타겟팅된 수정으로 이를 수정하세요.
100,000개 토큰 창 사용
프롬프트와 응답을 합하면 100,000개 토큰, 약 70,000단어에 달할 수 있습니다. 전체 개요, 스타일 가이드, 극장용 대본의 완성된 모든 막이 여유 있게 들어갑니다. 이는 요약문을 생략하고 지금까지의 전체 스토리를 그대로 보내도 된다는 의미로, 작은 디테일을 그대로 유지할 수 있습니다.
두 가지 주의사항이 있습니다. 첫째, 각 호출이 이력을 다시 보내기 때문에 비용이 증가합니다. 둘째, 매우 긴 프롬프트에서도 가장 중요한 지시사항이 요청 근처 끝에 위치할 때 가장 잘 작동합니다. 참조 자료 뒤에 현재 작업을 마지막에 배치하세요. 컨텍스트 창 페이지에서 긴 입력을 구성하는 방법에 대해 더 자세히 알아보세요.
막으로 구성된 10분 분량 대본의 가격 확인: 호출이 입력 토큰 6,000개와 출력 토큰 4,000개를 합산한다고 가정하세요. 입력의 경우 6,000 / 1,000,000 x $0.15 = $0.0009, 출력의 경우 4,000 / 1,000,000 x $0.50 = $0.002이므로 총 $0.0029입니다. 가격은 가격 페이지에 나열되어 있습니다.
일반적인 문제 및 해결 방법
- 스크립트가 너무 길거나 짧습니다. 단어 범위를 명시하고 중지 지점을 추가하세요. 코드에서 단어 수를 확인하고 정확한 숫자로 자르도록 요청하세요.
- 모든 장면이 같은 방식으로 시작합니다. 빈도 패널티를 추가하고 "장면 시작 방식을 다양하게 하세요; 두 장면을 소음이나 날씨 세부 사항으로 시작하지 마세요."라는 문장을 추가하세요.
- 어조가 흐트러집니다. 대상 목소리의 샘플 줄 두 개를 시스템 메시지에 붙여넣고 모델이 이를 재사용할 텍스트가 아닌 스타일 참조라고 알려주세요.
- 연기 지시가 내레이션에 유출됩니다. 내레이션과 시각 자료가 하나의 문자열을 공유하지 않도록
response_format이json_object로 설정된 JSON 모드와 함께 별도의 필드를 요청하세요. - HTTP 429. 한도에 도달했습니다. 코드
rate_limited은 분당 요청 수가 많음을,concurrency은 동시 요청이 많음을 의미합니다. 기다렸다가 다시 시도하세요.
더 많은 가이드
질문과 답변
영상 1분당 몇 단어를 요청해야 하나요?
차분한 속도로 분당 약 150개의 단어를 예상하세요. 빠른 소셜 클립은 170개 이상일 수 있으므로 실제 보이스오버로 테스트해 보세요.
전체 스크립트를 한 번의 요청으로 생성해야 하나요?
약 800단어 미만이라면 가능합니다. 더 긴 스크립트의 경우 먼저 개요를 작성하고 매번 개요와 마지막 장을 전달하며 장별로 생성하세요.
모델은 요청 간에 기억을 유지합니까?
아니요. 각 요청은 독립적이므로, 모델이 볼 메시지를 원하시는 대로 메시지 목록에 전달하세요.
어두운 또는 성숙한 픽션 스크립트를 작성할 수 있습니까?
이 모델은 합법적인 성인 사용에 대한 콘텐츠 거부 없이 답변하도록 튜닝되었습니다. 미성년자가 관련된 성 콘텐츠는 절대 허용되지 않습니다.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.