Grok Imagine 이미지 API: 텍스트→이미지, 이미지→이미지 및 Quality

핵심 요점

• HiAPI의 Grok Imagine 이미지 API는 총 네 개의 엔드포인트를 제공합니다: 표준판과 Quality, 각 버전마다 텍스트→이미지와 이미지→이미지가 있습니다. 네 가지의 요청 구조는 완전히 동일하며 모델 id만 다릅니다.
• 표준판은 1K 또는 2K 해상도 모두 이미지 한 장당 $0.03입니다. Quality는 1K에서 $0.07, 2K에서 $0.10입니다. 이미지→이미지는 참조 이미지마다(참조 1–3장) 소액의 추가 요금이 부과됩니다.
• 동일한 프롬프트를 사용했을 때, 표준판은 손잡이도 없고 나선형 가이드 리브도 없는 평범한 원뿔을 그렸습니다. Quality는 알아볼 수 있는 핸드드립 드리퍼를 그렸습니다. 표준판은 초안 작성과 대량 작업에, Quality는 최종 결과물 제작에 사용하세요. 텍스트→이미지 모델 페이지 열기에서 직접 시험해 보세요; 신규 계정은 200 무료 크레딧을 받습니다.

어떤 엔드포인트를 써야 할까

모델 id	입력	이미지당 가격	적합한 용도
grok-imagine/text-to-image	프롬프트	$0.03 (1K 및 2K)	초안, 대량 생성, 초광폭 배너
grok-imagine-quality/text-to-image	프롬프트	$0.07 (1K) / $0.10 (2K)	최종 제품 이미지, 디테일과 질감
grok-imagine/image-to-image	프롬프트 + 이미지 1–3장	$0.03 + 참조 이미지당 $0.003	제품을 장면에 합성, 대량 보정
grok-imagine-quality/image-to-image	프롬프트 + 이미지 1–3장	$0.08 (1K) / $0.10 (2K) + 참조 이미지당 $0.015	피사체를 완벽히 유지한 채 재조명 및 스타일 변경

HiAPI 실시간 가격, 2026년 10월 19일 조회. 실패한 작업은 과금되지 않습니다.

단일 참조 이미지 편집은 표준판에서 $0.033, Quality 1K에서 $0.095입니다. 비디오와 Grok Imagine Image 2.0을 포함한 전체 라인업은 Grok Imagine API 가격을 참고하세요.

동일 프롬프트, 표준판 vs Quality

1:1, 2K, PNG, 각각 한 번씩 실행:

matte ceramic pour-over coffee dripper on a pure white seamless background, studio softbox lighting, centered, no shadow gradient beyond a soft contact shadow, no text, no watermark, no props, e-commerce product photography, sharp focus

표준판:

grok-imagine/text-to-image, 1:1, 2K, 2048×2048, $0.03, 약 80초.

Quality:

Quality에서 이 프롬프트 생성하기 →

grok-imagine-quality/text-to-image, 1:1, 2K, 2048×2048, $0.10, 약 78초.

차이점:

• 물체 자체: 표준판은 깔끔하지만 범용적인 원뿔을 렌더링해 드리퍼보다는 그릇에 가깝습니다. Quality는 핸드드립 드리퍼로 만들어 주는 각 요소를 그렸습니다: 내부 나선형 가이드 리브, 손잡이, 그리고 배수 구멍이 있는 받침.
• 둘 다 배경 요구 사항은 준수: 순백, 중앙 정렬, 부드러운 접촉 그림자 하나만, 소품이나 텍스트 없음.
• 크기와 속도는 동일: 둘 다 약 80초 내에 2048×2048 이미지를 반환했습니다. 등급은 디테일을 바꾸는 것이지 출력 크기를 바꾸는 것이 아닙니다.

알려진 제품의 경우 Quality에 $0.07을 더 쓸 가치가 있습니다. 무드보드나 레이아웃 디자인처럼 물체 자체가 범용적인 장면에서는 표준판으로 충분합니다.

이미지→이미지: 제품을 장면에 넣기

image_urls에 공개 이미지 URL 1–3개를 전달하고 필요한 변경 사항을 설명하세요. aspect_ratio가 auto(이미지→이미지의 기본값)로 설정되면 출력은 목록의 첫 번째 이미지 모양을 따릅니다. 동일한 프롬프트, 동일한 두 이미지에서 순서만 바꾸면 두 가지 다른 크롭을 얻습니다:

grok-imagine/image-to-image, 제품 이미지가 앞, 1248×832 (3:2) 반환.

동일한 요청, 장면 이미지가 앞, 1024×1024 (1:1) 반환.

크롭을 제어하려면 원하는 모양의 이미지를 첫 번째로 두거나 aspect_ratio를 명시적으로 설정하세요.

Quality에서의 강점은 한 가지를 바꾸면서 나머지 모든 것을 그대로 유지하는 것입니다. 이번 재조명은 얼굴, 재킷, 컵, 구도를 그대로 유지했습니다:

