본문으로 건너뛰기

AI 영상 생성 API

프롬프트를 보내면 완성 영상이 돌아옵니다. Yoh가 대본을 쓰고, 일관된 캐릭터를 캐스팅하고, 음성·음악·자막을 넣어 MP4로 렌더링합니다. 스토리, 시리즈, 클립, 캐릭터, 타임라인, 렌더링을 단계별로 직접 제어할 수도 있습니다.

호출 세 번으로 첫 영상 만들기

  1. 키 만들기

    로그인한 뒤 Settings → API keys를 열고 stories:generate와 stories:read 권한으로 키를 만드세요. 키는 한 번만 표시되니 서버 측 시크릿에 보관하세요. 확인해 보세요:

    curl https://www.yoh.app/api/v1/credits \
      -H "Authorization: Bearer $YOH_API_KEY"
  2. 생성

    X-Max-Generation-Credits가 동의 표시입니다. 이 요청에 허용하는 최대 크레딧이죠. 가격이 더 높으면 HTTP 409와 견적이 돌아오고 아무것도 청구되지 않습니다. 같은 Idempotency-Key를 다시 쓰면 안전하게 재시도할 수 있습니다.

    curl -X POST https://www.yoh.app/api/v1/stories/generate \
      -H "Authorization: Bearer $YOH_API_KEY" \
      -H "X-Max-Generation-Credits: 500" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: my-first-video-1" \
      -d '{ "prompt": "A dragon teaches a young knight how to fly", "contentType": "cinematic_story", "aspectRatio": "16:9", "scope": "full", "renderVideo": true }'
  3. 작업 폴링

    상태가 completed가 될 때까지 20초마다 확인하세요. 응답에 storyId와 MP4의 videoUrl이 들어 있습니다.

    curl https://www.yoh.app/api/v1/stories/jobs/JOB_ID \
      -H "Authorization: Bearer $YOH_API_KEY"

잘 작동하는 이유

필요할 때는 완전한 제어

시리즈와 출연진을 한 번 만들고 그 안에서 에피소드를 만드세요. 클립을 편집하고, 클립 하나의 그림이나 영상만 다시 생성하고, 직접 올린 영상에서 시작하고, 원하는 타임라인을 렌더링할 수 있습니다.

예측 가능한 지출

유료 요청에는 모두 크레딧 상한이나 승인된 견적이 필요합니다. 무료 미리보기(estimate, quoteOnly, dryRun)로 시작 전에 가격을 알 수 있습니다.

재시도를 고려한 설계

생성 요청의 멱등 키, 폴링하고 취소할 수 있는 지속형 작업, 명확한 종료 상태를 제공합니다.

에이전트가 더 편하다면

같은 계정과 scope가 MCP에서도 작동하므로 Claude나 Codex가 대신 Yoh를 호출할 수 있습니다.

자주 묻는 질문

텍스트로 AI 영상을 생성하는 API가 있나요?

네. POST /api/v1/stories/generate에 프롬프트를 보내면 작업이 반환되고, 작업이 끝나면 대본, 캐릭터, 음성, 음악, 자막이 들어간 MP4를 받습니다.

API 요금은 어떻게 되나요?

앱과 같은 Yoh 크레딧을 씁니다. 유료 요청마다 허용하는 최대 크레딧을 지정하며, 무료 견적 엔드포인트로 정확한 가격을 먼저 확인할 수 있습니다.

여러 영상에서 같은 캐릭터를 유지할 수 있나요?

네. 캐릭터와 함께 시리즈를 한 번 만들고 그 안에서 에피소드를 생성하세요. 모든 에피소드가 같은 출연진을 다시 씁니다.

전체 레퍼런스는 어디에 있나요?

문서에서 모든 엔드포인트, scope, 오류를 라이브 플레이그라운드와 함께 볼 수 있습니다.

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

다른 연결 방법