HiAPI
Ja
ブログ

チュートリアル

Grok Image 2.0 テキスト生成画像 API の使い方？5 分で最初の 1 枚を生成

curl と Python の実行可能なサンプル、4 つのパラメータ、コールバックと本番投入時の注意点、1 枚 $0.052。

Oct 12, 2026
Grok Image 2.0 テキスト生成画像 API の使い方？5 分で最初の 1 枚を生成

Grok Image 2.0 テキスト生成画像 API の使い方？3 ステップ：POST /v1/tasks でタスクを作成し、taskId を受け取ったらポーリング（またはコールバックを設定）し、data.output[0].url から生成画像をダウンロードします。1 枚 $0.052、1K と 2K は同価格です。

Grok Image 2.0 は HiAPI で公開済みです。モデルページを開く とすぐに生成でき、新規ユーザーは登録で 200 クレジットが付与され、まず 1 枚生成して効果を確認するのに十分です。

TL;DR

  • 何か： grok-imagine-image-2.0/text-to-image、xAI 製のテキスト生成画像モデルで、HiAPI の統一された非同期タスクインターフェースを利用します。
  • 料金： 1 枚 $0.052、1K / 2K、low / medium、任意のアスペクト比でこの価格です。成功した生成のみ課金され、失敗時は自動返金されます。$10 で約 192 枚生成できます。
  • 最短の呼び出し方： prompt だけで生成可能。aspect_ratio、resolution、quality の 3 パラメータは任意です。

Grok Image 2.0 テキスト生成画像にはどんなパラメータがありますか？

input には 4 つのフィールドだけがあります：

フィールド 必須 値 説明
prompt はい 文字列 画面の説明
aspect_ratio いいえ 1:1、16:9、9:16、4:3、3:4、3:2、2:3、2:1、1:2、19.5:9、9:19.5、20:9、9:20、auto デフォルト 1:1
resolution いいえ 1k、2k デフォルト 1k
quality いいえ low、medium デフォルト medium；medium はディテールが良く、low はより高速

1 タスクにつき 1 枚生成されます。複数枚必要な場合は複数タスクを並行して送信してください。上表以外のフィールドや値は 400 を返し、エラーメッセージで具体的なフィールドが示されます。

オンライン試用と API の 2 つのルート

オンライン試用（1 分）

  1. テキスト生成画像モデルページを開き、ログインします。
  2. プロンプトを入力し、アスペクト比と解像度を選択します。
  3. 「実行」をクリックし、タスク成功後に生成画像を確認してダウンロードします。

API 接続（5 分）

  1. コンソールで API Key を作成します。
  2. POST /v1/tasks でタスクを送信します。
  3. GET /v1/tasks/<taskId> をポーリングするか、コールバックを設定します。
  4. 成功後すぐに data.output[0].url をダウンロードします。
Product photography of a matte black ceramic coffee mug filled with steaming black coffee, thin wisps of steam curling upward, mug placed on a warm honey-toned wooden table near a bright window with sheer curtains, soft natural window light from the left creating gentle highlights on the mug's curved surface, shallow depth of field with the background softly blurred, plenty of empty negative space to the right of the mug for text overlay, warm cozy morning color grade, realistic commercial photography style, 3:2 aspect ratio

まず動作するプロンプトを 1 つ用意しましょう。以下は 3:2 の商品画像用です。このプロンプトで生成 →（比率は 3:2、解像度は 2K を選択）

curl と Python：最初の 1 枚を生成する

まず API Key を設定します：

export HIAPI_API_KEY="sk-..."

すべてのリクエストに Authorization: Bearer sk-<key> を付けます。画像生成は非同期で、HiAPI の他のモデルと同じタスクインターフェースを共有します。

ステップ 1、タスクを作成：

curl --fail-with-body -sS -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0/text-to-image",
    "input": {
      "prompt": "A red apple on a wooden table, studio lighting, shallow depth of field",
      "aspect_ratio": "16:9",
      "resolution": "2k"
    }
  }'

すぐに taskId が返ります：

{
  "code": 200,
  "message": "success",
  "data": { "taskId": "tk-hiapi-01M01JGSGB818MX59GVZZCVH67" }
}

ステップ 2、終了状態までポーリング：

curl --fail-with-body -sS https://api.hiapi.ai/v1/tasks/tk-hiapi-01M01JGSGB818MX59GVZZCVH67 \
  -H "Authorization: Bearer $HIAPI_API_KEY"

data.status を確認します：success は成功、fail は失敗を意味し、その他の状態は引き続き待機します。成功時のレスポンス例：

{
  "code": 200,
  "data": {
    "taskId": "tk-hiapi-01M01JGSGB818MX59GVZZCVH67",
    "status": "success",
    "storage": "temp",
    "output": [
      {
        "type": "image",
        "url": "https://temp.hiapi.ai/7c6ttvrbpt/01M01JGSGB818MX59GVZZCVH67-0.jpg",
        "artifactId": "76710",
        "expireAt": 1787364206
      }
    ]
  },
  "message": "success"
}

storage: "temp" と expireAt に注意してください：生成画像の URL は一時的なので、タスク完了後すぐにダウンロードするか、自分のオブジェクトストレージに転送保存してください。

