Grok Imagine Image 2.0 API
API 연동 전에 Grok Imagine Image 2.0을 사용해 보세요.
정식 연동 전에 출력 품질을 테스트하고, 크레딧 사용량을 추정하고, 샘플을 생성해 보세요.
Create image task
Fixed to grok-imagine-image-2.0Optional. Add 1-3 images to switch to editing mode. Each input image is billed once per request.

크레딧을 추가하기 전에 테스트 비용을 파악하세요.
가격은 해상도(1K/2K) × 품질(Low/Medium)의 간단한 매트릭스입니다. 샘플 한 장의 비용에서 시작해 테스트 예산을 선택하세요.
First Test Cost
Text-to-Image - 1K - Low qualityOne 1K Low prompt-only image
About 333 tests with $10 in credits.
Start with the 1K Low tier for drafts, then switch to Medium or 2K for the final check. Input images add a per-image fee once per request.
Testing Budget Guide
Pick an amount based on how many tests you expect.Good for a first validation.
Good for prompt iteration.
Good before production integration.
Common Cost Examples
Estimated cost for one generated image. Multiply the output rate by n for multi-image requests; input image fees are charged once per request.
Model Pricing
| Item | Rule | Rate | Billing |
|---|---|---|---|
| 1K · Low | Fastest tier (~10s) for drafts and prompt iteration. | $0.030/image-25% 2.04 cr/image$0.040 공식 가격 | Per output image |
| 1K · Medium (default) | Default tier with better detail; generation may take 10-75s. | $0.045/image-25% 3.06 cr/image$0.060 공식 가격 | Per output image |
| 2K · Low | Higher resolution with the fast quality tier. | $0.045/image-25% 3.06 cr/image$0.060 공식 가격 | Per output image |
| 2K · Medium | Highest tier for final quality checks. | $0.060/image-25% 4.08 cr/image$0.080 공식 가격 | Per output image |
Optional Add-ons & Billing NotesInput image pricing and multi-image requests.
| Item | Rule | Rate | Billing |
|---|---|---|---|
| Input images | Applied to each input image in image_urls (max 3), charged once per request regardless of n. | $0.0075/image-25% 0.51 cr/image$0.010 공식 가격 | Per input image |
| Multiple outputs (n) | n can be 1-10. The output rate is multiplied by n; failed tasks are not charged. | Output rate × n | Per request |
Grok Imagine Image 2.0의 이미지 생성·편집 능력
Grok Imagine Image 2.0은 공식 모델 ID grok-imagine-image-2.0을 사용하며, 하나의 API 라우트에서 텍스트-이미지 생성과 1-3장의 참조 이미지 편집을 지원합니다. 13가지 비율, 1K/2K 출력, 요청당 최대 10장 배치 생성을 제공합니다.
Grok Imagine Image 2.0 가이드와 비교
Grok Imagine Image 2.0 핵심 이미지 기능

프롬프트 하나로 상업용 비주얼 생성

참조 이미지로 편집 방향 지정

