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

# Grok 이미지 모델

> grok-4-image와 grok-4-image로 이미지를 생성하는 방법과 파라미터 차이를 알아봅니다

> 업데이트: 2026-06-06

# Grok 이미지 모델

```
POST /v1/images/generations
```

Grok 이미지 모델은 OpenAI Images 호환 경로로 호출합니다. 현재 두 가지 모델명을 구분해야 합니다.

| 모델             | 설명                                        | 권장                   |
| -------------- | ----------------------------------------- | -------------------- |
| `grok-4-image` | xAI 공식 이미지 모델명, 공식 가격 `$0.02 / image`로 과금 | 신규 연동에 권장            |
| `grok-4-image` | 서드파티 호환 채널의 레거시/호환 모델명                    | 일부 파라미터 서브셋으로만 사용 권장 |

<Warning>
  `grok-4-image`는 xAI 공식 모델명이 아니므로, `grok-4-image`와 완전히 동등하다고 가정할 수 없습니다. 신규 연동에는 `grok-4-image`를 우선 사용하세요.
</Warning>

## grok-4-image 파라미터

`grok-4-image`는 현재 공식 이미지 인터페이스 기준으로 사용됩니다.

| 파라미터              | 타입      | 필수  | 설명                                                            |
| ----------------- | ------- | --- | ------------------------------------------------------------- |
| `model`           | string  | 예   | `grok-4-image` 사용                                             |
| `prompt`          | string  | 예   | 이미지 설명 프롬프트                                                   |
| `n`               | integer | 아니오 | 생성 수량, 공식 범위 `1`에서 `10`. 안정적인 비용 제어가 필요하다면 먼저 `1`을 사용하는 것을 권장 |
| `response_format` | string  | 아니오 | `url` 또는 `b64_json`. 현재 프로덕션 실측으로 `url`이 안정적                  |
| `aspect_ratio`    | string  | 아니오 | 예: `1:1`, `16:9`, `9:16`, `3:2`, `auto`                       |
| `resolution`      | string  | 아니오 | `1k` 또는 `2k`                                                  |

<Note>
  `aspect_ratio`와 `resolution`은 xAI 이미지 인터페이스의 확장 파라미터입니다. OpenAI Python SDK를 사용할 때는 `extra_body`로 전달하고, cURL 또는 Node.js SDK를 사용할 때는 JSON body에 직접 넣을 수 있습니다.
</Note>

다음 파라미터는 전달하면 안 됩니다.

| 파라미터      | 이유                                                               |
| --------- | ---------------------------------------------------------------- |
| `size`    | xAI 공식 인터페이스가 지원하지 않으며, 전달하면 `Argument not supported: size`가 반환됨 |
| `quality` | xAI 공식 인터페이스가 지원하지 않음                                            |
| `style`   | xAI 공식 인터페이스가 지원하지 않음                                            |

## grok-4-image 예시

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.crazyrouter.com/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -d '{
      "model": "grok-4-image",
      "prompt": "A tiny yellow cube on a plain white background, minimal product photo",
      "n": 1,
      "response_format": "url",
      "aspect_ratio": "1:1",
      "resolution": "1k"
    }'
  ```

  ```python Python theme={null}
  from openai import OpenAI

  client = OpenAI(
      api_key="YOUR_API_KEY",
      base_url="https://api.crazyrouter.com/v1",
  )

  response = client.images.generate(
      model="grok-4-image",
      prompt="A tiny yellow cube on a plain white background, minimal product photo",
      n=1,
      response_format="url",
      extra_body={
          "aspect_ratio": "1:1",
          "resolution": "1k",
      },
  )

  print(response.data[0].url)
  ```

  ```javascript Node.js theme={null}
  import OpenAI from "openai";

  const client = new OpenAI({
    apiKey: "YOUR_API_KEY",
    baseURL: "https://api.crazyrouter.com/v1",
  });

  const response = await client.images.generate({
    model: "grok-4-image",
    prompt: "A tiny yellow cube on a plain white background, minimal product photo",
    n: 1,
    response_format: "url",
    aspect_ratio: "1:1",
    resolution: "1k",
  });

  console.log(response.data[0].url);
  ```
</CodeGroup>

## 응답 예시

실제 응답에는 `url`, `mime_type`, `revised_prompt` 등의 필드가 포함될 수 있습니다.

```json theme={null}
{
  "created": 1776527939,
  "data": [
    {
      "url": "https://...",
      "mime_type": "image/jpeg",
      "revised_prompt": "A tiny yellow cube on a plain white background..."
    }
  ]
}
```

<Note>
  `response_format: "url"`로 반환된 이미지 링크는 임시 링크이므로, 생성 후 즉시 다운로드하거나 다른 곳에 저장하세요.
</Note>

## grok-4-image 파라미터 차이

`grok-4-image`는 현재 아래의 안전한 서브셋만 사용하는 것을 권장합니다.

| 파라미터              | 지원 여부                                                                              |
| ----------------- | ---------------------------------------------------------------------------------- |
| `model`           | `grok-4-image` 사용                                                                  |
| `prompt`          | 지원                                                                                 |
| `n`               | `1`만 권장. 프로덕션 실측 결과 `n=2`가 이미지 1장만 반환하면서도 2장으로 과금될 수 있음; 게이트웨이에서 이미 `1`만 허용하도록 제한함 |
| `response_format` | `url`이 안정적. `b64_json` 요청은 허용되지만 프로덕션 실측 결과 여전히 `url`이 반환됨                         |
| `aspect_ratio`    | 요청은 허용되지만, 서드파티 채널이 엄격히 준수하는지는 실제 반환 결과를 기준으로 판단해야 함                               |
| `resolution`      | 요청은 허용되지만, 서드파티 채널이 엄격히 준수하는지는 실제 반환 결과를 기준으로 판단해야 함                               |

`grok-4-image`에 대해 다음을 보장하지 마세요.

* 다중 이미지 `n > 1`
* `b64_json`이 반드시 base64를 반환함
* `size`
* `quality`
* `style`
* 이미지 편집 기능

## grok-4-image 예시

```bash theme={null}
curl -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "grok-4-image",
    "prompt": "A single red cube on a plain white background, product photo",
    "n": 1,
    "response_format": "url"
  }'
```

## 과금 설명

| 모델             | 현재 과금                                  |
| -------------- | -------------------------------------- |
| `grok-4-image` | `$0.02 / image`, 할인 미설정                |
| `grok-4-image` | 현재 가격은 `$0.08 * 0.55 = $0.044 / image` |

<Note>
  실제 pricing 페이지와 소비 로그를 기준으로 하세요. 이미지 모델은 장당 과금되며 입력/출력 토큰 기준으로 과금되지 않습니다.
</Note>

## 자주 발생하는 오류

| 오류                             | 처리 방법                                                            |
| ------------------------------ | ---------------------------------------------------------------- |
| `Argument not supported: size` | Grok 이미지 모델에 `size`를 전달하지 말고 `aspect_ratio`와 `resolution`을 사용하세요 |
| `model_price_error`            | 대상 모델에 가격이 설정되지 않았거나 토큰에 권한이 없습니다. 먼저 pricing과 모델 목록을 확인하세요      |
| `model_not_found`              | 모델명, 토큰 권한, 또는 채널 가용성이 일치하지 않습니다. 먼저 `GET /v1/models`로 확인하세요     |