본문으로 건너뛰기

Codex로 AI 영상 만들기

Codex를 Yoh에 연결하고 터미널이나 편집기에서 영상 스토리를 만들게 하세요. 대본, 캐스팅, 클립, 음성, 자막, 최종 렌더링까지 하며, 유료 단계마다 가격을 보여 주고 승인을 받습니다.

가장 쉬운 방법: AI에게 설정을 맡기세요Claude Code, Codex 또는 Cursor에 프롬프트 하나를 붙여 넣으세요. macOS, Linux, Windows에서 Yoh를 설치하고 로그인까지 안내합니다.

Codex 연결하기

  1. 서버 추가 후 로그인

    Codex CLI, IDE 확장, ChatGPT 데스크톱 앱에서 모두 작동합니다. 열리는 브라우저에서 Yoh에 로그인하세요.

    codex mcp add yoh --url https://www.yoh.app/api/mcp
    codex mcp login yoh
  2. 오래 걸리는 단계에 시간 주기

    Yoh의 일부 단계는 몇 분이 걸립니다. 도구 타임아웃을 300초로 설정한 뒤 Codex를 다시 시작하세요.

    ~/.codex/config.toml
    [mcp_servers.yoh]
    url = "https://www.yoh.app/api/mcp"
    tool_timeout_sec = 300
    startup_timeout_sec = 20
  3. Yoh 스킬 추가(권장)

    스킬(SKILL.md와 참고 파일, 보조 스크립트를 한 폴더로 설치)은 에이전트에게 Yoh 스토리를 잘 만드는 방법을 알려 줍니다. 시리즈 안에서 시작하고, 쓰기 전에 견적을 받고, 클립을 직접 본 뒤 판단하게 합니다. 서버와 함께 계속 업데이트됩니다. Codex에서는 $yoh로 호출합니다.

    (
      set -eu
      skill_dir="$HOME/.agents/skills/yoh"
      if [ -e "$skill_dir" ]; then
        printf '%s\n' 'Yoh skill already exists. Use the setup prompt to check or update it.' >&2
        exit 1
      fi
      mkdir -p "$skill_dir/references" "$skill_dir/scripts"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/SKILL.md' --output "$skill_dir/SKILL.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/browser-workflow.md' --output "$skill_dir/references/browser-workflow.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/checking-clips.md' --output "$skill_dir/references/checking-clips.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/common-jobs.md' --output "$skill_dir/references/common-jobs.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/editing-clips.md' --output "$skill_dir/references/editing-clips.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/errors-and-refusals.md' --output "$skill_dir/references/errors-and-refusals.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/generation-and-pricing.md' --output "$skill_dir/references/generation-and-pricing.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/gotchas.md' --output "$skill_dir/references/gotchas.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/hires-ads-publishing.md' --output "$skill_dir/references/hires-ads-publishing.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/lines-and-voices.md' --output "$skill_dir/references/lines-and-voices.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/looks-and-assets.md' --output "$skill_dir/references/looks-and-assets.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/mcp-tool-index.md' --output "$skill_dir/references/mcp-tool-index.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/recipes.md' --output "$skill_dir/references/recipes.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/setup-and-clients.md' --output "$skill_dir/references/setup-and-clients.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/stories-and-scripts.md' --output "$skill_dir/references/stories-and-scripts.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/timeline-analysis.md' --output "$skill_dir/references/timeline-analysis.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/timeline-and-edit-mode.md' --output "$skill_dir/references/timeline-and-edit-mode.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/upload-and-cut.md' --output "$skill_dir/references/upload-and-cut.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/writing-clips.md' --output "$skill_dir/references/writing-clips.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/scripts/download_timeline_analysis.py' --output "$skill_dir/scripts/download_timeline_analysis.py"
    )
  4. 연결 확인

    에이전트에게 get_credits를 실행해 달라고 하세요. Yoh 크레딧 잔액이 나오면 정상입니다. Claude Code나 Codex에서 /mcp를 실행하면 서버 상태를 볼 수 있습니다.

그다음 요청만 하세요

  • “유령의 목소리를 듣는 야간 근무 간호사 이야기를 60초 영상으로 만들어 주세요.”
  • “이 대본을 5화짜리 시리즈로 만들고, 그림을 그리기 전에 캐스팅부터 보여 주세요.”
  • “3화를 다듬어 주세요. 빈 구간을 잘라 내고 자막을 박자에 맞춘 다음 렌더링 견적을 알려 주세요.”
  • “4번 클립의 주인공을 제 캐릭터로 바꾸고 그 클립 영상만 다시 만들어 주세요.”

잘 작동하는 이유

승인 없이는 결제되지 않습니다

보기와 편집은 무료입니다. 크레딧이 드는 단계(그림 그리기, 클립 영상 생성, 렌더링)는 모두 먼저 가격을 알려 줍니다. 에이전트가 가격을 보여 주고 승인한 뒤에만 진행하며, 같은 승인으로 두 번 결제되지 않습니다.

셸 기록에 키가 남지 않습니다

codex mcp login은 Yoh로 로그인합니다. CI에서는 대신 환경 변수에 API 키를 넣어 쓰세요(bearer_token_env_var = "YOH_API_KEY").

앱과 같은 스토리, 같은 규칙

에이전트는 yoh.app에서 보는 것과 같은 스토리, 클립, 타임라인을 편집기와 같은 규칙으로 다룹니다. 터미널에서 한 편집은 브라우저에서 드래그한 것과 정확히 같은 자리에 반영되고, 열린 페이지는 몇 초 안에 업데이트됩니다.

브라우저에서 확인

ChatGPT 데스크톱 앱에서는 Codex가 바꾼 yoh.app 페이지를 브라우저로 열어 화면에서 결과를 확인할 수 있습니다.

자주 묻는 질문

Codex로 영상을 만들 수 있나요?

네, Yoh MCP 서버를 연결하면 됩니다. Codex가 Yoh 도구를 호출해 스토리를 쓰고, 클립을 하나씩 생성하고, 최종 영상을 Yoh 계정에 렌더링합니다.

어떤 Codex 클라이언트를 지원하나요?

Codex CLI, Codex IDE 확장, ChatGPT 데스크톱 앱의 Codex입니다. 모두 ~/.codex/config.toml을 함께 씁니다.

CI에서 헤드리스로 실행할 수 있나요?

네. Settings → API keys에서 API 키를 만들어 YOH_API_KEY로 export하고, [mcp_servers.yoh] 아래에 bearer_token_env_var = "YOH_API_KEY"를 설정하세요. 유료 단계에는 여전히 견적에서 받은 명시적 승인 토큰이 필요합니다.

ChatGPT에서도 되나요?

네. ChatGPT에서 같은 주소로 Yoh라는 이름의 커스텀 MCP 서버를 추가하고 로그인하세요. 일부 플랜에서는 관리자가 커스텀 서버를 허용해야 합니다.

전체 레퍼런스: Yoh 문서 · 요금

다른 연결 방법