API Hop ドキュメント
MiniMax H3 と Grok の動画生成
非同期動画リクエスト、制限、課金単位とジョブのポーリング。
https://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 を送信します。
| model | seconds | resolution | images | audios |
|---|---|---|---|---|
minimax-h3 | 6-30 | 768p (デフォルト), 480p | 0-8 | 0-3 |
grok-imagine-video-1.5 | 6-15 | 720p | 0-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 にします。非対応のフィールドや矛盾する別名は拒否されます。
リクエスト例
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"}'{
"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 のリクエスト単価に動画の長さを掛けないでください。