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

# Grok Imagine 이미지 모델

> xAI의 WideRouter 이미지 모델 3종: 각 모델의 용도, 해상도 및 품질 비교표, 참조 이미지, 측정된 지연 시간입니다.

Grok Imagine은 xAI의 생성형 미디어 모델 제품군입니다. 이 중 세 가지 모델은
이미지를 생성하며, 세 모델 모두 [비동기 작업 API](/ko/api/async-tasks)에서 실행되고
플랫폼의 다른 모든 모델과 동일한 요청 형식을 사용합니다.

모델 ID는 xAI의 공식 이름과 정확히 일치합니다. WideRouter는 별칭을 제공하지 않습니다.

## 시리즈 한눈에 보기

|                | Grok Imagine 2.0         | Grok Imagine 품질              | Grok Imagine         |
| -------------- | ------------------------ | ---------------------------- | -------------------- |
| **모델 ID**      | `grok-imagine-image-2.0` | `grok-imagine-image-quality` | `grok-imagine-image` |
| 비동기 작업 API     | 예                        | 예                            | 예                    |
| 동기식 이미지 API    | 예                        | 예                            | 예                    |
| `quality` 매개변수 | **예**, `low` / `medium`  | 아니요                          | 아니요                  |
| 해상도 등급         | `1k` / `2k`              | `1k` / `2k`                  | `1k` / `2k`          |
| 기본 프레이밍        | 가로, 1248 × 832           | **세로, 864 × 1152**           | 가로, 1248 × 832       |
| 호출당 이미지 수      | 최대 4개                    | 최대 4개                        | 최대 4개                |
| 참조 이미지         | 최대 3개                    | 최대 3개                        | 최대 3개                |

세 가지 모두 한 가지를 제외하면 **동일한 매개변수**를 사용합니다. `grok-imagine-image-2.0`만
`quality`을 허용합니다. 나머지 두 모델에서는 품질을 선택할 수 없고 고정되어
있으므로 `unknown field`로 거부됩니다.

세 모델 중 선택하는 기준은 다음과 같습니다.

* \*\*`grok-imagine-image-2.0`\*\*은 조정 가능한 모델입니다. 비용과 충실도 사이에서 균형을
  조정하거나 특정 가로 세로 비율과 해상도가 필요할 때 사용합니다.
* \*\*`grok-imagine-image-quality`\*\*은 높은 품질로 고정되어 있으며 기본적으로 세로 프레임을
  사용합니다. 제어보다 품질이 중요할 때 사용합니다.
* \*\*`grok-imagine-image`\*\*은 세 모델 중 압도적으로 가장 저렴합니다. 초안, 썸네일 및
  대량으로 생성할 모든 항목에 사용합니다.

## 파라미터

봉투는 [비동기 작업 API](/ko/api/async-tasks)에 설명된 동일한 세 가지 키, 즉
`model`, `input` 및 선택 사항인
`callback_url`로 구성됩니다. 아래의 모든 항목은 `input` 내부에 들어갑니다.

| 필드             | 유형     | 기본값    | 참고                                                        |
| -------------- | ------ | ------ | --------------------------------------------------------- |
| `prompt`       | 문자열    | —      | 필수입니다. 비어 있을 수 없으며 최대 32000바이트입니다.                        |
| `resolution`   | 문자열    | `1k`   | `1k` 또는 `2k`. 소문자입니다.                                     |
| `quality`      | 문자열    | `low`  | `low` 또는 `medium`. **`grok-imagine-image-2.0`에서만 사용합니다.** |
| `aspect_ratio` | 문자열    | 모델 기본값 | 아래 16개 값 중 하나 또는 `auto`입니다.                               |
| `n`            | 정수     | 1      | 1\~4입니다. 각 이미지는 `outputs`의 개별 항목입니다.                      |
| `images`       | 문자열\[] | —      | `https` URL 또는 base64 데이터 URI 형식의 참조 이미지 최대 3개입니다.        |

`input` 내부 검증은 엄격합니다. 인식되지 않은 키는
`invalid_params` 및 해당 키를 정확히 명시하는 `param`와 함께 즉시 거부됩니다. 오타는
조용히 삭제되는 대신 명확하게 실패합니다.

