動画生成

モデルと料金

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

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

1. ジョブを送信

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

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

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

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

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

curl https://api.fastmetal.ai/v1/videos/jobs/AbCdEf123456 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "AbCdEf123456",
  "status": "completed",
  "poll_path": "/v1/videos/jobs/AbCdEf123456",
  "content_path": "/v1/videos/jobs/AbCdEf123456/content"
}

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

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

curl https://api.fastmetal.ai/v1/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の場合は少し待って再試行してください。