動画生成に対応しました：API・チャット・MCP の3つの経路から使えます

テキストから短い動画を生成する機能に対応しました。API・ブラウザのチャット・MCP の 3 つの経路から、同じ 1 つの API キーで使えます。料金は 1 本あたりの定額で、生成を待つ間のポーリングやダウンロードに追加料金はかかりません。

生成される動画

長さや解像度を選ぶ方式ではなく、固定の仕様で 1 本生成されます。

• モデル: ByteDance Seedance 2.0 Fast
• 長さ: 8 秒
• 解像度: 1280×720（16:9）、音声付き
• 料金: 1 本あたり定額 ¥250（送信が受理された時点で課金）

生成には通常 1〜3 分かかります。固定仕様にしているのは、料金を 1 本いくらで確定させるためです。長さや解像度をリクエストごとに変えられる方式だと、実際に請求される額が投げてみるまで分かりません。

1. API から

ジョブを送信し、完了をポーリングして、MP4 をダウンロードする非同期の流れです。

curl https://api.fastmetal.ai/openrouter/videos/create \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "木の机の上で折り鶴がひとりでに折り上がる、柔らかな朝の光"}'

受理されると HTTP 202 とジョブ ID が返ります。

{
  "id": "AbCdEf123456",
  "status": "pending",
  "poll_path": "/openrouter/videos/jobs/AbCdEf123456"
}

15〜30 秒ごとにジョブをポーリングし、completed になったら MP4 を取得します。

curl https://api.fastmetal.ai/openrouter/videos/jobs/AbCdEf123456/content?index=0 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o video.mp4

2. チャットから

ブラウザのチャットに「動画」モードを追加しました。プロンプトを書いて送信すると、生成された動画がその会話に添付として保存されます。生成中にページを離れても、会話を開き直せば処理の確認が再開されます。

なお、暗号化された会話では動画生成は利用できません。生成された大きなファイルをブラウザ側で暗号化する仕組みが整うまでは、平文で保存される経路を暗号化チャットに混ぜない方針にしています。

3. MCP から

MCP サーバーに動画用のツールを追加しました。Claude Code や Codex などのエージェントから、セッションを抜けずに動画を作れます。

• generate_video — プロンプトから動画を生成します。一定時間だけ完成を待ち、間に合えばダウンロードリンクを、間に合わなければジョブ ID を返します。
• get_video — 続きを確認します。完成済みの動画に対しては、期限切れのリンクを再発行します。

生成は数分かかるため、待ちきれない場合にジョブ ID で再開できる 2 段構えにしています。課金は最初の送信の 1 回だけで、get_video の呼び出しは何度でも無料です。1 キーあたりの 1 日の生成本数には上限があります。

課金について

• 定額料金は、送信が受理される（HTTP 202）たびに 1 回だけ引かれます。ポーリングとダウンロードは無料です。
• 拒否された送信（HTTP 4xx / 5xx）は課金されません。202 を受け取れていないリクエストは、安全に再試行できます。
• 逆に、202 を受け取った後の再送は別の 1 本として課金されます。リトライ処理を書くときはここに注意してください。
• 受理されたジョブが後から failed になった場合は、ジョブ ID を添えてサポートまでご連絡ください。サービスクレジットを付与します。

パラメータやレスポンスの詳細は動画生成ガイドにまとめています。料金と対応モデルは /pricing と /models からご確認ください。