Relight this photo as late golden hour: warm low sun coming from the left,
long soft shadows across the table, amber rim light on her hair and jacket.
Keep her face, expression, pose, the corduroy jacket, the marble table, the
coffee cup and the entire composition exactly the same. Photorealistic, same
camera angle, same framing.

grok-imagine-quality/image-to-image, 1K, auto (입력 3:2, 출력 1248×832), 참조 이미지 1장, $0.095, 39초.

효과적인 패턴: 무엇을 바꿀지 한 문장으로 설명한 다음, 반드시 유지해야 할 모든 것을 나열하세요. 더 많은 레시피는 Grok Imagine Quality 이미지→이미지 프롬프트를 참고하세요.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine/text-to-image",
    "input": {
      "prompt": "A lighthouse on a rocky cliff at golden hour, waves crashing below, photorealistic",
      "aspect_ratio": "2:1",
      "resolution": "2k",
      "output_format": "png"
    }
  }'

taskId를 받게 됩니다. GET https://api.hiapi.ai/v1/tasks/{taskId}를 data.status가 success가 될 때까지 폴링한 후 data.output[0].url을 다운로드하세요. 이 링크는 만료되므로 즉시 파일을 저장하세요.

Python: 네 개 엔드포인트 전부

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, prompt, image_urls=None, timeout_s=300, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    if image_urls:
        body["input"]["image_urls"] = image_urls
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Draft on standard, then re-run the keeper on Quality
draft = generate("grok-imagine/text-to-image", "matte ceramic pour-over dripper, white background",
                 aspect_ratio="1:1", resolution="1k")
final = generate("grok-imagine-quality/text-to-image", "matte ceramic pour-over dripper, white background",
                 aspect_ratio="1:1", resolution="2k")

# Composite a product into a scene; the first image sets the shape
edit = generate("grok-imagine/image-to-image",
                "Place the product from the first image on the desk in the second image, matching its light",
                image_urls=["https://your-cdn.example.com/product.jpg",
                            "https://your-cdn.example.com/scene.jpg"])

매개변수

필드	필수 여부	값	설명
prompt	예	텍스트	원하는 것과 피하고 싶은 모든 것을 여기에 작성
image_urls	이미지→이미지만	URL 1–3개	jpeg, png 또는 webp; SVG 미지원; 참조 이미지마다 가격 상승
aspect_ratio	아니오	2:1, 20:9, 19.5:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:19.5, 9:20, 1:2; 이미지→이미지는 auto도 허용	auto는 첫 번째 이미지를 따름
resolution	아니오	1k (기본), 2k	소문자; Quality에서만 가격에 영향
output_format	아니오	jpeg (기본), png, webp

초광폭인 2:1과 20:9는 배너에 적합합니다. 21:9는 없으므로 20:9를 사용하세요.

만나게 될 오류

다음의 모든 오류는 제출 시 HTTP 400을 반환하므로 작업이 생성되지 않고 과금도 발생하지 않습니다:

• resolution: value must be one of '1k', '2k': 2K를 보냈습니다. 소문자를 사용하세요.
• aspect_ratio: value must be one of ...: 보통 21:9입니다. 20:9를 사용하세요.
• additional properties 'n' not allowed (또는 seed, negative_prompt, size): 해당 필드는 존재하지 않습니다. 한 작업은 이미지 한 장을 생성합니다; 여러 장이 필요하면 여러 작업을 보내세요.
• image_urls: missing required field: 이미지→이미지는 최소 한 장의 이미지가 필요합니다.

유효하지 않은 키는 401을 반환합니다. 작업 생성 후의 실패는 폴링 시 status: "fail"로 표시되므로 HTTP 상태 코드뿐 아니라 data.status를 확인하세요.

자주 묻는 질문

표준판과 Quality 중 어느 것을 써야 하나요?

표준판으로 $0.03에 초안을 만드세요. 프롬프트와 레이아웃이 괜찮아지면 Quality로 최종 결과물을 다시 실행하세요. 표준판은 2K와 1K 가격이 같으므로 거기서는 항상 2k를 요청하세요.

Grok Imagine Image 2.0과 같은 것인가요?

아닙니다. grok-imagine-image-2.0은 별개의 더 최신 모델이며 이미지당 $0.052입니다. Grok Imagine Image 2.0 텍스트→이미지 가이드를 참고하세요.

한 번의 요청으로 여러 이미지를 얻을 수 있나요?

아니요. n 필드는 없습니다. 이미지마다 작업을 하나씩 보내세요; 병렬로 실행됩니다.

출력은 얼마나 오래 유효한가요?

output[0].url 링크는 만료됩니다. 작업 성공 후 즉시 다운로드하여 직접 저장하세요.

더 많은 실제 출력: 표준판 상품 카탈로그 이미지 및 제품 사진 장면 합성. 비디오에 대해서는 Grok Imagine 비디오 API 가이드를 참고하세요.