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 }'輪詢工作
每 20 秒輪詢一次,直到狀態變成 completed;回應中會包含 storyId 和 MP4 的 videoUrl。
curl https://www.yoh.app/api/v1/stories/jobs/JOB_ID \ -H "Authorization: Bearer $YOH_API_KEY"
為什麼好用
需要時完全掌控
先建立系列和角色陣容,再在裡面製作各集;編輯片段、重新生成單一片段的圖片或影片、從你上傳的影片開始,並輸出你選擇的時間軸。
花費可預期
每個付費請求都需要點數上限或已接受的報價。免費預覽(estimate、quoteOnly、dryRun)會在任何工作開始前告訴你價格。
為重試而設計
生成支援冪等金鑰,持久性工作可輪詢、可取消,終止狀態清楚明確。
比較想用代理?
同一個帳號和權限範圍也能透過 MCP 使用,讓 Claude 或 Codex 替你呼叫 Yoh。
常見問題
有可以用文字生成 AI 影片的 API 嗎?
有。POST /api/v1/stories/generate 接收提示詞並回傳一個工作;完成後會得到輸出好的 MP4,包含劇本、角色、配音、音樂和字幕。
API 怎麼計價?
使用和 App 相同的 Yoh 點數。每個付費請求都會註明你願意接受的最高點數,也可以先用免費的估價端點取得確切價格。
可以在不同影片中沿用同樣的角色嗎?
可以。先建立系列和角色,再在系列裡生成各集;每一集都會沿用相同的角色陣容。
完整說明在哪裡?
文件列出了所有端點、權限範圍和錯誤,並附有可即時試用的 playground。
完整說明: 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 故事做好,以及哪些規則容易出錯。