<Warning>
  `resolution` 값은 **소문자**입니다(`1k`, `2k`). 이는
  `image_size`에서 대문자 `1K` / `2K` / `4K`를 사용하는
  Nano Banana 시리즈와 반대입니다. 두 제품군은 여기에서 파라미터 이름을 공유하지 않으므로
  이월할 항목이 없습니다. 저 표가 아니라 이 표를 읽으십시오.
</Warning>

## 해상도 및 품질

`grok-imagine-image-2.0`에서는 두 차원이 서로 독립적이며 둘 다 출력에 영향을 줍니다. 측정된 픽셀 크기의 샘플은 각각 다음과 같습니다.

| `resolution` | `quality`   | 출력                  |
| ------------ | ----------- | ------------------- |
| `1k` (기본값)   | `low` (기본값) | 832 × 1248          |
| `1k`         | `medium`    | `16:9`에서 1280 × 720 |
| `2k`         | `low`       | 1664 × 2496         |
| `2k`         | `medium`    | 2816 × 1584         |

나머지 두 모델에는 `resolution`만 적용됩니다. 측정 결과, `grok-imagine-image`을
`2k`에서 사용하면 2816 × 1584가 반환되며, `grok-imagine-image-quality`를 `2k`에서 사용하면
1776 × 2368이 반환됩니다.

정확한 픽셀 크기는 고정된 그리드가 아니라 모델이 결정합니다. 동일한
등급이라도 요청하는 화면 비율에 따라 다른 수치가 적용됩니다.
표의 값은 대략적인 규모로 참고하고, 실제 크기는 파일에서 확인하시기 바랍니다.

## 가로세로 비율

세 모델 모두 동일한 16개 값을 지원합니다.

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

이를 생략하면 각 모델은 자체 기본 구도를 사용합니다. `grok-imagine-image` 및 `grok-imagine-image-2.0`은 가로 방향, `grok-imagine-image-quality`은 세로 방향입니다. `auto`을 사용하면 모델이 prompt에서 선택합니다.

## 참조 이미지

`input.images`에 최대 3개의 이미지를 전달하여 해당 이미지에서 편집하거나 합성할 수 있습니다. 각
항목은 `https` URL 또는 base64 데이터 URI입니다:

```json theme={null}
{
  "model": "grok-imagine-image-2.0",
  "input": {
    "prompt": "put the teapot on a marble counter, warm morning light",
    "images": ["https://example.com/teapot.jpg"],
    "resolution": "2k"
  }
}
```

제출 시점에 네 번째 이미지는 거부됩니다:
`input.images` — `must contain at most 3 items`. 형식이 잘못된 항목은 해당 인덱스를 표시합니다:
`input.images[0]` — `must be an https URL or a base64 image data URI`.

WideRouter는 서버 측에서 URL을 가져오므로 공용 인터넷에서 해당 URL에 접근할 수 있어야 합니다. 확인되지 않는 호스트이거나 이미지가 아닌 항목을 반환하는 호스트는 제출 시점이 아니라 작업이 대기열에 추가된 후 작업을 실패시킵니다.

## 가격

이 모델들은 **`Grok-Official`** 그룹을 통해 제공됩니다. WideRouter의 정가는 xAI의 공식 가격과 정확히 일치하며, 할인은 `Grok-Official`에 대해 `0.8`인 **그룹
요율 배수**에 적용됩니다. 따라서 실제 지불 금액은 다음과 같습니다:

```
list price × group multiplier = charge
```

API가 반환하는 과금 수치와 모두 대조 확인된 이미지당 정가:

| 모델                           | `resolution` | `quality` | 정가                       |
| ---------------------------- | ------------ | --------- | ------------------------ |
| `grok-imagine-image`         | `1k` 또는 `2k` | —         | \$0.02 — 두 등급의 가격은 동일합니다 |
| `grok-imagine-image-2.0`     | `1k`         | `low`     | \$0.04                   |
| `grok-imagine-image-2.0`     | `1k`         | `medium`  | \$0.06                   |
| `grok-imagine-image-2.0`     | `2k`         | `low`     | \$0.06                   |
| `grok-imagine-image-2.0`     | `2k`         | `medium`  | \$0.08                   |
| `grok-imagine-image-quality` | `1k`         | —         | \$0.05                   |
| `grok-imagine-image-quality` | `2k`         | —         | \$0.07                   |

