Grok Imagine API 사용법: Python 호출과 이미지 모델 3개 비교

Grok Imagine API는 xAI의 이미지·영상 API입니다. 2026년 10월 18일 같은 프롬프트 4개를 모델 3개에 넣어 봤고, Grok Imagine 2.0이 4개 중 3개에서 이겼습니다. 지금 쓸 수 있는 이미지 모델은 grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 세 가지입니다.

아래에서 어떤 모델을 고를지, 그대로 돌아가는 Python 스크립트, xAI의 장당 가격, 주의할 점을 차례로 설명합니다.

먼저 결론부터

• Grok Imagine 2.0 (grok-imagine-image-2.0)을 기본으로 쓰세요. 테스트에서 포스터 타이포그래피, 제품 사진, 인물 사진 모두 가장 좋았고 xAI 가격은 장당 0.04달러부터입니다.
• 저렴한 초안을 많이 뽑는다면 원래 모델 grok-imagine-image가 맞습니다. xAI 기준 장당 0.02달러이고 포스터 글자도 정확했습니다.
• grok-imagine-image-quality는 쓰지 마세요. xAI가 2026년 11월 2일에 서비스를 종료하고, 우리 포스터에는 없던 주소를 지어내 붙였습니다.
• 이미지는 모두 7~18초 만에 나왔습니다.

Grok Imagine API란?

xAI의 이미지·영상 API로 2026년 1월 28일에 공개됐습니다(xAI). Image 2.0은 2026년 8월 7일에 나왔고, xAI는 이미지 생성과 편집 모두 세계 2위라고 말합니다(xAI).

세 모델 모두 OmniaKey에서 쓸 수 있습니다: Grok Imagine, Grok Imagine Quality, Grok Imagine 2.0. OmniaKey는 이 모델들의 API 접근을 판매하고 있어서 테스트도 OmniaKey로 돌렸습니다. 여기 적은 가격은 모두 xAI 자체 가격입니다.

어떤 Grok Imagine 모델을 써야 할까?

저렴한 초안만 필요하지 않다면 Grok Imagine 2.0입니다. 모델 3개에 같은 프롬프트 4개를 한 번씩 넣고, 크기나 비율은 지정하지 않은 채 원본 크기로 비교했습니다.

테스트 1: 포스터 글자

프롬프트:

A minimalist poster for a neighborhood coffee shop opening. Large bold headline text "GRAND OPENING", smaller text below "Saturday 9 AM", a simple line drawing of a coffee cup, cream background, dark brown ink.

세 모델 모두 두 줄을 정확히 썼습니다(위 포스터). Grok Imagine 2.0은 날짜 위아래에 얇은 선을 넣은 가장 디자인된 레이아웃이었습니다. Quality는 아무도 요청하지 않은 줄을 추가했습니다:

결론: 보기 좋은 쪽은 2.0, 글자만 맞으면 되는 경우는 원래 모델입니다. 인쇄물에는 Quality를 피하세요. 없던 글자가 생기는 건 전단지에서 가장 곤란합니다.

테스트 2: 사실적인 사진

프롬프트:

A realistic photo of an elderly fisherman mending a blue net on a wooden dock at sunrise, soft golden light, gulls in the background, shallow depth of field.

• Grok Imagine: 황금빛 조명이 아름답고 장면도 자연스럽습니다. 다만 부두 전체에 초점이 맞아 있습니다.
• Quality: 피사체와 배경은 맞지만 화면에서 어부가 작고 디테일도 부드럽습니다.
• Grok Imagine 2.0: 배경이 흐린 클로즈업으로, "얕은 심도"를 확실히 구현한 유일한 결과입니다.

결론: 2.0.

테스트 3: 제품 사진

프롬프트:

Studio product photo of a matte black wireless earbud case, lid open, both earbuds inside, on a pure white background, soft shadow, sharp focus, no text, no logo.

세 모델 모두 열린 뚜껑, 양쪽 이어버드, 흰 배경, 로고 없음까지 세부를 지켰습니다. 원래 모델은 케이스가 화면에서 작았고 Quality는 비스듬히 찍은 구도였습니다. Grok Imagine 2.0은 화면을 가득 채우고 디테일이 선명해 제품 페이지에 바로 쓸 수 있습니다.

결론: 2.0.

테스트 4: 개수 세기

프롬프트:

Top-down photo of a wooden table with exactly three red apples on the left and exactly two green pears on the right, nothing else on the table.

세 모델 모두 왼쪽에 사과 3개, 오른쪽에 배 2개를 두고 탁자에는 다른 것을 놓지 않았습니다. 원래 모델은 배가 위에서 내려다본 모습이 아니라 서 있었고, 2.0의 배는 초록보다 노랗게 나왔습니다.

