動画モデル上級者向け更新日
POST/v1/videos/generations
Grok Imagine 1.5 Video
リクエスト ID grok-imagine-1.5-video
プロトコル
POST /v1/videos/generations· 動画を生成の例GET /v1/videos/tasks/{id}· 動画タスクを照会の例GET /v1/videos/tasks/{id}/content· 動画をダウンロードの例DELETE /v1/videos/tasks/{id}· 終了済みの動画タスクを削除の例
認証
リクエストには API キー管理 の API キーが必要です。JSON リクエストには Content-Type: application/json を設定します。
Authorization: Bearer YOUR_API_KEY
リクエストパラメータ
POST /v1/videos/generations
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | grok-imagine-1.5-video. このページに記載のモデル ID を指定します。 |
prompt | string | 条件付き | 場面、動き、カメラワークを記述します。 テキスト指示が必要な場合は、この項目か type: "text" の content 項目を使います。 |
content | array<object> | 条件付き | 参照素材と任意のテキスト項目です。prompt のみで生成する場合は省略できます。 画像は最大 7 枚です。 |
content[].type | string | 必須 | 指定できる値は text, image_url, input_image です。 |
content[].text | string | 条件付き | type: "text" の項目にプロンプトを指定します。 |
content[].role | string | 条件付き | 通常の参照画像には reference_image を使用します。 通常の参照画像ではロールを省略できます。 |
content[].asset_id | string | 条件付き | POST /v1/videos/assets に素材をアップロードし、返された id を指定します。multipart では kind（image）を file より先に指定します。 素材は自分のアカウントに属している必要があります。素材 ID か公開 HTTPS URL のいずれかを指定します。 |
content[].image_url | string | 条件付き | 公開 HTTPS の画像 URL を文字列で指定します。 |
resolution | string | 任意 | 指定できる値は 480p, 720p です。 既定値は 480p です。 |
ratio | string | 任意 | 出力の縦横比です。aspect_ratio でも指定できます。 指定できる値は 16:9, 9:16, 1:1, 3:2, 2:3 です。 既定値は 9:16 です。 |
duration | integer | 任意 | 出力時間を秒で指定します。 6～30 秒の整数を指定します。 既定値は 6 です。 |
リクエスト例
API Key をローカルの環境変数 ICODEEASY_API_KEY に設定し、直接 HTTP 呼び出しに対応するエンドポイントを選択します。指定クライアントが必要な場合は設定ガイドに従ってください。
例のメディア URL とアセット ID は、有効な素材に置き換えてください。
Video Generations
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-1.5-video",
"prompt": "Slow camera push toward a paper lantern swaying gently by a lake.",
"resolution": "720p",
"ratio": "16:9",
"duration": 6
}'
動画タスクを照会
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
-H "Authorization: Bearer $ICODEEASY_API_KEY"
動画をダウンロード
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID/content' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-L \
-o result.mp4
終了済みの動画タスクを削除
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-i \
-X DELETE
レスポンスとタスク
HTTP 202 · タスクの受付
json
{
"id": "vid_1785398400000000000",
"object": "video.generation.job",
"model": "grok-imagine-1.5-video",
"created_at": "2026-07-30T08:00:00Z",
"status_url": "/v1/videos/tasks/vid_1785398400000000000",
"content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
"status": "queued",
"updated_at": "2026-07-30T08:00:00Z",
"task_id": "vid_1785398400000000000"
}
HTTP 200 · 完了したタスクの取得
json
{
"id": "vid_1785398400000000000",
"object": "video.generation.job",
"model": "grok-imagine-1.5-video",
"created_at": "2026-07-30T08:00:00Z",
"status_url": "/v1/videos/tasks/vid_1785398400000000000",
"content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
"status": "succeeded",
"updated_at": "2026-07-30T08:01:00Z",
"url": "/v1/videos/tasks/vid_1785398400000000000/content"
}
id を保存します。同じ API キーで status_url に GET リクエストを送り、status が succeeded または failed になるまで確認します。成功後は content_url からダウンロードし、HTTP リダイレクトに従います。どちらのパスも API ベース URL からの相対パスです。
| フィールド | 型 | 説明 |
|---|---|---|
id / task_id | string | タスク ID。作成レスポンスの task_id は id と同じです。 |
status | string | 状態は queued、running、succeeded、failed のいずれかです。 |
progress | integer | 生成の進捗。進捗値が得られない場合は省略されます。 |
error.code | string | タスクが失敗した場合のエラー分類。 |
主なエラー
| HTTP | エラータイプ | 説明 |
|---|---|---|
| 400 | invalid_request | モデル、パラメーターの組み合わせ、参照メディアを確認します。 |
| 401 | unauthorized | API キーが未指定、無効、または停止済みかどうかを確認します。 |
| 402 | insufficient_balance | タスクの送信に必要な残高が不足しています。 |
| 404 | not_found | 照会が 404 の場合はタスク ID を保存し、照会 URL と作成元アカウントの API キーを確認します。既に完了している可能性があるため、この応答だけで再送信しないでください。 |
| 409 | video_not_ready | 動画は生成中です。引き続き状態を確認してください。 |
| 503 | submission_unknown | 送信結果を確認できません。再送信する前にサポートへタスク作成の有無を確認してください。 |
接続ガイド · リクエスト項目、タスクの状態、レスポンス形式は API ガイドを参照してください。
機能と制限
text_to_video· 対応image_to_video· 対応first_frame· 非対応last_frame· 非対応reference_images· 対応audio· 非対応- 制限 解像度: 480p, 720p · アスペクト比: 16:9, 9:16, 1:1, 3:2, 2:3 · 長さ: 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 · 参照画像：最大 7 枚
互換エイリアスと廃止済みリダイレクト
grok-imagine-1.5-video-ext→grok-imagine-1.5-video(エイリアス)