KO ▾
API 키 받기

홈가이드

업데이트

AI가 대본을 작성하는 방법: 프롬프트 구조

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

개요 우선 대본 작성을 보여주는 스크립트 페이지 스택과 클랩보드로 연결된 노트 타일
에이전트의 컨텍스트 창을 나타내는 것처럼 화살표 루프가 빛나는 블록이 채워지는 유리 용기

주요 포인트

  1. 모델에 역할, 단어 수, 어조, 출력 형식을 지정하세요. 누락된 항목은 모두 추측으로 이어집니다.
  2. 짧은 스크립트는 한 번의 호출로 충분합니다. 긴 스크립트는 먼저 개요를 작성한 후 장별로 호출해야 합니다.
  3. 초안에는 temperature를 약 0.8로, 수정에는 낮게 설정하세요. 명확한 종료가 필요하면 stop 시퀀스를 설정하세요.
  4. 100,000개의 토큰 창은 전체 개요와 이전 장들을 모두 담을 수 있으므로, 특별한 기법이 거의 필요 없습니다.

카드가 필요 없습니다. 가입 후 한 번의 클릭으로 $0.50 무료 체험 크레딧을 받습니다(인당 한 번).

API 키 받기

짧은 답변: 프롬프트에 다섯 가지 부분이 필요합니다

대본이 약한 이유는 프롬프트가 약하기 때문입니다. "커피에 대한 대본을 써줘"라는 요청은 모델에게 길이, 어조, 형식, 관점을 선택하게 만듭니다. 대신 다음 다섯 가지를 제공하세요:

  1. 목적: 시청자가 끝부분에서 느껴야 할 감정이나 행동.
  2. 대상과 톤: "새로운 부모, 따뜻하고 약간 지친"이 "친근한"보다 더 잘 작동합니다.
  3. 길이: 단어로 표시하세요. 모델은 초보다 단어를 더 잘 세기 때문입니다. 약 150단어가 1분 분량의 말에 해당합니다.
  4. 형식: 시나리오, 두 열 형식의 내레이션과 시각 자료, 또는 일반 내레이션.
  5. 제약 조건: 피해야 할 것, 유지해야 할 이름, 필수 마지막 문장.

실제 차이입니다. 약한 프롬프트: "수면에 대한 대본을 작성하세요." 더 강력한 프롬프트: "침대에서 이메일을 확인하는 것을 멈추도록 직장인을 설득하는 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을 변경하세요. 설정은 이것으로 끝입니다.

API 키 받기