跳至主要內容

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. 輪詢工作

    每 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

其他連接方式