Grok Imagine 1.5 API：画像をショート動画に変える

商品写真1枚、人物の顔写真、あるいは風景の静止画を、別の動画生成アカウントにログインすることなく、実用的なショート動画クリップに変えられます。Grok Imagine 1.5 の画像から動画へのエンドポイントは、画像 URL、動きを記述する任意のプロンプト、そして再生時間を受け取り、hiapi の非同期タスク API を通じてレンダリング済みの .mp4 ファイルを返します。

このウォークスルーでは、同じソース画像と2つの異なるプロンプトを使って、文言がどれほど結果を変えられるかを示し、その後、実際のリクエスト schema、料金、そしてそのままコピーできるコード例を分解して説明します。

ソース画像

以下の2つのクリップは、どちらもこの同じ静止画から始まります。2つのリクエストの間で、元の画像は一切変わっていません——異なるのは prompt フィールドだけです。

バージョン 1：短いティザー風のパン

プロンプト：「Slow push-in toward the subject, soft ambient light, cinematic teaser pacing.」 再生時間：4。

バージョン 2：より長いオービットショット

プロンプト：「Camera slowly orbits around the subject, revealing the scene from a new angle.」 再生時間：8。

同じ静止画、同じモデル、まったく異なる2つのカメラワーク——ここではリクエストに専用のモーション強度やカメラパスのパラメータがないため、ほぼプロンプトだけが効いています。

実際のリクエスト schema

完全なモデルドキュメントとリアルタイムの料金はGrok Imagine 1.5 画像から動画へのモデルページを参照してください。リクエストボディは意図的に小さく設計されています：

{
  "model": "grok-imagine-1.5/image-to-video",
  "input": {
    "image_urls": ["https://your-public-host.com/source.jpg"],
    "prompt": "Slow push-in toward the subject, soft ambient light, cinematic teaser pacing.",
    "duration": 4
  }
}

呼び出す前に知っておくべきことが3つあります：

• image_urls は公開された HTTP(S) URL でなければなりません。 モデルが画像を自分で取得します——リクエストボディに生のバイト列をアップロードすることはできません。ソース画像がローカルにしかない場合は、まず任意の公開ストレージバケットにアップロードしてください。
• duration は 1 から 15 秒の整数です。 aspect_ratio、resolution、モーション強度のフィールドはありません——出力の構図はソース画像に従い、解像度はリクエストパラメータではなく料金ティア（480p または 720p）によって決まります。
• prompt は任意ですが、クリエイティブな作業の大部分を担います。それ以外にカメラを導くものが何もないからです。

タスクを送信してポーリングする

hiapi 上のすべての動画・画像モデルと同様に、このモデルは同期エンドポイントではなく統一された非同期タスク API を通じて動作します——生成には実際の時間がかかるため、まずタスクを送信し、完了状態をポーリングし、リンクが期限切れになる前に結果をダウンロードする必要があります。

# 1. Submit the task
curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.5/image-to-video",
    "input": {
      "image_urls": ["https://your-public-host.com/source.jpg"],
      "prompt": "Camera slowly orbits around the subject, revealing the scene from a new angle.",
      "duration": 8
    }
  }'
# => {"id": "task_...", "status": "pending"}

# 2. Poll until it's done
curl -s https://api.hiapi.ai/v1/tasks/task_... \
  -H "Authorization: Bearer $HIAPI_API_KEY"
# => {"id": "task_...", "status": "success", "output": [{"url": "https://...mp4"}]}

status が success になったら、すぐに output[0].url をダウンロードしてください——これは期限付きリンクであり、永続リンクではないため、期限が切れる前にバイト列を自分のストレージに保存してください。

料金と再生時間の計算

バッチタスクの予算を立てる前に、hiapi の料金ページで最新の数値を確認してください。ただし本記事執筆時点では、grok-imagine-1.5/image-to-video は出力の秒単位で課金されます：

解像度	1秒あたりの価格
480p	$0.015
720p	$0.0282

4秒の 480p クリップは $0.06 かかります。同じクリップを 720p にすると約 $0.11 です。料金は生成ごとの固定費ではなく再生時間に応じて拡張されるため、最終カットを決める前に同じ静止画に対して複数のプロンプトバリエーションを試すのは低コストです——本記事の2つのクリップの合計コストは $0.20 を大きく下回ります。

よくある質問

カメラワークをプロンプトで記述するのではなく、直接制御できますか？ いいえ——このエンドポイントの schema には専用のモーション強度、カメラパス、ズームのパラメータはありません。カメラの挙動は、prompt をどう表現するかによって完全に決まります。

出力解像度はソース画像に一致しますか？ 構図はソース画像のアスペクト比に従いますが、解像度（480p または 720p）は料金ティアの選択であり、個別のフィールドで設定するものではありません——プラットフォームのモデルはときどきパラメータを追加するため、上記リンクのモデルページで現在の schema を確認してください。

出力を十分に早くダウンロードしなかった場合はどうなりますか？ 完了したタスクの output[0].url は期限付きです。ウィンドウを逃すと、タスクを再送信して生成費用を再度支払う必要があります——期限切れのリンクを再取得することはできません。

1回のリクエストで複数の静止画をアニメーション化できますか？ image_urls は1つの URL を受け取りますが、各タスクは1枚のソース画像から1つのクリップを生成します。バッチタスクの場合は、静止画ごとに1つのタスクを送信して個別にポーリングしてください——非同期モデルなので、複数のタスクを同時に進行させることができます。

---

自分の画像で試す準備はできましたか？Grok Imagine 1.5 画像から動画へのモデルページで自分のプロンプトを使って短いクリップを生成するか、既存のパイプラインに組み込む場合は非同期タスク API ドキュメントから始めてください。