> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Imagine Image 2.0 公式画像生成・編集

> grok-imagine-image-2.0 による非同期の画像生成と編集

<Info>
  本エンドポイントは**非同期方式**です。送信成功後にタスク ID が返されます。[タスク状態の取得](/ja/api-reference/tasks/status)をポーリングして最終結果を取得してください。`image_urls` を省略するとテキストから画像生成、指定すると画像編集またはマルチ画像参照になります。
</Info>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://api.apimart.ai/v1/images/generations \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --header 'X-APIMart-Response-Version: 2026-07-27' \
    --data '{
      "model": "grok-imagine-image-2.0",
      "prompt": "雨の夜、ネオンに照らされた映画のような都市の通り",
      "n": 1,
      "aspect_ratio": "16:9",
      "resolution": "2k",
      "quality": "medium"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 202 theme={null}
  {
    "code": 202,
    "data": {
      "id": "task_01KZQE5CM0Y3KZ6M1N1BK619MX",
      "object": "generation.task",
      "type": "image",
      "status": "pending",
      "progress": 0,
      "poll_url": "/v1/tasks/task_01KZQE5CM0Y3KZ6M1N1BK619MX"
    }
  }
  ```
</ResponseExample>

## モデル機能

| モデル                      | 解像度       | `quality`                    |  入力画像 |   出力枚数 |
| ------------------------ | --------- | ---------------------------- | ----: | -----: |
| `grok-imagine-image-2.0` | `1k`、`2k` | テキストから画像生成時のみ `low`、`medium` | 0～3 枚 | 1～10 枚 |

## Body

<ParamField body="model" type="string" default="grok-imagine-image-2.0" required>
  固定値：`grok-imagine-image-2.0`。
</ParamField>

<ParamField body="prompt" type="string" required>
  画像生成または編集の指示。トリム後に空でないこと。最大 8,000 文字です。
</ParamField>

<ParamField body="n" type="integer" default="1">
  出力枚数。`1`～`10`。
</ParamField>

<ParamField body="aspect_ratio" type="string" default="auto">
  `1:1`、`3:4`、`4:3`、`9:16`、`16:9`、`2:3`、`3:2`、`9:19.5`、`19.5:9`、`9:20`、`20:9`、`1:2`、`2:1`、`auto` に対応します。
</ParamField>

<ParamField body="resolution" type="string" default="1k">
  `1k` または `2k`。
</ParamField>

<ParamField body="quality" type="string">
  テキストから画像生成時のみ `low` または `medium`（デフォルト）。`image_urls` がある場合は送信しないでください。
</ParamField>

<ParamField body="image_urls" type="array">
  参考画像 1～3 枚。公開 HTTP(S) URL、または JPEG、PNG、WebP の Base64 Data URL に対応します。
</ParamField>

## 非同期タスク

送信成功時は HTTP `202` で、タスク ID は `data.id` にあります。`data.poll_url` または `GET /v1/tasks/{task_id}` を使用し、`completed` または `failed` になるまで照会してください。

<Warning>
  長期有効な API キーをブラウザーコード、公開環境変数、URL、ローカルストレージ、クライアントログに含めないでください。バックエンドまたは BFF から呼び出してください。
</Warning>