FastMetal

動画生成

テキストプロンプトから短い動画を生成します。動画生成は非同期です。ジョブを送信し、ステータスをポーリングし、完成したMP4をダウンロードします。各モデルは固定仕様で描画し、1本あたり定額で課金されます。

モデルと料金

各モデルの設定はサーバー側で固定されており、送信が受理された時点で1本あたりの定額が課金されます:

モデル出力料金シード作成エンドポイント
Seedance 2.0 Fast
bytedance/seedance-2.0-fast		8秒・1280x720・音声付き¥250／本整数を指定可能/openrouter/videos/create

各モデルには専用の作成エンドポイントがあります(上表参照)。ジョブのステータス確認とダウンロードのエンドポイントは全モデル共通です。

POST
/openrouter/videos/.../create

1. ジョブを送信

上表のモデル別作成エンドポイントに、プロンプト(およびモデルが対応していれば任意の整数シード)をPOSTします。送信が成功するとHTTP 202とジョブIDが返ります。例はデフォルトモデルのエンドポイントを使用しています。

Request
curl https://api.fastmetal.ai/openrouter/videos/create \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d {"prompt": "木の机の上で折り鶴がひとりでに折り上がる、柔らかな朝の光"}
Response (202)
{
  "id": "AbCdEf123456",
  "status": "pending",
  "poll_path": "/openrouter/videos/jobs/AbCdEf123456"
}
GET
/openrouter/videos/jobs/{id}

2. 完了をポーリングする

15〜30 秒ごとにジョブをポーリングしてください。生成には通常 1〜3 分かかります。ステータス: pending、in_progress、completed、failed。

Request
curl https://api.fastmetal.ai/openrouter/videos/jobs/AbCdEf123456 \
  -H "Authorization: Bearer YOUR_API_KEY"
Response
{
  "id": "AbCdEf123456",
  "status": "completed",
  "poll_path": "/openrouter/videos/jobs/AbCdEf123456",
  "content_path": "/openrouter/videos/jobs/AbCdEf123456/content"
}
GET
/openrouter/videos/jobs/{id}/content

3. 動画をダウンロードする

completed になったら、content パスから MP4 をダウンロードします。生成された動画の保持期間は限られているため、早めにダウンロードしてください。

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

課金

  • 受理された送信(HTTP 202)1回ごとに、各モデルの定額がキーの残高から差し引かれます。
  • ポーリングとダウンロードは無料です。拒否された送信(HTTP 4xx/5xx)も課金されません。
  • 202を受け取った後は再送しないでください。受理された送信ごとに課金されます。エラーレスポンス(4xx/5xx)を受け取った場合は課金されておらず、安全に再試行できます。レスポンスを一切受け取れなかった場合(タイムアウトや接続断)は結果が不明です。送信がすでに受理・課金されている可能性があるため、むやみに再送しないでください。
  • ジョブが受理された後にステータスが「failed」になった場合は、ジョブIDを添えてサポートにご連絡ください。サービスクレジットで対応します。

制限

  • 各モデルの長さ・解像度・音声はサーバー側で固定されています。異なる値を指定したリクエストはHTTP 400で拒否されます。
  • プロンプトは2,000文字までです。
  • 動画生成はプラットフォーム全体でレート制限されています。HTTP 429の場合は少し待って再試行してください。