grok-imagine-image-2.0 지원 범위
공개 가격은 2026년 9월 24일 기준이며 2026년 10월 14일에 확인했습니다. 모델 및 가격에서 볼 수 있습니다. 이 모델은 xAI가 만들었고 이미지당 고정 가격 하나로 과금합니다. xAI는 해상도와 품질에 따라 가격을 매겨, 1K medium과 2K low는 $0.06, 2K medium은 $0.08이고 편집할 때는 입력 이미지당 $0.01이 추가됩니다(xAI 모델 페이지, 2026년 10월 13일 확인). LaoZhang API에서는 이 모든 경우가 $0.055이고, 편집에 입력 이미지 요금이 붙지 않습니다.

아래 생성 예제의 출력: 2K, 16:9, medium. 프롬프트: A cinematic lighthouse at sunrise, detailed ocean reflections, no text
파라미터와 제한
Grok Imagine 모델 선택
이전 모델인
grok-imagine-image-quality는 이미지당 $0.045입니다. 2.0과 마찬가지로 정상적으로 반환된 이미지에 대해서만 과금합니다.
grok-imagine-image: 2026년 10월 30일에 중단되어 지금은 호출하면 503을 반환합니다.model을grok-imagine-image-2.0으로 바꾸세요.aspect_ratio와 다중 참조 편집은 같은 방식으로 동작합니다. 중단 공지를 참고하세요.grok-imagine-image-quality: xAI는 2026년 11월 2일부터 이 모델을 종료하고 요청을low품질의grok-imagine-image-2.0으로 처리한다고 발표했습니다(xAI 마이그레이션 가이드). 2026년 11월 3일 기준 LaoZhang API에서는 아직 호출할 수 있으며 이미지당 $0.045입니다. 새로 연동한다면 2.0을 쓰고quality를 직접 지정하세요.
API 호출 전 준비
1
API 키 발급과 보관
토큰 관리에서
default 그룹의 키를 만들고 과금 방식(计费模式)을 사용량 우선(按量优先, 권장) 또는 건당 과금(按次计费)으로 설정합니다. 사용량 우선 키는 건당 과금 모델과 사용량 과금 모델을 모두 호출할 수 있고, 건당 과금 키는 건당 과금 모델만 호출할 수 있습니다.키는 서버 측 환경 변수에 보관하고, 브라우저 코드, 공개 저장소, 로그에는 남기지 마세요.2
모델 접근 권한과 가격 확인
모델 및 가격에서 키가
grok-imagine-image-2.0을 쓸 수 있는지 확인하고 현재 가격을 확인하세요.3
환경 설정
키를 환경 변수로 설정하고, Python 예제에서 쓰는 OpenAI Python SDK를 설치합니다.
4
이미지 한 장으로 시작
먼저
n=1로 시작하세요. 결과를 저장해 내용과 크기를 확인하고 호출 기록을 살펴본 뒤에 해상도, 출력 수, 동시 요청을 늘리세요.이미지 생성
아래 요청은medium 품질의 2K, 16:9 이미지 한 장을 만들고 응답을 grok-generation.json에 저장합니다.
data에 항목이 하나 들어 있습니다.
결과 저장
URL은 임시 링크이므로 바로 이미지를 내려받으세요. 아래 스크립트를save_images.py로 저장하세요. 응답에 url이 있든 b64_json이 있든 모든 이미지를 파일로 저장하며, 파일 확장자는 이미지 데이터를 보고 정합니다.
save_images.py
저장됨: grok-lighthouse-1.jpg 같은 줄을 출력합니다. 파일을 열어 피사체, 텍스트, 구도를 확인하세요. URL 대신 이미지 바이트를 응답으로 받으려면 response_format을 b64_json으로 설정하세요. 같은 스크립트가 둘 다 처리합니다.
Python SDK로 생성
OpenAI Python SDK는 Grok 이미지 옵션을 모두 이름 있는 파라미터로 제공하지 않으므로,aspect_ratio, resolution, quality는 extra_body로 전달합니다. 아래 예제는 Base64 출력을 요청하고 디코딩한 이미지를 저장합니다.
종횡비, 해상도, 품질
grok-imagine-image-2.0은 다음 15가지 고정 종횡비를 받습니다.
aspect_ratio를 생략하면 모델이 정하고, 레이아웃을 예측 가능하게 만들어야 할 때는 값을 직접 지정하세요.
resolution="1k"는 더 빠르며 초안, 썸네일, 일괄 작업의 후보 이미지에 알맞습니다.resolution="2k"는 파일이 더 크고 지연 시간이 길며, 최종 결과물과 크롭용입니다.quality="low"는 속도를,quality="medium"은 디테일을 우선합니다.quality="high"와resolution="4k"는 보내지 마세요.
auto에 맡기지 말고 quality를 low 또는 medium으로 직접 지정하세요.
참조 이미지 한 장으로 편집
편집에는 파일 업로드가 필요합니다. 현재 디렉터리에product-photo.png를 두고 다음을 실행하세요.
참조 이미지 두세 장으로 편집
참조 이미지마다image[] 필드를 반복하세요. 아래 요청은 피사체, 장면, 스타일을 각각 별도 파일 세 개로 보냅니다.
aspect_ratio=3:2이면 1248×832 같은 가로형 결과가 나옵니다. 네 번째 참조 이미지를 보내면 요청 전체가 실패하므로, 요청을 보내기 전에 파일 수를 세어 보세요.
Python SDK로 편집
한 장짜리 편집은 OpenAI SDK로 할 수 있습니다. 아래 예제는 URL을 받아 바로 이미지를 내려받습니다.파라미터 목록
가격과 과금
요청이 실제로 반환한 이미지 수를 기준으로 과금합니다.
LaoZhang API는
1k와 2k, low와 medium에 같은 가격을 적용합니다. xAI는 해상도와 품질에 따라 가격을 매기며, 비교는 이 페이지 위쪽의 가격 설명에 있습니다.
대량 작업 전에 콘솔을 확인하고, 최종 청구 기준은 호출 기록으로 보세요.
오류 처리
유효한 요청이 429, 네트워크 오류, 명백히 일시적인 5xx 오류를 만나면 지터를 둔 지수 백오프로 재시도하세요. 클라이언트 타임아웃이 난 뒤에는 같은 이미지를 두 번 생성하고 결제하지 않도록, 다시 보내기 전에 호출 기록을 확인하세요.
운영 환경에 적용하기 전에
- 운영용 키로
1k,low이미지 한 장을 생성합니다. - 결과를 저장해 실제 형식과 크기를 확인합니다.
- 실제로 쓸 해상도, 품질, 종횡비,
n값 조합을 그대로 시험합니다. - 편집은 서로 다르고 민감하지 않은 참조 이미지를 쓰고, 각 이미지가 결과에 영향을 주는지 확인합니다.
- 클라이언트에서 참조 이미지 3장 제한을 강제합니다.
- 타임아웃은
1klow요청에 60초 이상,medium또는2k에는 120~180초로 설정합니다. - 동시 요청을 늘리기 전에 성공률, 지연 시간, 출력 수, 호출 기록을 대조합니다.
자주 묻는 질문
xAI 계정 없이 Grok Imagine을 호출할 수 있나요?
네. xAI 계정이 아니라 LaoZhang API 키만 있으면 됩니다. 생성과 편집 모두 OpenAI 호환 Images 엔드포인트를 쓰고, 정상적으로 반환된 이미지에 대해서만 과금합니다.정확한 모델 ID는 무엇인가요?
끝의.0까지 포함해 grok-imagine-image-2.0을 쓰세요. 이전 모델인 grok-imagine-image는 2026년 10월 30일에 중단되었고, grok-imagine-image-quality는 별도의 이전 모델로, xAI가 11월 2일부터 종료한다고 발표했으니 새 연동에는 2.0을 쓰세요.
이미지당 과금인가요? 해상도와 품질이 가격에 영향을 주나요?
정상적으로 반환된 이미지당 과금합니다. 현재1k, 2k, low, medium은 모두 이미지당 가격이 같습니다. 예시는 위의 가격과 과금 절을 참고하세요. 지연 시간은 단계마다 다르므로 타임아웃을 그에 맞게 잡으세요. 2026년 10월 14일 기준으로 이 페이지의 이미지 생성 예제 프롬프트는 1K low에서 16초, 2K medium에서 71초가 걸렸고, 호출은 모두 $0.055로 기록되었습니다.