참조 이미지 2-3장 합성
Grok Imagine Image 2.0 API에 적합한 이미지 워크플로
마케팅 비주얼 생성
입력 이미지로 편집
n으로 배치 생성
티어로 비용 관리
이미지 API 포지셔닝과 모델 선택
| 특징 | Grok Imagine Image 2.0 | Seedream 5.0 Pro | GPT Image |
|---|---|---|---|
| 시작 가격 | 약 $0.030 / 장 | 약 $0.034 / 장부터 | 토큰 또는 티어 기반 |
| 출력 티어 | Low/Medium × 1K/2K | 1K / 2K | 품질 티어 |
| 레퍼런스 입력 | 최대 3장 | 최대 10장 | 지원 |
| 요청당 이미지 수 | 1-10장 | 1장 | 모델에 따라 다름 |
| 적합한 용도 | 빠른 반복, 배치 제작, 레퍼런스 편집 | 광고, 제품 크리에이티브, 이미지 편집 | OpenAI 이미지 워크플로 |
모델 ID, 참조 이미지, 출력 제한
공식 모델 ID와 두 가지 이미지 모드
모델 ID는 grok-imagine-image-2.0입니다. 프롬프트만 보내면 텍스트-이미지 생성, 입력 이미지 1-3장을 추가하면 같은 ID로 이미지 편집 모드로 전환됩니다. 별도의 편집 모델 ID가 필요 없습니다.
품질과 해상도는 독립적
quality(low/medium)는 생성 강도와 속도를, resolution(1k/2k)은 출력 픽셀을 제어합니다. 둘 다 가격 매트릭스에 반영되며, 네 가지 조합은 기준가의 1×/1.5×/1.5×/2×입니다.
입력 요금은 한 번만
입력 이미지 한 장당 요청마다 기준가의 0.25×가 추가되며 n과 무관합니다. 실패한 작업은 과금되지 않습니다.
EvoLink 통합 API로 Grok Imagine Image 2.0을 사용하는 이유
생성 전 실시간 비용 확인
작업을 제출하기 전에 해상도, 품질, 출력 수, 참조 이미지에 따른 현재 가격과 예상 크레딧을 확인할 수 있습니다.
통합 API
하나의 API 키로 Grok, Seedream, Nano Banana, GPT Image, 비디오, 오디오, LLM 모델을 사용합니다.
통합 잔액
하나의 콘솔에서 크레딧, 지출, 모델 사용량을 추적합니다.
작업 상태 추적
이미지 작업이 제출됨, 처리 중, 완료, 실패 중 어느 상태인지 확인할 수 있습니다.
안정적인 결과 호스팅
생성된 이미지는 EvoLink CDN에 저장되어 업스트림 링크가 만료된 후에도 사용할 수 있습니다.
Grok 모델 패밀리



EvoLink의 다른 이미지 모델




