Grok Imagine 画像 API：テキストから画像生成、画像から画像生成、そして Quality

主なポイント

• HiAPI の Grok Imagine 画像 API には合計 4 つのエンドポイントがあります。標準版と Quality で、それぞれにテキストから画像生成と画像から画像生成があります。4 つのリクエスト構造は完全に同じで、異なるのはモデル id だけです。
• 標準版は 1K でも 2K でも 1 枚あたり $0.03 です。Quality は 1K で $0.07、2K で $0.10 です。画像から画像生成では、参照画像 1 枚（1〜3 枚の参照）ごとに少額の追加料金がかかります。
• 同じプロンプトを使用した場合、標準版は取っ手も内側のリブもない普通の円錐を描きました。Quality は識別可能なハンドドリップ用ドリッパーを描きました。標準版は下書きや大量バッチ処理に、Quality は最終成果物の生成に使えます。テキストから画像生成のモデルページを開く と試せます。新規アカウントには 200 の無料クレジットが付与されます。

どのエンドポイントを使うべきか

モデル id	入力	画像 1 枚あたりの料金	適した用途
grok-imagine/text-to-image	プロンプト	$0.03（1K と 2K）	下書き、バッチ生成、超ワイドバナー
grok-imagine-quality/text-to-image	プロンプト	$0.07（1K）/ $0.10（2K）	最終製品画像、細部と質感
grok-imagine/image-to-image	プロンプト + 1〜3 枚の画像	$0.03 + 参照画像 1 枚につき $0.003	製品をシーンに合成、バッチレタッチ
grok-imagine-quality/image-to-image	プロンプト + 1〜3 枚の画像	$0.08（1K）/ $0.10（2K）+ 参照画像 1 枚につき $0.015	被写体を完全に維持したまま再ライティングやスタイル変更

HiAPI のリアルタイム料金、2026 年 10 月 19 日時点。失敗したタスクは課金されません。

参照画像 1 枚での編集は標準版で $0.033、Quality 1K で $0.095 です。動画や Grok Imagine Image 2.0 を含むシリーズ全体については、Grok Imagine API の料金 を参照してください。

同じプロンプト、標準版 vs Quality

1:1、2K、PNG、それぞれ 1 回ずつ実行：

matte ceramic pour-over coffee dripper on a pure white seamless background, studio softbox lighting, centered, no shadow gradient beyond a soft contact shadow, no text, no watermark, no props, e-commerce product photography, sharp focus

標準版：

grok-imagine/text-to-image、1:1、2K、2048×2048、$0.03、約 80 秒。

Quality：

Quality でこのプロンプトを生成 →

grok-imagine-quality/text-to-image、1:1、2K、2048×2048、$0.10、約 78 秒。

違い：

• 物体そのもの：標準版はクリーンだが汎用的な円錐をレンダリングし、どちらかといえばボウルに近いものでした。Quality はハンドドリップ用ドリッパーたらしめる各部品を描きました。内側の螺旋状リブ、取っ手、そして排水穴付きの台座です。
• 両方とも背景の要件に従った：純白、中央配置、柔らかな接地影が 1 つだけ、小道具や文字はなし。
• サイズと速度は同じ：どちらも約 80 秒で 2048×2048 の画像を返しました。グレードが変えるのは細部であり、出力サイズではありません。

既知の製品の場合、Quality は追加の $0.07 の価値があります。ムードボードやレイアウトデザインなど、物体そのものが汎用的な場面では標準版で十分です。

画像から画像生成：製品をシーンに配置する

image_urls に公開画像 URL を 1〜3 個渡し、加えたい変更を記述します。aspect_ratio が auto（画像から画像生成のデフォルト）の場合、出力はリストの最初の画像の形状になります。同じプロンプト、同じ 2 枚の画像で、順序を入れ替えるだけで 2 種類の異なるクロップが得られました：

grok-imagine/image-to-image、製品画像が先頭、1248×832（3:2）を返却。

同じリクエスト、シーン画像が先頭、1024×1024（1:1）を返却。

クロップを制御するには、希望する形状の画像を先頭に置くか、aspect_ratio を明示的に設定してください。

Quality では、1 つのことを変えつつ他的一切を維持するのが強みです。この再ライティングは顔、ジャケット、カップ、構図を保ちました：