결론: 개수는 무승부. 위에서 내려다본 구도는 Quality가 가장 깔끔했습니다.

Python에서는 어떻게 호출할까?

단계는 세 가지입니다. 작업을 만들고, 끝날 때까지 상태를 확인하고, 이미지를 내려받습니다. 키를 환경 변수에 넣고 그대로 실행하세요:

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

# 1. 작업을 만든다. 이 요청을 그대로 재시도할 때만 같은 Idempotency-Key를 다시 쓴다.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "grok-imagine-image-2.0",
        "type": "image",
        "operation": "generate",
        "input": {"prompt": "A flat illustration of a red bicycle leaning on a yellow wall, morning light"},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. 상태를 보면서 작업이 끝날 때까지 기다린다.
while task["status"] in ("queued", "processing"):
    time.sleep(2)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. 바로 내려받는다. 서명된 URL은 금방 만료된다.
asset = task["assets"][0]
with open("bicycle.jpg", "wb") as f:
    f.write(requests.get(asset["url"], timeout=60).content)
print("saved bicycle.jpg", asset["mime_type"], asset["byte_size"], "bytes")

2026년 10월 18일에 실행했을 때 아래 두 줄이 출력됐고, 시작한 지 16초 만에 1248 × 832 JPEG가 저장됐습니다:

task: task_LBCu6Lr8hyD4RH25JfiOixJHPHi3Cd0o queued
saved bicycle.jpg image/jpeg 267732 bytes

다른 모델을 써 보려면 model 값만 바꾸면 됩니다.

Grok Imagine API 가격은?

xAI는 장당 과금하고, 가격은 모델과 해상도, 2.0은 품질 등급에 따라 달라집니다. 아래는 xAI 가격 페이지의 xAI 자체 요금입니다(2026년 10월 18일 확인):

2.0은 따로 지정하지 않으면 새 이미지에 낮은 품질을 쓰므로 xAI 기준 1K 이미지 한 장이 0.04달러입니다. xAI 자체 API에서는 이용 가이드라인을 어긴 요청도 청구됩니다. OmniaKey로 쓰면 장당 정액이고(현재 요금은 모델 페이지 참고) 실패한 작업은 환불됩니다.

주의할 점은?

• OmniaKey에서는 편집이 안 됩니다. xAI API에서 2.0은 참조 이미지 최대 5장으로 편집할 수 있지만, OmniaKey를 거치면 Grok은 새 이미지만 만듭니다. 편집이 필요하면 지원하는 모델, 예를 들어 Nano Banana 2.1을 쓰세요.
• 비율은 모델이 정합니다. 비율을 지정하지 않으면 Grok은 포스터를 세로, 장면을 가로로 만들었고 모두 100만 화소 안팎(832 × 1248~1280 × 720)이었습니다.
• Quality는 11월 2일에 사라집니다. 이후 xAI는 grok-imagine-image-quality 요청을 2.0의 낮은 품질로 처리하므로 지금 옮기세요.
• 400이 나오면 한 번만 재시도하세요. 14건 중 1건이 400으로 실패해 환불됐고, 같은 내용으로 다시 보내니 성공했습니다.

정리

대부분의 작업에는 grok-imagine-image-2.0을 호출하세요. 테스트 4개 중 3개에서 이겼고 xAI 기준 1K 이미지가 장당 0.04달러입니다. 저렴한 초안이 많이 필요하면 원래 모델을, Quality는 11월 2일 전에 갈아타세요.

자주 묻는 질문

Grok Imagine API는 무료인가요?

아니요. xAI는 모든 Grok 이미지 모델에 장당 가격을 붙였고, 가장 싼 원래 모델이 0.02달러입니다.

API로 Grok Imagine 영상을 만들 수 있나요?

됩니다. xAI의 영상 모델은 초당 과금하며, 예를 들어 Grok Imagine Video 1.5는 480p에서 초당 0.08달러입니다. OmniaKey에서는 Grok Imagine Video 1.5를 보세요.

이미지 크기는 얼마나 되나요?

기본 100만 화소 안팎입니다. xAI 가이드는 1K가 기본이고 2K를 선택할 수 있다고 하며, 비율을 지정하지 않으면 모델이 고릅니다.

11월 2일 이후 grok-imagine-image-quality는 어떻게 되나요?

xAI는 계속 응답하지만 실제로는 Grok Imagine 2.0의 낮은 품질로 처리하고 2.0 가격을 받습니다. 원래 grok-imagine-image는 영향을 받지 않습니다.