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

# Grok Imagineの編集

> Grok Imagineの画像編集フィールド、モデルの制約、リクエスト例。

xAIのJSONリクエスト形式で画像を編集します。このエンドポイントはOpenAIのマルチパート画像アップロードを使用しません。

`POST https://api.mixroute.ai/v1/images/edits`

## モデル

| モデルID | 機能と制限 |
| - | - |
| `grok-imagine-image-2.0` | 生成・編集、品質の選択、および最大5つの編集用参照。 |
| `grok-imagine-image-quality` | 旧世代の生成・編集モデルです。Image 2.0のqualityパラメーターは送信しないでください。 |
| `grok-imagine-image` | 旧世代の生成・編集モデルです。Image 2.0のqualityパラメーターは送信しないでください。 |

## リクエストパラメーター

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `model` | string | はい | 完全なGrok ImagineモデルID。 |
| `prompt` | string | はい | 要求する画像または編集内容のテキスト説明。 |
| `image` | object | 条件付き | `url`または`file_id`を使用する単一のソース画像です。`images`と一緒に送信しないでください。 |
| `images` | object\[] | 条件付き | 複数の参照画像。`image`とは相互排他です。Image 2.0は最大5枚に対応しています。各項目は同じ参照オブジェクト構造を使用します。 |
| `image.url / images[].url` | string | 条件付き | JPEG、PNG、またはWebP画像の公開URLまたはBase64データURIです。同じオブジェクト内のfile\_idとは同時に指定できません。 |
| `image.file_id / images[].file_id` | string | 条件付き | アップロードが完了し、ルートからアクセス可能な画像のネイティブxAI Files API ID。MixRouteのタスクIDではありません。 |
| `n` | integer | いいえ | 画像の枚数。1～10、デフォルトは1。 |
| `aspect_ratio` | string | いいえ | 出力のアスペクト比です。以下の一覧を参照してください。生成時のデフォルトは`auto`です。編集時は、具体的な比率を指定しない限り、通常は最初の入力画像に従います。 |
| `resolution` | string | いいえ | `1k`（デフォルト）または`2k`。小文字のkを使用します。 |
| `quality` | string | いいえ | Grok Imagine Image 2.0のみ：`low`、`medium`、または`auto`（デフォルト）。現在、Autoは生成時にlow、編集時にmediumを選択します。 |
| `response_format` | string | いいえ | `url`（デフォルト）または`b64_json`。 |
| `user` | string | いいえ | 不正利用の監視に使用する、安定したエンドユーザー識別子。生の個人データは使用しないでください。 |
| `storage_options` | object | いいえ | 任意のネイティブFiles APIストレージ設定です。ルートが使用する上流アカウントでの権限が必要です。 |
| `storage_options.filename` | string | 条件付き | storage\_optionsを指定する場合は必須です。保存時のファイル名を指定します。拡張子によって生成コンテンツのタイプが変わることはありません。 |
| `storage_options.expires_after` | integer | いいえ | 保存ファイルの有効期間。3600～2592000秒。自動的に期限切れにしない場合は省略します。 |
| `storage_options.public_url` | boolean \| object | いいえ | trueは公開URLを要求します。永続的な公開URLの作成を避けるには、省略するかfalseにします。オブジェクトで有効期間を設定できます。 |
| `storage_options.public_url.expires_after` | integer | いいえ | 公開URLの有効期間。3600～2592000秒。デフォルトはファイルの有効期間と同じで、設定済みのファイル有効期限を超えることはできません。 |

## アスペクト比

`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`, `21:9`, `5:2`

`21:9`と`5:2`はImage 2.0で追加されました。以前のモデルでは、それ以外のサポートされる比率を使用してください。GPT Imageの`size`フィールドではなく、`aspect_ratio`と`resolution`を使用します。

編集する場合は、`image`または`images`を指定してください。参照画像が複数ある場合は、順に`<IMAGE_0>`、`<IMAGE_1>`などとして参照します。JSONのHTTPリクエストを直接使用してください。OpenAI SDKのimages.editメソッドはマルチパートデータを送信するため、このxAIリクエストには適していません。

## 例

環境変数`MIXROUTE_API_KEY`にMixRouteのキーを設定してください。リクエストは`Authorization: Bearer ...`を使用します。編集前に、元画像のプレースホルダーをアクセス可能な画像またはローカルファイルに置き換えてください。

```bash theme={null}
curl --request POST "https://api.mixroute.ai/v1/images/edits" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "grok-imagine-image-2.0",
  "prompt": "Make the mug blue while preserving its shape, lighting, and background.",
  "image": {
    "url": "https://example.com/source.png"
  },
  "n": 1,
  "aspect_ratio": "1:1",
  "resolution": "1k",
  "quality": "low",
  "response_format": "url"
}'
```

### Python

```python theme={null}
import json
import os
import requests

payload = json.loads(r'''
{
  "model": "grok-imagine-image-2.0",
  "prompt": "Make the mug blue while preserving its shape, lighting, and background.",
  "image": {
    "url": "https://example.com/source.png"
  },
  "n": 1,
  "aspect_ratio": "1:1",
  "resolution": "1k",
  "quality": "low",
  "response_format": "url"
}
''')
response = requests.post(
    "https://api.mixroute.ai/v1/images/edits",
    headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
    json=payload,
    timeout=180,
)
response.raise_for_status()
result = response.json()
for item in result["data"]:
    print(item.get("url") or item.get("b64_json"))
```

## レスポンス

`data[].url`から一時的な画像URLを読み取るか、data URIの接頭辞を含まない`data[].b64_json`をデコードします。`mime_type`はエンコーディングを示します。ネイティブストレージを要求した場合、`file_output`にファイル情報が含まれます。ストレージまたは公開URLのエラーと、生成の失敗は別のものです。

[Grokによる画像生成](/ja/api-reference/endpoint/grok-imagine-image)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.