Relight this photo as late golden hour: warm low sun coming from the left,
long soft shadows across the table, amber rim light on her hair and jacket.
Keep her face, expression, pose, the corduroy jacket, the marble table, the
coffee cup and the entire composition exactly the same. Photorealistic, same
camera angle, same framing.

grok-imagine-quality/image-to-image、1K、auto（入力 3:2、出力 1248×832）、参照画像 1 枚、$0.095、39 秒。

効果的なパターン：変えたいことを一文で述べ、次に変えてはいけないことをすべて列挙します。さらなるレシピは Grok Imagine Quality 画像から画像生成のプロンプト を参照してください。

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine/text-to-image",
    "input": {
      "prompt": "A lighthouse on a rocky cliff at golden hour, waves crashing below, photorealistic",
      "aspect_ratio": "2:1",
      "resolution": "2k",
      "output_format": "png"
    }
  }'

taskId が返されます。GET https://api.hiapi.ai/v1/tasks/{taskId} を data.status が success になるまでポーリングし、その後 data.output[0].url をダウンロードします。このリンクは期限切れになるため、すぐにファイルを保存してください。

Python：4 つのエンドポイントすべて

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, prompt, image_urls=None, timeout_s=300, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    if image_urls:
        body["input"]["image_urls"] = image_urls
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Draft on standard, then re-run the keeper on Quality
draft = generate("grok-imagine/text-to-image", "matte ceramic pour-over dripper, white background",
                 aspect_ratio="1:1", resolution="1k")
final = generate("grok-imagine-quality/text-to-image", "matte ceramic pour-over dripper, white background",
                 aspect_ratio="1:1", resolution="2k")

# Composite a product into a scene; the first image sets the shape
edit = generate("grok-imagine/image-to-image",
                "Place the product from the first image on the desk in the second image, matching its light",
                image_urls=["https://your-cdn.example.com/product.jpg",
                            "https://your-cdn.example.com/scene.jpg"])

パラメータ

フィールド	必須かどうか	値	説明
prompt	はい	テキスト	欲しいもの、避けたいものはすべてここに書きます
image_urls	画像から画像生成のみ	1〜3 個の URL	jpeg、png、webp。SVG は非対応。参照画像ごとに料金が加算されます
aspect_ratio	いいえ	2:1, 20:9, 19.5:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:19.5, 9:20, 1:2；画像から画像生成では auto も受け付けます	auto は最初の画像に従います
resolution	いいえ	1k（デフォルト）、2k	小文字。料金に影響するのは Quality のみです
output_format	いいえ	jpeg（デフォルト）、png、webp

超ワイドの 2:1 と 20:9 はバナーに適しています。21:9 はありません。20:9 を使用してください。

遭遇するエラー

以下のすべてのエラーは送信時に HTTP 400 を返すため、タスクは作成されず、料金も発生しません：

• resolution: value must be one of '1k', '2k'：2K を送信しました。小文字を使用してください。
• aspect_ratio: value must be one of ...：通常は 21:9 です。20:9 を使用してください。
• additional properties 'n' not allowed（または seed、negative_prompt、size）：これらのフィールドは存在しません。1 つのタスクで 1 枚の画像を生成します。複数枚必要な場合は複数のタスクを送信してください。
• image_urls: missing required field：画像から画像生成には少なくとも 1 枚の画像が必要です。

無効なキーは 401 を返します。タスク作成後の失敗はポーリング時に status: "fail" として表示されるため、HTTP ステータスコードだけでなく data.status を確認してください。

よくある質問

標準版と Quality のどちらを使うべきか？

標準版で $0.03 の下書きを作成します。プロンプトとレイアウトが問題なくなったら、Quality で最終成果物を再実行します。標準版では 2K と 1K の料金が同じなので、常に 2k をリクエストしてください。

これは Grok Imagine Image 2.0 と同じですか？

いいえ。grok-imagine-image-2.0 は独立した、より新しいモデルで、1 枚あたり $0.052 です。Grok Imagine Image 2.0 テキストから画像生成ガイド を参照してください。

1 回のリクエストで複数の画像を取得できますか？

いいえ。n フィールドはありません。画像ごとに 1 つのタスクを送信してください。それらは並行して実行されます。

出力はどのくらいの期間利用できますか？

output[0].url のリンクは期限切れになります。タスク成功後すぐにダウンロードして自身で保存してください。

その他の実際の出力：標準版の商品カタログ画像 と 製品写真のシーン合成。動画については Grok Imagine 動画 API ガイド を参照してください。