AI 영상 생성 API
프롬프트를 보내면 완성 영상이 돌아옵니다. Yoh가 대본을 쓰고, 일관된 캐릭터를 캐스팅하고, 음성·음악·자막을 넣어 MP4로 렌더링합니다. 스토리, 시리즈, 클립, 캐릭터, 타임라인, 렌더링을 단계별로 직접 제어할 수도 있습니다.
호출 세 번으로 첫 영상 만들기
키 만들기
로그인한 뒤 Settings → API keys를 열고 stories:generate와 stories:read 권한으로 키를 만드세요. 키는 한 번만 표시되니 서버 측 시크릿에 보관하세요. 확인해 보세요:
curl https://www.yoh.app/api/v1/credits \ -H "Authorization: Bearer $YOH_API_KEY"생성
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 }'작업 폴링
상태가 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
다른 연결 방법
- Claude로 AI 영상 만들기Claude를 Yoh 계정에 연결하고 요청만으로 영상 스토리를 만드세요. Claude가 대본을 쓰고, 캐릭터를 일관되게 유지하고, 클립을 생성하고, 타임라인을 편집하고, 완성 영상을 렌더링합니다. 크레딧이 드는 작업은 먼저 확인을 받습니다.
- Codex로 AI 영상 만들기Codex를 Yoh에 연결하고 터미널이나 편집기에서 영상 스토리를 만들게 하세요. 대본, 캐스팅, 클립, 음성, 자막, 최종 렌더링까지 하며, 유료 단계마다 가격을 보여 주고 승인을 받습니다.
- AI 영상을 위한 Yoh MCP 서버원격 MCP 엔드포인트 하나로 어떤 에이전트든 Yoh 스튜디오 전체를 쓸 수 있습니다. 스토리를 쓰고, 캐릭터를 캐스팅해 그리고, 음성과 음악이 들어간 클립 영상을 생성하고, 타임라인과 자막을 편집하고, 렌더링해 게시합니다. 모든 도구는 yoh.app 편집기와 같은 규칙을 따릅니다.
- AI 에이전트를 위한 Yoh 스킬MCP 서버는 에이전트에게 도구를 주고, 스킬은 다루는 요령을 가르칩니다. 공개 Agent Skills 형식의 SKILL.md가 Yoh 스토리를 잘 만드는 방법과 놓치기 쉬운 규칙을 에이전트에게 알려 줍니다.