1K, low, 16:9: 16초, $0.055

2K, medium, 16:9: 71초, $0.055
xAI의 JSON 형식으로 편집하거나 참조 이미지를 4장 또는 5장 보낼 수 있나요?
둘 다 안 됩니다. 편집은 multipart 파일 업로드만 받으며 참조 이미지는 최대 3장입니다. 이 페이지 위쪽 표에도 나와 있습니다. xAI의 JSON 이미지 객체를 보내면 HTTP 400이 반환됩니다. xAI 문서는 OpenAI SDK의images.edit()이 Grok 편집에서 동작하지 않는다고 설명하지만, 이는 JSON만 받는 xAI 자체 API에 해당하는 이야기입니다.
LaoZhang API에서는 위의 Python SDK로 편집 절에 나온 대로 한 장짜리 편집에 images.edit()을 쓸 수 있습니다. 참조 이미지가 여러 장이면 cURL의 image[] 방식으로 시작하세요.
편집하면 어떤 종횡비가 반환되나요?
xAI에 따르면aspect_ratio 없이 편집하면 첫 번째 참조 이미지의 종횡비를 따릅니다. 프레임을 고정하려면 편집 요청에 aspect_ratio를 추가하세요. 참조 이미지 세 장 예제는 aspect_ratio=3:2를 쓰고 1248×832 이미지를 반환합니다.
이전 결과를 이어서 계속 편집할 수 있나요?
네. 이전 결과를 내려받아image로 업로드하고, 프롬프트에는 이번 라운드의 변경 사항만 쓰세요. 예를 들어 “나머지는 모두 그대로 두고 금색 테두리를 추가해 주세요.”처럼 씁니다. 라운드마다 새 편집 요청이며, 반환된 이미지에 대해 과금됩니다.
생성한 이미지는 어떻게 보관해야 하나요?
URL 결과는 바로 내려받아 직접 쓰는 스토리지에 저장하세요. xAI도 반환된 URL을 임시 링크로 설명합니다. 이미지가 API 응답 안에 들어와야 한다면b64_json을 쓰세요.
출처와 관련 문서
- Grok Imagine Image 2.0 출시 공지: 제공 현황과 참조 3장 편집 범위
- xAI Grok Imagine Image 2.0 모델: 공식 모델 ID와 해상도·품질별 업스트림 가격
- xAI image generation: 공식 종횡비, 해상도, 품질, 일괄 생성, 응답 형식
- xAI image editing: LaoZhang API의 multipart 인터페이스와 다른 업스트림 JSON 편집 형식
- xAI multi-image editing: 다중 이미지 편집 프롬프트 작성법. LaoZhang API는 편집당 참조 이미지를 최대 3장 받습니다
- Images API 레퍼런스: 공통 요청·응답 구조
- 이미지 API 비교: Grok Imagine과 다른 이미지 모델 비교
- 콘솔의 모델 및 가격: 내 계정의 모델, 그룹, 가격, 호출 기록