놓치기 쉬운 두 가지 규칙이 있습니다:

* **참조 이미지는 추가 비용이 발생합니다**. 입력 이미지당 약 \$0.01이며,
  출력 가격에 추가됩니다. 이미지 3개 합성은 출력 1개와 입력 3개로 가격이 책정됩니다.
* **`n`는 곱해집니다.** `2k` / `medium`에서 이미지 4개는 단일 이미지
  가격의 4배이며, 대량 요금이 아닙니다.

<Info>
  완료된 작업에는 `usage.cost_in_usd_ticks`이 포함되며, `10000000000` 틱은
  \$1입니다. 이 수치는 그룹 요율 배수 적용 전의 **정가**입니다.
  실제로 잔액에서 차감되는 금액을 확인하려면 그룹 요율을 곱하십시오.
</Info>

## 지연 시간

비동기 API에서 엔드투엔드로 측정했으며, `completed`에 제출하고 기본 설정에서
각각 하나의 샘플을 사용했습니다.

| 모델                           | 엔드투엔드 |
| ---------------------------- | ----- |
| `grok-imagine-image`         | 6.6초  |
| `grok-imagine-image-quality` | 6.6초  |
| `grok-imagine-image-2.0`     | 10초   |

이 속도는 충분히 빨라서 제출한 후 2\~3초마다 폴링하는 비동기 왕복 과정이
생성 자체보다 실제 경과 시간을 더 많이 소모하는 경우가 많습니다.
일반적으로 폴링은 두 번이면 충분합니다.

## 동기 인터페이스

세 모델 모두 `POST /v1/images/generations`에서도 응답하며, 연결을 열린 상태로 유지하고 이미지를 직접 반환합니다.

```bash theme={null}
curl https://api.widerouter.com/v1/images/generations \
  -H "Authorization: Bearer $WIDEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "a small ceramic teapot on a light-grey studio backdrop",
    "resolution": "2k",
    "response_format": "b64_json"
  }'
```

응답은 `data`와 `usage`로 구성됩니다. `data[0]`에 들어오는 내용은
`response_format`에 따라 달라집니다. 바이트를 인라인으로 반환하는 경우에는 `b64_json`, 링크를 반환하는 경우에는 `url`입니다.

<Warning>
  **`response_format: "url"`을 사용하면 링크는 WideRouter의 CDN이 아니라 xAI 자체 호스트를
  가리키며**, 해당 링크의 유효 기간은 보장할 수 없습니다. 측정 결과, `2k`
  생성 결과는 `imgen.x.ai`에서 5.2MB **PNG**로 반환되었으며, 비동기 API에서
  동일한 모델은 문서에 명시된 24시간 동안 WideRouter CDN을 통해 JPEG를
  반환합니다. 여기서는 `b64_json`를 우선 사용하거나 비동기 API를 사용하십시오.
</Warning>

동기 경로는 바이트를 즉시 반환받으려는 스크립트에 더 간단하지만, 전체 생성이
완료될 때까지 연결을 유지합니다. `2k`에서 측정한 시간은 19.4초였습니다.
서버리스 함수, 리버스 프록시 또는 모바일 클라이언트 뒤에서 실행되는 경우에는
대신 비동기 API를 사용해야 합니다.

## 다음 단계

<CardGroup cols={2}>
  <Card title="플레이그라운드" icon="play" href="/ko/models/grok-imagine/image/playground">
    브라우저에서 실제 요청을 전송하고 작업이 완료되는 과정을 확인합니다.
  </Card>

  <Card title="Grok Imagine 동영상" icon="film" href="/ko/models/grok-imagine/video/overview">
    이 제품군의 동영상 기능으로, 클립을 생성하고 편집하며 확장합니다.
  </Card>
</CardGroup>