FastMetal

動画生成

ByteDance Seedance 2.0 Fast を使用して、テキストプロンプトから短い動画を生成できます。動画生成は非同期処理です。ジョブを送信し、ステータスをポーリングして、完成した MP4 をダウンロードします。

生成される動画

1 回の生成につき、以下の固定設定の動画が 1 本作成され、動画ごとの定額料金で課金されます。

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

1. ジョブを送信する

プロンプト（および任意の整数 seed）を 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 を受信した後は再送しないでください。受理された送信はそれぞれ課金されます。202 を受信していない場合、そのリクエストは課金されていないため、安全に再試行できます。
  • 受理されたジョブが後に「failed」になった場合は、ジョブ ID を添えてサポートまでご連絡ください。サービスクレジットを付与します。

制限事項

  • 長さ・解像度・モデルは固定です。他の値を指定したリクエストは HTTP 400 で拒否されます。
  • プロンプトは 2,000 文字までです。
  • 動画生成にはプラットフォーム全体のレート制限があります。HTTP 429 が返った場合は、少し待ってから再試行してください。