API Hop

ドキュメント

API Hop ドキュメント

MiniMax H3 と Grok の動画生成

非同期動画リクエスト、制限、課金単位とジョブのポーリング。

POSThttps://api.apihop.ai/v1/video-generations

利用可否

利用可否は API Hop API キーによって異なります。GET /v1/models が対象モデルの正確な ID(minimax-h3 または grok-imagine-video-1.5)を返す場合にのみ、そのモデルへのリクエストを送信してください。ドキュメントの掲載はアクセス許可を意味しません。Veo 3.1 Fast と Gemini Omni Flash は、この公開ガイドでは利用できません。

リクエストパラメーター

Authorization: Bearer YOUR_APIHOP_API_KEY と Content-Type: application/json を指定して JSON を送信します。

modelsecondsresolutionimagesaudios
minimax-h36-30768p (デフォルト), 480p0-80-3
grok-imagine-video-1.56-15720p0-7非対応

model と空でない文字列 prompt は必須です。Grok のプロンプトは最大 1,200 文字です。seconds は整数または整数の文字列を受け取り、デフォルトは 6 です。aspect_ratio のデフォルトは 16:9 で、9:16 も指定できます。images と audios は HTTP(S) URL の配列です。Grok の画像は PNG、JPEG、WebP の base64 data URI も使用できます。H3 は 480p 出力を保証しないため、768p を使用してください。stream は省略するか false にします。非対応のフィールドや矛盾する別名は拒否されます。

リクエスト例

bash
curl --request POST \
  --url https://api.apihop.ai/v1/video-generations \
  --header 'Authorization: Bearer YOUR_APIHOP_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"model":"minimax-h3","prompt":"A slow pan across a mountain lake","seconds":"6","resolution":"768p","aspect_ratio":"16:9"}'
json
{
  "model": "grok-imagine-video-1.5",
  "prompt": "A slow pan across a mountain lake",
  "seconds": "6",
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

ジョブの状態と結果

受け付けたリクエストは HTTP 202、十進文字列の data.jobId、data.status: "PENDING" を返します。ID は文字列のまま保持してください。同じアカウントのキーで GET /v1/jobs/{id} を 5~10 秒ごとにポーリングします。PENDING、CONNECT、PROCESSING は未完了です。COMPLETED になったら data.outputResult.result[].url から動画 URL を取得します。各 URL は文字列です。FAILED または CANCELLED でポーリングを停止してください。完成した動画は速やかに保存してください。送信タイムアウトや長時間の処理では、再試行前に既存ジョブとアカウントの使用量を確認してください。別の POST は別の有料ジョブを作成する可能性があります。

課金

MiniMax H3 は生成動画の秒数、Grok Imagine Video 1.5 はリクエスト回数で課金されます。公開料金は 料金ページ を参照してください。Grok のリクエスト単価に動画の長さを掛けないでください。