ナビゲーションにスキップ

BeatAPI Video API

Video API

安定した BeatAPI モデル ID で、非同期の動画生成タスクを作成します。

モデル入力モード必須項目主な設定
minimax-h3元の ID。Fast の仕様と料金を維持model、prompt4–15 秒、最大 2K
minimax-h3-fastminimax-h3 の明示的な Fast エイリアスmodel、prompt元の ID と同じ入力上限と料金
minimax-h3-normal低速、半額。テキスト、フレーム、視覚参照model、prompt3–15 秒、480p/768p/1080p、音声生成対応、音声入力なし
grok-imagine-video-1.5テキスト、最初のフレーム、参照画像最大 7 枚model、prompt1–15 秒、480p/720p/1080p。1080p は画像最大 1 枚
seedance-2テキスト、最初と最後のフレーム、マルチモーダル参照model、prompt4–15 秒、最大 4K、音声生成
seedance-2-fastテキスト、最初と最後のフレーム、マルチモーダル参照model、prompt4–15 秒、480p/720p、音声生成
seedance-2-miniテキスト、最初と最後のフレーム、マルチモーダル参照model、prompt4–15 秒、480p/720p、音声生成なし
veo-3.1テキスト、最初と最後のフレーム、参照画像model、promptモデル固定の長さと品質
seedance-2.5テキスト、最初と最後のフレーム、より多くのマルチモーダル参照model、prompt4–30 秒、720p、音声生成とシード
kling-3テキスト、最初と最後のフレーム、複数ショット、再利用可能な要素model、prompt3–15 秒、最大 4K、サウンド生成
kling-2.6-motion-controlアップロードしたキャラクター画像 1 枚と動作動画 1 本model、images、reference_videos3–30 秒、720p/1080p、検出した長さに基づく課金
kling-3-motion-control向きと背景を設定できる動作転写model、images、reference_videos3–30 秒、720p/1080p、検出した長さに基づく課金
wan-3.0テキスト、最初のフレーム、参照動画と音声model、prompt2–30 秒、480p/720p/1080p。参照動画を使うと料金は 1.5 倍
wan-3.0-primeWan 3.0 と同じ入力、より速いキューmodel、prompt2–30 秒、480p/720p/1080p、Wan 3.0 と同じ料金
happyhorse-1.0画像から動画のみ。最大 9 つの元画像のアングルmodel、prompt、images3–15 秒、720p/1080p
happyhorse-1.11.0 と同じ仕様、より低い秒単価model、prompt、images3–15 秒、720p/1080p
minimax-h3-maxテキスト、最初のフレーム、最初と最後のフレームmodel、prompt5 秒以上、480P/768P、シード
minimax-h3-max-turboH3 Max と同じ仕様、約 2.5 倍高速model、prompt5 秒以上、480P/768P、秒単価は半額

各フィールド、初期値、列挙値、組み合わせのルール、リクエスト例、レスポンス、エラーの詳細は、対応するモデルページを参照してください。

利用可能なモデルを取得する

GET /v1/media/models

パラメーター場所型必須許容値
media_typeクエリstringいいえimage、video

この公開エンドポイントは認証不要です。

curl "https://api.beatapi.io/v1/media/models?media_type=video"
{
  "data": {
    "object": "list",
    "data": [
      {
        "id": "minimax-h3",
        "object": "generation_model",
        "name": "MiniMax H3",
        "media_type": "video",
        "input_modes": ["text", "frames", "reference"]
      }
    ]
  }
}
フィールド型意味
idstring安定した公開モデルエイリアス
objectstringgeneration_model
namestring表示名
media_typestringimage または video
input_modesstring[]text、image、frames、reference のいずれか

内部のモデル接続経路は公開仕様に含まれません。

共通の作成仕様

POST /v1/videos/tasks

ヘッダー型必須ルール
AuthorizationstringはいBearer <BEATAPI_API_KEY>
Content-Typestringはいapplication/json
Idempotency-Keystringいいえ、推奨最大 255 文字。論理的な作成操作ごとに 1 つ

本文は、いずれか 1 つのモデルスキーマに正確に一致する必要があります。model がスキーマの判別項目で、不明なフィールドは拒否されます。

curl https://api.beatapi.io/v1/videos/tasks \
  -X POST \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H "Idempotency-Key: video-seedance-2-5-001" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A cinematic tracking shot through a rain-lit night market.",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

有効なリクエストには 201 Created が返り、data.id、task_kind="video"、選択した model、status="queued"、利用量、request_id が含まれます。GET /v1/tasks/{task_id} を 5–10 秒ごとに確認し、succeeded または failed で終了します。成功した動画は data.output.media[] と data.output.r2_url に入ります。

同じ冪等キーと完全に同じ本文で再送すると、受け付け済みのタスクを返します。同じキーを異なる本文で使うと 409 idempotency_conflict を返します。

共通のエラー

HTTP共通コードクライアントの対処
400bad_requestフィールド、値、組み合わせ、件数、メディア URL を修正
400content_policy_violationプロンプトや入力を変更。変更せず再送しない
401missing_api_key / invalid_api_keyBearer キーを送信、または不正、期限切れ、無効、上限到達のキーを交換
402insufficient_credits新しいタスクを作る前にチャージ
403forbiddenキーまたはアカウントで許可されていない。無料クレジット対象外のモデルなど
409idempotency_conflict完全に同じ本文の場合にのみキーを再利用
429rate_limit_exceeded / user_concurrency_exceededRetry-After に従うか、処理中のタスクの完了を待つ
500internal_errorバックオフして 1 回再試行
503processing_unavailable / processing_timeout / processing_failed / result_transfer_failedバックオフして再試行。課金なし

エラーレスポンスは error.code、英語の error.message、error.retryable、error.request_id を含み、429 には error.retry_after_seconds も含まれます。受け付け後に失敗したタスクの取得自体は 200 です。data.error_code とエラーで、全コードと再試行ルールを確認してください。各モデルページには本番のリクエスト仕様を掲載しています。