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

# Grok Imagine 공식 이미지 생성

> APIYI의 Grok Imagine 공식 채널 완벽 가이드: grok-imagine-image / grok-imagine-image-quality / grok-imagine-image-2.0을 다루며, xAI와 동일한 가격으로 해상도(1k / 1.5k / 2k) 및 품질 등급(low / medium)에 따라 이미지당 $0.02–0.08로 과금됩니다. 신청을 통한 GrokOfficial 그룹 이용이 필요합니다.

## 개요

**Grok Imagine Official**은 xAI 이미지 모델을 위한 **공식 채널**입니다. 요청은 APIYI를 통해 공식 xAI API로 릴레이되며, **가격은 xAI 정가와 동일**하고 해상도 및 품질 티어에 따라 과금되며, 매개변수 유효성 검사는 업스트림과 동일합니다.

표준형 `grok-imagine-image`, 고품질 `grok-imagine-image-quality`, 최신 **`grok-imagine-image-2.0`**(`low` / `medium` 품질 티어 지원)의 세 가지 모델을 사용할 수 있습니다.

> [!WARNING]
>
> **🔒 이 채널은 신청 후 승인이 필요한 `GrokOfficial` 그룹 전용입니다**
>
> Grok Imagine Official은 `Default` 그룹에 포함되어 있지 않습니다. 이 제품군의 콘텐츠 안전 정책은 플랫폼의 다른 모델과 크게 다르므로, 규정 준수 위험을 방지하고자 권한을 **선택적으로** 부여하고 있습니다.
>
> * **누적 소비 금액 \$1,000+ 이상인 기존 고객**: 고객 지원팀에 문의하여 사용 사례를 설명해 주시면 확인 후 활성화해 드립니다.
> * **그 외 모든 고객**: [WeCom 고객 지원](https://work.weixin.qq.com/kfid/kfc9adfd5810ece25ec)을 통해 **사용 사례**와 **콘텐츠 모더레이션 제어 조치**를 기재하여 신청해 주시면 승인 후 활성화해 드립니다.
>
> `GrokOfficial` 그룹이 없는 Token은 서비스 장애가 아닌 권한 문제로 인해 **`503`** 오류를 반환합니다. 자세한 내용은 아래의 [그룹 설정](#group-setup)을 참조하십시오.

> [!TIP]
>
> **공식 채널인가요, 리버스인가요?** 이 페이지는 공식 채널에 대한 안내입니다. xAI와 동일한 가격, 티어별 과금, `grok-imagine-image-2.0` 포함, 그리고 **현재 1회 호출당 1장의 이미지 생성(텍스트-이미지)만 지원**합니다. **이미지 편집, 1회 호출당 여러 장 생성**, 또는 해상도에 관계없이 저렴한 고정 가격(이미지당 \$0.02 / \$0.045)이 필요한 경우 [Grok Imagine Reverse](/ko/api-capabilities/grok-imagine-image/overview)를 이용하십시오. 상세 비교는 [공식 채널 vs 리버스 비교](#official-vs-reverse)를 참조하십시오.

> [!NOTE]
>
> 모든 이미지 API는 **동기식**입니다. 비동기 작업 ID가 없으므로 클라이언트 연결이 끊어지면 결과가 유실되더라도 요청에 대한 과금은 그대로 청구됩니다. 테스트 결과 `medium` 품질 및 2K 해상도의 `grok-imagine-image-2.0`는 약 60\~80초가 소요되므로, 이 모델에 타임아웃을 넉넉하게 설정하십시오. 자세한 내용은 [이미지 API 주의 사항 및 모범 사례](/ko/api-capabilities/image-api-best-practices)를 참조하십시오.

> **[텍스트-이미지 API](/ko/api-capabilities/grok-imagine-image-official/text-to-image)**
>
> 대화형 Playground를 통해 텍스트 prompt로부터 이미지를 생성합니다.

> **[Grok Imagine Video](/ko/api-capabilities/grok-imagine-video/overview)**
>
> 동일한 `GrokOfficial` 그룹 적용 — 초당 과금되는 텍스트-비디오 및 이미지-비디오 생성.

## AI 에이전트로 연동하기

이 프로젝트에 Grok Imagine Official 텍스트-투-이미지를 연동/트러블슈팅하십시오.

코드를 작성하기 전에 문서를 읽으십시오: 이 페이지의 일반 텍스트 버전을 확인하려면 [https://docs.apiyi.com/en/api-capabilities/grok-imagine-image-official/overview.md](https://docs.apiyi.com/en/api-capabilities/grok-imagine-image-official/overview.md) 를 가져오십시오. 자세한 파라미터 정보는 동일한 방식으로 텍스트-투-이미지 페이지 URL 끝에 `.md`를 추가하여 확인하십시오.

요구사항:

1. 모델 하나를 선택하십시오: `grok-imagine-image`(표준), `grok-imagine-image-quality`(고품질) 또는 `grok-imagine-image-2.0`(최신 모델, 두 가지 `quality` 티어 제공). token 그룹에 `GrokOfficial`가 반드시 포함되어야 하며, 그렇지 않으면 모든 호출에서 503이 반환됩니다.

2. 타임아웃: 안전 여유를 두어 클라이언트 타임아웃을 360초로 설정하십시오. `grok-imagine-image`는 약 8초, `-quality`는 약 7~~12초 소요되지만, `grok-imagine-image-2.0`의 `medium` 및 2K 설정은 60~~80초가 소요됩니다. 이미지 API는 동기식입니다. 클라이언트 연결이 끊어지면 결과를 잃게 되며 요청 요금은 여전히 과금됩니다. 리버스 프록시, 게이트웨이 및 서버리스 런타임의 제한 시간도 늘리십시오.

3. 엔드포인트: 텍스트-투-이미지에는 `/v1/images/generations`(JSON)만 사용하십시오. **이 엔드포인트로 참조 이미지를 전송하지 마십시오**(`image` / `image_url` 등) — 무시된 채 삭제됩니다. 이 채널은 아직 이미지 편집 기능을 제공하지 않으므로, 편집이 필요한 경우 `/en/api-capabilities/grok-imagine-image/overview`의 리버스 채널을 사용하십시오.

4. 크기: `resolution`(`1k` / `1.5k` / `2k`, 소문자)와 `aspect_ratio`(예: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`)를 함께 사용하여 출력을 제어하십시오. **`size`를 전송하지 마십시오** — 해상도 티어에 매핑되지 않으므로 기본 1k로 이미지가 출력됩니다. 허용된 범위를 벗어난 값은 자동으로 대체되는 대신 422를 반환합니다.

5. 품질: `grok-imagine-image-2.0`에만 `quality`가 있습니다. `low`(기본값) 또는 `medium`만 전송해야 하며, `auto` 또는 `high`는 절대 전송하지 마십시오(`high` 전송 시 400 반환). 다른 두 모델은 `quality`가 필요하지 않습니다. 충실도를 선택하려면 모델을 변경하십시오.

6. 수량: 항상 `n` = 1로 전송하십시오. 여러 이미지를 생성하려면 `n`를 사용하는 대신 여러 요청을 동시에 전송하십시오.

7. 응답 처리: 기본값은 `url`이며, `response_format: "b64_json"`를 전송할 수도 있습니다. URL을 사용하는 경우 링크만 보관하지 말고 즉시 서버에 이미지를 다운로드하여 저장하십시오. `usage` 필드는 플레이스홀더이며(`prompt_tokens`는 항상 이미지 수의 1,000배임) **정산용으로 사용할 수 없습니다** — 콘솔 과금 내역을 확인하십시오.

8. `APIYI_API_KEY` 환경 변수에서 키를 읽고 [https://api.apiyi.com/v1](https://api.apiyi.com/v1) 을 base\_url로 사용하십시오. 절대 하드코딩하거나 git에 커밋하지 마십시오. 완료되면 실제로 텍스트-투-이미지 호출을 1회 실행하여 출력 결과와 해당 호출 비용을 보여주십시오.

## 모델 및 가격

요금은 xAI의 정가와 일치하며 **이미지당** 과금됩니다. 등급은 `resolution`에 의해 결정됩니다(2.0의 경우 `quality` 추가):

| 모델 | 품질 등급 | `1k` | `1.5k` | `2k` |
| - | - | - | - | - |
| **`grok-imagine-image`** | — | \$0.02 | \$0.02 | \$0.02 |
| **`grok-imagine-image-quality`** | — | \$0.05 | \$0.06 | \$0.07 |
| **`grok-imagine-image-2.0`** | `low` (기본값) | \$0.04 | \$0.05 | \$0.06 |
| **`grok-imagine-image-2.0`** | `medium` | \$0.06 | \$0.07 | \$0.08 |

> [!NOTE]
>
> 모델 가격은 공식 사이트 기준에 맞춰 책정되며 변동 사항이 발생할 경우 함께 변경될 수 있습니다. 위 표는 참고용이며, 상단 내비게이션의 **모델 가격** 탭이 기준이 됩니다: [모델 가격](/en/models/index).

> [!NOTE]
>
> **과금 안내**
>
> * **기본값**: `resolution`의 기본값은 `1k`이며, `grok-imagine-image-2.0`의 기본값은 `quality: low`(즉, 이미지당 \$0.04)입니다.
> * **이미지당 과금, 1회 호출당 1장**: 이 채널에서는 `n=1` 설정을 유지하고, 더 많은 이미지가 필요한 경우 동시 호출하십시오.
> * **실패한 요청은 과금되지 않음**: 파라미터 오류(422 / 400), 그룹 접근 권한 없음(503) 및 기타 오류 응답에는 과금되지 않습니다.
> * **`usage`을(를) 기준으로 대조하지 마십시오**: `prompt_tokens`은(는) 항상 플레이스홀더인 `1000 × image count`이며, 콘솔 과금 내역이 최종 기준입니다.
> * [구간별 충전 보너스](/ko/faq/recharge-promotions)가 추가로 적용됩니다. 대규모 비즈니스 고객은 전용 요금에 대해 영업팀에 문의하실 수 있습니다.

## 공식 vs 리버스

APIYI는 Grok Imagine을 위한 공식 채널과 리버스 채널을 모두 제공합니다. **두 채널은 그룹, 과금 및 지원 기능에서 차이가 있습니다**:

| 항목 | **공식** (현재 페이지) | [**리버스**](/ko/api-capabilities/grok-imagine-image/overview) |
| - | - | - |
| 그룹 | `GrokOfficial` (신청 필요) | `Grok_imagine_Reverse` (신청 필요) |
| 과금 | **xAI 정가와 동일**, 해상도 × 품질 등급별 측정 | 해상도에 관계없이 이미지당 고정 요금 |
| 모델 | `grok-imagine-image` / `-quality` / **`-2.0`** | `grok-imagine-image` / `-quality` |
| 해상도 등급 | `1k` / `1.5k` / `2k` | `1k` / `2k` |
| 텍스트 투 이미지 | ✅ | ✅ |
| 이미지 편집 / 다중 이미지 합성 | 아직 지원하지 않음 | ✅ 참조 이미지 1–4장 |
| 호출당 여러 이미지 생성 | 아직 지원하지 않음 (`n=1`) | ✅ `n` 최대 10장 |
| 파라미터 검증 | **엄격**: 범위를 벗어난 값은 422 반환 | 관대: 유효하지 않은 값은 오류 없이 기본값으로 자동 대체 |

> [!TIP]
>
> **선택 방법**: `grok-imagine-image-2.0`이 필요하거나, xAI 자체 조건에 따른 과금을 원하거나, 오타 입력 시 명확하게 오류가 발생하기를 원한다면 → 공식 채널을 선택하십시오. 이미지 편집, 호출당 여러 이미지 생성 또는 2K 출력에 대한 최저 가격을 원한다면 → 리버스 채널을 선택하십시오. 두 그룹을 모두 보유하고 각각 고유한 Token으로 호출할 수도 있습니다.

## 그룹 설정

> [!WARNING]
>
> **Grok Imagine Official은 `Default` 그룹에 포함되어 있지 않습니다.** 이 모델은 \*\*`GrokOfficial` 그룹(xAI와 동일한 가격, 즉 위 표 참고)\*\*에 속해 있으며, 접근 권한을 신청해야 합니다.

### 이용 가능 대상

| 고객 유형 | 신청 방법 |
| - | - |
| **누적 사용액 \$1,000+ 이상 기존 고객** | 사용 사례를 기재하여 고객지원팀에 문의, 확인 후 활성화 |
| **그 외 모든 사용자** | 사용 사례 및 콘텐츠 검수 제어 방안과 함께 신청, 승인 후 활성화 |

### 신청 방법

**1. WeCom 고객지원 문의**

[WeCom 고객지원](https://work.weixin.qq.com/kfid/kfc9adfd5810ece25ec)을 통해 신청하거나 [hi@apiyi.com](mailto:hi@apiyi.com)으로 이메일을 보내십시오. **`GrokOfficial` (Grok Imagine Official)** 신청이라고 명시해 주시기 바랍니다.

**2. 사용 사례 및 검수 제어 방안 기재**

다음 세 가지 사항을 포함해 주십시오: 이미지 사용 목적, 최종 사용자, 귀사 측에서 진행하는 콘텐츠 검토 및 수동 검수 절차. 구체적일수록 검토가 더 빠르게 진행됩니다.

**3. 승인 후 Token 그룹 전환**

승인이 완료되면 계정에 `GrokOfficial`을 활성화해 드립니다. [콘솔의 Token 페이지](https://api.apiyi.com/token)로 이동하여 이 채널에 사용할 Token을 `GrokOfficial`(으)로 전환하고, 과금 방식을 `Pay-as-you-go Priority` 또는 `Pay-as-you-go`(으)로 설정하십시오.

> [!NOTE]
>
> **권한 부여 전 확인 사항**: `GrokOfficial` 그룹이 설정되지 않은 Token은 \*\*`503` (현재 그룹에 사용 가능한 채널 없음)\*\*을 반환합니다. 재시도해도 해결되지 않으므로, 먼저 그룹을 활성화해야 합니다.
>
> **`Pay-per-request` 과금 방식을 사용하지 마십시오**: 이 채널은 종량 과금 방식이므로 요청당 지불 Token은 라우팅할 수 없으며 동일하게 503 오류를 반환합니다.

> [!NOTE]
>
> **컴플라이언스 안내**: 권한이 부여된 후 생성된 콘텐츠에 대한 책임은 호출자에게 있습니다. 현지 법률 및 규정을 준수하십시오. 불법 콘텐츠, 타인의 초상권이나 지식재산권을 침해하는 콘텐츠, 미성년자에게 부적절한 콘텐츠를 생성해서는 안 됩니다. 일반 사용자 대상 서비스의 경우 자체 검수 레이어를 추가하십시오. 관련 참고 자료: [해외 모델 호출 시 컴플라이언스 주의사항](/ko/faq/overseas-model-compliance). 오남용이 발견될 경우 그룹 접근 권한이 취소됩니다.

## 기술 사양

| 항목 | 사양 |
| - | - |
| 모델 ID | `grok-imagine-image`, `grok-imagine-image-quality`, `grok-imagine-image-2.0` |
| 엔드포인트 | `POST /v1/images/generations` (`application/json`) |
| 해상도 등급 | `1k` (기본값) / `1.5k` / `2k` |
| 화면 비율 | 일반: `1:1` (기본값) / `16:9` / `9:16` / `4:3` / `3:4` / `3:2` / `2:3` |
| 품질 등급 | `grok-imagine-image-2.0` 전용: `low` (기본값) / `medium` |
| 호출당 이미지 수 | `n=1` |
| 응답 형식 | `url` (기본값) 또는 `b64_json` |
| 매개변수 유효성 검사 | 엄격함 — 범위를 벗어난 `resolution` / `aspect_ratio`는 422를 반환합니다 |
| 지연 시간 | `grok-imagine-image` 약 8초; `-quality` 1k 기준 약 7초 및 2k 기준 12초; `-2.0` `low` 약 15–17초, `medium` 2K 약 60–80초 |
| 권장 클라이언트 타임아웃 | ≥ 360초 |

## 주요 매개변수

### `resolution` 및 `aspect_ratio` (출력 크기)

이 두 매개변수가 함께 출력 픽셀 수를 결정합니다. 몇 가지 실제 측정 결과는 다음과 같습니다:

| 모델 | 요청 | 실제 출력 |
| - | - | - |
| `grok-imagine-image` | `1k` + `3:2` | 1248×832 (JPEG) |
| `grok-imagine-image-quality` | `2k` + `9:16` | 1584×2816 (PNG, 약 6.7 MB) |
| `grok-imagine-image-2.0` | `1.5k` + `16:9` + `medium` | 1792×1008 |

> [!WARNING]
>
> **`size`이 아닌 `resolution`을 사용하십시오**
>
> 이 채널은 OpenAI 스타일의 `size`(예: `"2048x2048"`)을 해상도 등급에 매핑하지 않습니다. `size`을 전달해도 오류가 발생하지는 않지만, 이미지는 기본값인 `1k`로 생성되며 해당 기준으로 과금됩니다. 2K 해상도를 원하시면 `resolution: "2k"`을 명시적으로 전달하십시오.

> [!NOTE]
>
> **잘못된 요청은 명확히 실패합니다**: 반대 채널과 달리 이곳의 매개변수 유효성 검사는 xAI와 일치합니다. `resolution: "4k"` 또는 `aspect_ratio: "5:7"`와 같이 범위를 벗어난 값은 **422**를 반환하며 과금되지 않습니다. 422 오류가 발생하면 먼저 이 두 매개변수의 철자를 확인하십시오(모두 소문자: `1k` / `1.5k` / `2k`).

### `quality` (`grok-imagine-image-2.0` 전용)

| 값 | 참고 사항 |
| - | - |
| `low` | 기본값, 더 빠름 |
| `medium` | 더 높은 충실도, 이미지당 \$0.02 추가, 2K 기준 약 60\~80초 |

`high`을 전달하면 400(`This model only supports the following quality value(s): low, medium, auto`)이 반환됩니다. **`low` 또는 `medium`만 전송하십시오** — `auto`은 전송하지 마십시오. `grok-imagine-image` 및 `grok-imagine-image-quality`은 `quality`을 받지 않으며, 모델 자체가 충실도를 설정합니다.

### `n` (이미지 수)

이 채널에서는 **항상 `n=1`을 전송하십시오**. 여러 이미지를 한 번에 생성하려면 여러 요청을 동시에 전송하십시오 — 지연 시간은 일정하므로 동시 실행 수에 따라 선형적으로 확장됩니다.

## 모범 사례

**1. 1k에서 탐색하고 2k에서 완성하십시오**

`1k`에서 prompt를 몇 번 실행하여 방향을 결정한 다음, `2k`에서 최종본을 렌더링하십시오. `grok-imagine-image-2.0`은 `medium` 및 2K에서 1분 이상 소요되므로, 시행착오를 거치기에는 적합하지 않습니다.

**2. 클라이언트 타임아웃을 360초로 설정하십시오**

이미지 API는 동기식입니다. 타임아웃을 60초로 설정하면 2.0 `medium`에서 잦은 오탐 타임아웃이 발생할 수 있으며, 클라이언트에서 중단한 요청에도 여전히 과금됩니다.

**3. 구도 설정에는 prompt가 아닌 aspect\_ratio를 사용하십시오**

해당 매개변수는 실제로 적용되므로, `aspect_ratio: "16:9"`를 사용하는 편이 prompt에 “가로 구도”라고 작성하는 것보다 훨씬 안정적입니다.

**4. URL 결과는 즉시 저장하십시오**

반환된 이미지 링크는 즉시 서버의 자체 스토리지로 다운로드하십시오. 해당 링크를 계속해서 참조하거나 최종 사용자에게 전달하지 마십시오.

**5. 편집 시에는 리버스 채널로 전환하십시오**

이 채널은 아직 이미지 편집 기능을 제공하지 않습니다. 참조 기반 편집 및 다중 이미지 합성을 수행하려면 `/v1/images/edits`를 [Grok Imagine Reverse](/ko/api-capabilities/grok-imagine-image/overview)에서 사용하십시오.

## 오류 코드 및 재시도

| HTTP | 의미 | 조치 방법 |
| - | - | - |
| `400` | 유효하지 않은 `quality`(`high` 등). 메시지에 허용된 값이 나열됩니다 | `low` / `medium`(으)로 변경하십시오. 재시도하지 마십시오 |
| `422` | 허용된 범위를 벗어난 `resolution` / `aspect_ratio` | 철자 및 대소문자를 확인하십시오. 재시도하지 마십시오 |
| `429` | 요청 제한 도달 또는 잔액 부족 | 지수 백오프로 재시도하고 잔액을 확인하십시오 |
| `503` | Token에 `GrokOfficial` 그룹이 없거나, Token이 요청당 과금 방식을 사용 중입니다 | **장애가 아닌 권한 문제입니다** — 재시도해도 해결되지 않습니다. [그룹 설정](#group-setup)을 확인하십시오 |

> [!NOTE]
>
> **클라이언트 권장 사항**: `400` / `422`은(는) 결정론적 오류이므로 재시도하는 것은 무의미하며, 대신 알림을 발생시켜야 합니다. 재시도할 가치가 있는 것은 `429` 및 네트워크 수준 타임아웃뿐이며, 지수 백오프를 적용하여 최대 3회까지만 재시도하십시오. 오류 응답은 과금되지 않습니다.

## 자주 묻는 질문

> **모든 호출에서 503이 반환됩니다 — 채널이 다운되었나요?**
>
> 거의 확실하게 권한 문제입니다. 두 가지 가능성이 있습니다:
>
> 1. **Token 그룹에 `GrokOfficial` 권한이 없습니다**: 이 채널은 신청 시 부여됩니다. [그룹 설정](#group-setup)을 참고하십시오.
> 2. **Token의 과금 방식이 요청당 과금입니다**: 이 채널은 종량제로 과금되며 요청당 과금 Token에서는 라우팅할 수 없습니다. 과금 방식을 `Pay-as-you-go Priority` 또는 `Pay-as-you-go`(으)로 변경하십시오.

> **size: 2048x2048을 전달했는데 출력 결과가 여전히 1K인 이유는 무엇인가요?**
>
> 이 채널은 `size`를 해상도 등급에 매핑하지 않으므로, 이미지가 기본값인 `1k`로 생성 및 과금됩니다. 대신 `resolution: "2k"`를 사용하고 `aspect_ratio`로 구도를 조절하십시오.

> **이미지를 편집하거나 참조 이미지를 전달할 수 있나요?**
>
> 이 채널은 **아직 이미지 편집 기능을 제공하지 않습니다**. `/v1/images/generations`에 참조 이미지를 전송해도 오류는 발생하지 않지만, 참조 이미지는 무시되며 prompt만으로 새 이미지가 생성됩니다.
>
> 편집이나 다중 이미지 합성이 필요한 경우, `/v1/images/edits`에서 1\~4개의 참조 이미지를 허용하는 [Grok Imagine Reverse](/ko/api-capabilities/grok-imagine-image/overview)에 대한 권한을 얻으십시오.

> **왜 n=1인가요? 한 번에 여러 장의 이미지를 받으려면 어떻게 해야 하나요?**
>
> 이 채널은 현재 단일 이미지 출력만 지원합니다. 더 많은 이미지를 원하시면 각각 `n=1`을 설정하여 여러 요청을 동시에 전송하십시오. 워크플로가 호출당 여러 이미지를 반드시 필요로 하는 경우, [Grok Imagine Reverse](/ko/api-capabilities/grok-imagine-image/overview)(`n` 최대 10개)를 사용하십시오.

> **grok-imagine-image-2.0은 다른 두 모델과 어떻게 다른가요?**
>
> `grok-imagine-image-2.0`은 xAI의 최신 이미지 모델이며 `quality` 등급(`low` / `medium`)을 추가했습니다. `medium`은 디테일이 더 정교하지만 생성 속도가 느립니다(2K 기준 약 60\~80초). `grok-imagine-image`은 가장 저렴하며 모든 해상도에서 비용이 동일합니다. `grok-imagine-image-quality`은 충실도가 더 높고 해상도별 차등 요금이 적용됩니다.
>
> 먼저 `grok-imagine-image` 또는 2.0 `low`에서 파이프라인이 정상 작동하도록 구성한 후, 품질 요구에 따라 상위 등급으로 전환하십시오.

> **usage의 token 수로 청구 요금을 대조할 수 있나요?**
>
> **아닙니다.** `usage.prompt_tokens`은 항상 `1000 × image count`이며, 이는 실제 비용과 무관한 플레이스홀더입니다. 이 채널은 해상도 및 품질 등급에 따라 이미지당 과금되며, 콘솔의 과금 기록이 기준이 됩니다.

> **공식 OpenAI SDK를 사용할 수 있나요?**
>
> 네, 가능합니다. 엔드포인트가 OpenAI Images API와 호환되므로, `base_url`을 `https://api.apiyi.com/v1`(으)로 지정하고 비표준 필드는 `extra_body`에 넣으시면 됩니다:
>
> ```python theme={null}
> from openai import OpenAI
> client = OpenAI(api_key="sk-your-api-key", base_url="https://api.apiyi.com/v1")
>
> resp = client.images.generate(
>     model="grok-imagine-image-2.0",
>     prompt="a red wooden boat on an alpine lake at dawn",
>     n=1,
>     extra_body={"resolution": "2k", "aspect_ratio": "16:9", "quality": "medium"},
>     timeout=360,
> )
> print(resp.data[0].url)
> ```

## 관련 문서

* [Grok Imagine 공식 텍스트-이미지 API](/ko/api-capabilities/grok-imagine-image-official/text-to-image) - Playground가 포함된 API 레퍼런스
* [Grok Imagine Video](/ko/api-capabilities/grok-imagine-video/overview) - 동일한 그룹, 텍스트-동영상 및 이미지-동영상
* [Grok Imagine Reverse](/ko/api-capabilities/grok-imagine-image/overview) - 이미지당 고정 요금, 편집 및 호출당 다중 이미지 지원
* [이미지 API 참고 사항 및 모범 사례](/ko/api-capabilities/image-api-best-practices) - 타임아웃, 연결 끊김 및 압축에 관한 일반 권장 사항
* [충전 보너스](/ko/faq/recharge-promotions)


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