Grok Imagine 이미지 모델

Grok Imagine은 xAI의 생성형 미디어 모델 제품군입니다. 이 중 세 가지 모델은 이미지를 생성하며, 세 모델 모두 비동기 작업 API에서 실행되고 플랫폼의 다른 모든 모델과 동일한 요청 형식을 사용합니다. 모델 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에 설명된 동일한 세 가지 키, 즉 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와 함께 즉시 거부됩니다. 오타는 조용히 삭제되는 대신 명확하게 실패합니다.

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

해상도 및 품질

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입니다:

{
  "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배이며, 대량 요금이 아닙니다.

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

지연 시간

비동기 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에서도 응답하며, 연결을 열린 상태로 유지하고 이미지를 직접 반환합니다.

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입니다.

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

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

다음 단계

플레이그라운드

브라우저에서 실제 요청을 전송하고 작업이 완료되는 과정을 확인합니다.

Grok Imagine 동영상

이 제품군의 동영상 기능으로, 클립을 생성하고 편집하며 확장합니다.

​시리즈 한눈에 보기

​파라미터

​해상도 및 품질

​가로세로 비율

​참조 이미지

​가격

​지연 시간

​동기 인터페이스

​다음 단계

플레이그라운드

Grok Imagine 동영상

시리즈 한눈에 보기

파라미터

해상도 및 품질

가로세로 비율

참조 이미지

가격

지연 시간

동기 인터페이스

다음 단계