Python バージョン：

まず requests をインストールし（python3 -m pip install requests）、上記の HIAPI_API_KEY を設定します。スクリプトは最大 10 分間ポーリングします。タイムアウト後は taskId を保持して引き続き問い合わせてください。

import os
import time
import requests

API_KEY = os.environ["HIAPI_API_KEY"]
BASE = "https://api.hiapi.ai/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}


def task_data(response):
    response.raise_for_status()
    body = response.json()
    if body.get("code") != 200:
        raise RuntimeError(f"HiAPI request failed: {body}")
    return body["data"]


def generate_image(prompt: str, aspect_ratio: str = "1:1", resolution: str = "1k") -> str:
    create = requests.post(
        f"{BASE}/tasks",
        headers=HEADERS,
        json={
            "model": "grok-imagine-image-2.0/text-to-image",
            "input": {"prompt": prompt, "aspect_ratio": aspect_ratio, "resolution": resolution},
        },
        timeout=30,
    )
    task_id = task_data(create)["taskId"]
    print(f"taskId: {task_id}", flush=True)
    deadline = time.monotonic() + 600

    while time.monotonic() < deadline:
        poll = requests.get(f"{BASE}/tasks/{task_id}", headers=HEADERS, timeout=30)
        data = task_data(poll)
        if data["status"] == "success":
            return data["output"][0]["url"]
        if data["status"] == "fail":
            raise RuntimeError(f"task {task_id} failed: {data}")
        time.sleep(2)
    raise TimeoutError(f"task {task_id} is still pending; query this ID instead of submitting again")


if __name__ == "__main__":
    url = generate_image("A red apple on a wooden table, studio lighting", resolution="2k")
    print(url)

本番投入前に注意すべきことは？

  • バッチ処理にはコールバックを使い、密集ポーリングは避ける。 タスク作成時に callback を付けると、タスク終了後に HiAPI があなたのアドレスへプッシュします：

    {
  "model": "grok-imagine-image-2.0/text-to-image",
  "input": { "prompt": "..." },
  "callback": { "url": "https://your-service.example.com/hooks/hiapi", "when": "final" }
}

    when: "final" はタスクが成功または失敗の終了状態に達したときに通知します。受信側は taskId で重複排除してください。インタラクティブなページにはポーリング、バッチ処理にはコールバックを使います。

  • 生成画像はすぐに転送保存。 data.output[0].url は一時アドレスで、expireAt に従って失効します。

  • 1 タスクは 1 回だけ送信。 レスポンスを受け取ったら taskId と業務タスクの対応関係を保存してください。重複送信すると複数タスクが作成され、それぞれ課金される可能性があります。作成リクエストがタイムアウトして ID を受け取れなかった場合は、まずタスク記録を確認してから再送信するか判断してください。

  • resolution を明示的に指定。 デフォルトは 1k です。1K と 2K は同価格なので、本番用は直接 "resolution": "2k" を渡してください。

  • プロンプト調整には quality: low。 同価格で返却が速く、確定後に medium に切り替えます。

  • エラーハンドリング。 まず HTTP ステータスとレスポンスの code、message を確認し、その後に data を読み取ります。パラメータや認証エラーは修正してから再送信してください。タスクが fail を返したらエラーを記録し、ポーリングを停止します。

関連記事

よくある質問

モデル ID はどう書きますか？ 完全な grok-imagine-image-2.0/text-to-image を書き、バージョン番号 2.0 と /text-to-image を保持してください。

「additional properties not allowed」と表示されたら？ input は prompt、aspect_ratio、resolution、quality の 4 フィールドのみ受け付けます。他のモデルで一般的な size、n、seed、negative_prompt、output_format はここでは使えないので削除してください。

一度に複数枚生成できますか？ できません。1 タスクにつき 1 枚です。複数枚必要な場合は複数タスクを送信して並行実行してください。

出力 URL の有効期限は？ 一時ストレージで、レスポンスの expireAt は Unix タイムスタンプです。タスク成功後すぐにダウンロードまたは転送保存してください。

結果を同期的に待つ必要がありますか？ いいえ。作成インターフェースはタスクがキューに入るとすぐに返ります。短いスクリプトでは GET /v1/tasks/<taskId> をポーリングし、本番環境では callback を設定してください。

失敗したタスクは課金されますか？ いいえ。成功した生成のみ課金され、失敗時は自動返金されます。data.status が fail の場合はポーリングを停止してください。

今すぐ最初の 1 枚を生成

まず HIAPI_API_KEY を設定し、上記の curl でタスクを作成して、返された data.taskId で問い合わせます。タスク成功後、data.output[0].url からダウンロードしてください。まず効果を確認したい場合は、テキスト生成画像モデルページを開いてください。登録でもらえる 200 クレジットで 1 枚生成できます。

タグ画像APIテキストから画像生成チュートリアルgrokAPI 接続テキストから画像生成

関連記事

すべての記事を見る →

永続的なAIアーティファクトで開発を始める

APIキーを取得して、タスクベースの1つのAPIで画像・動画・音声モデルを呼び出せます。

APIドキュメントを読む