자주 묻는 질문
Grok Imagine Image 2.0 API의 공식 모델 ID는 무엇인가요?
공식 모델 ID는 grok-imagine-image-2.0입니다. 텍스트-이미지 생성과 1-3장 참조 이미지 편집 모두 같은 ID를 사용하며, 별도의 편집 모델로 전환할 필요가 없습니다.
Grok Imagine Image 2.0의 가격은 얼마인가요?
해상도 × 품질 매트릭스로 과금됩니다. 1K Low가 기준가이고, 1K Medium과 2K Low는 1.5배, 2K Medium은 2배입니다. 출력 요금은 n배가 되며, 입력 이미지 한 장당 요청마다 기준가의 0.25배가 추가됩니다.
API 연동 전에 미리 볼 수 있나요?
네. Playground에서 출력 품질을 테스트하고, 크레딧을 추정하고, 요청 JSON을 확인한 후 제품에 연동할 수 있습니다.
quality와 resolution의 차이는 무엇인가요?
quality(low/medium)는 생성 강도를 제어합니다. low는 약 10초, medium은 10-75초가 걸리지만 디테일이 더 좋습니다. resolution(1k/2k)은 출력 픽셀을 제어합니다. 서로 독립적인 파라미터이며 둘 다 가격에 영향을 줍니다.
이미지 편집은 어떻게 사용하나요?
image_urls에 1-3개의 이미지 URL을 프롬프트와 함께 전달하세요. 모델이 자동으로 편집 모드로 전환됩니다. 여러 장일 경우 프롬프트에서 <IMAGE_0>, <IMAGE_1>, <IMAGE_2>로 각 이미지를 지정합니다.
n으로 여러 장을 생성할 수 있나요?
네. 한 요청에서 n은 1-10까지 가능합니다. 출력 요금은 n배가 되지만 입력 이미지 요금은 요청당 한 번만 부과됩니다.
입력 이미지도 과금되나요?
네. image_urls의 입력 이미지 한 장당 기준가의 0.25배가 추가되며, 요청당 한 번만 부과되고 n과 무관합니다. 공개 http(s) URL만 허용되며 base64 업로드는 거부됩니다.
커스텀 픽셀 크기를 지정할 수 있나요?
아니요. size는 13가지 비율 프리셋과 auto만 허용합니다. 커스텀 가로 × 세로 값은 지원되지 않으며, 해상도는 별도의 1k/2k 파라미터로 제어합니다.
생성에 실패하면 어떻게 되나요?
실패한 작업은 과금되지 않습니다. 업스트림 거부, 콘텐츠 모더레이션 차단, 타임아웃을 포함해 선점된 금액이 전액 환불됩니다.
충전 후에는 어디로 가나요?
Playground로 돌아가 테스트를 계속하거나, API 키를 만들어 model에 grok-imagine-image-2.0을 지정하고 /v1/images/generations를 호출하세요.
API Reference
Select endpoint
Authentication
All APIs require Bearer Token authentication.
Authorization:
Bearer YOUR_API_KEY/v1/images/generationsGenerate Image
Grok Imagine Image 2.0 is xAI's image generation and editing model — text-to-image and image editing share the same model name. Omit image_urls for text-to-image; pass 1-3 reference images and it automatically switches to image editing, no model change needed.
Asynchronous processing mode, use the returned task ID to .
Generated image links are valid for 24 hours, please save them promptly.
Request Parameters
modelstringRequiredDefault: grok-imagine-image-2.0Image generation model name. Text-to-image and image editing share this model name; the mode switches automatically depending on whether image_urls is provided.
| Value | Description |
|---|---|
| grok-imagine-image-2.0 | Grok Imagine Image 2.0 model |
grok-imagine-image-2.0promptstringRequiredPrompt describing the image you want to generate, or how to edit the reference images you provide.
Notes
- Multi-image reference syntax: use <IMAGE_0>, <IMAGE_1>, <IMAGE_2> in the prompt to refer to the 1st, 2nd and 3rd reference image respectively
- Indexes start at 0 and map one-to-one to the order of the image_urls array
- Example: Place the person from <IMAGE_0> into the scene of <IMAGE_1>
Cyberpunk Tokyo street at night, neon lights reflecting on the wet pavementimage_urlsarrayOptionalReference image URL list for image-to-image and image editing functions.
Notes
- Number of input images per request: 0~3 (omitted = text-to-image, 1~3 = image editing)
- Only publicly accessible http / https image URLs are supported; base64 and data URLs are not supported
- Supported file formats: .jpeg, .jpg, .png, .webp
- Image URLs must be directly accessible by the server, or directly download when accessed (typically ending with image file extensions such as .png, .jpg)
- In image editing scenarios the reference images incur an additional charge, counted once per request and not multiplied by n
["https://example.com/person.png", "https://example.com/scene.png"]sizestringOptionalDefault: autoAspect ratio of the generated image, defaults to auto.
| Value | Description |
|---|---|
| auto | The model decides the ratio itself; omitting this parameter is equivalent to auto (output is usually portrait) |
| 1:1 | Square |
| 4:3 / 3:4 | Classic landscape / portrait |
| 3:2 / 2:3 | Standard landscape / portrait |
| 16:9 / 9:16 | Widescreen / mobile portrait |
| 2:1 / 1:2 | Ultra-wide / ultra-tall |
| 19.5:9 / 9:19.5 | Full-screen phone landscape / portrait |
| 20:9 / 9:20 | Ultra-wide landscape / portrait |
Notes
- Values outside the 13 supported ratios are not supported; custom WIDTHxHEIGHT pixel sizes are not accepted
16:9resolutionstringOptionalDefault: 1KPixel tier of the output image, defaults to 1K; supports the 1K and 2K tiers.
| Value | Description |
|---|---|
| 1K | Standard resolution (default) |
| 2K | Higher resolution |
Notes
- This model does not support 4K
- Values are case-insensitive
1KqualitystringOptionalDefault: mediumGeneration quality tier, controls how deeply the model thinks, defaults to medium.
| Value | Description |
|---|---|
| low | Faster output, lower cost |
| medium | Better image quality and detail |
Notes
- This model only supports the low / medium tiers; other values such as high are not supported
- quality (quality tier) and resolution (pixel tier) are independent and can be combined freely
- Values are case-insensitive
mediumnintegerOptionalDefault: 1Number of images to generate, range 1~10, defaults to 1.
| Value | Description |
|---|---|
| 1-10 | Any integer between 1 and 10 |
Notes
- Each image is billed independently, cost grows linearly with n
- The additional charge for reference images is counted once per request and is not multiplied by n
- When the task completes, results returns n independent image links
1callback_urlstringOptionalHTTPS callback address after task completion.
Notes
- Triggered when task is completed, failed, or cancelled; sent after billing confirmation
- HTTPS only; callbacks to internal IP addresses are prohibited; max length 2048 chars
- Timeout: 10s, max 3 retries on failure (after 1s / 2s / 4s)
- Callback body format is consistent with the task query API response; a 2xx response is considered successful, other status codes trigger a retry
https://your-domain.com/webhooks/image-task-completed