텍스트-이미지 변환과 다중 참조 편집, 최대 5개의 소스 이미지, 자동 또는 고정 품질 등급, 1K 또는 2K 출력 해상도가 가능합니다.
xAI이미지 생성출시 2026년 8월 7일독점 엔드포인트신규텍스트-이미지 변환과 다중 참조 편집, 최대 5개의 소스 이미지, 자동 또는 고정 품질 등급, 1K 또는 2K 출력 해상도가 가능합니다.
다른 이름 Grok Imagine Image, xAI Grok Imagine Image 2.0
grok-imagine-image-2-0/v1/images/generationsPOST/v1/images/editsgrok-imagine-image-2grok-imagine-image-2.0xai/grok-imagine-image-2-0xai/grok-imagine-image-2xai/grok-imagine-image-2.0EmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.
Grok Imagine Image 2.0은(는) POST /v1/images/generations로 실행됩니다. 요청은 즉시 job_id를 반환하며, 작업이 완료될 때까지 GET /v1/jobs/{job_id}을 폴링한 뒤 결과에서 출력 URL을 읽으세요. 또는 "sync": true를 추가해 폴링을 생략할 수 있습니다. 요청이 열린 상태로 완성된 OpenAI 스타일 이미지 응답을 바로 반환하므로 OpenAI SDK가 그대로 동작합니다. EmpirioLabs 대시보드에서 API 키를 발급받으세요.
curl https://api.empiriolabs.ai/v1/images/generations \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-image-2-0",
"prompt": "Describe what you want Grok Imagine Image 2.0 to generate."
}'curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"import requests
response = requests.post(
"https://api.empiriolabs.ai/v1/images/generations",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
json={
"model": "grok-imagine-image-2-0",
"prompt": "Describe what you want Grok Imagine Image 2.0 to generate.",
},
)
job = response.json()
# Generation runs as an async job. Poll until it completes.
import time
while True:
status = requests.get(
f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
).json()
if status.get("status") in ("completed", "failed"):
print(status)
break
time.sleep(5)EmpirioLabs에서 Grok Imagine Image 2.0 API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.
| 파라미터 | 유형 | 기본값 | 범위 / 값 | 설명 |
|---|---|---|---|---|
| prompt | string | - | - | 만들 이미지를 묘사하세요. 원본 이미지가 첨부되면 이것이 편집 지침이 됩니다. 여러 이미지를 <IMAGE_0>, <IMAGE_1>,, 등으로 참조합니다. 최대 8,000자까지 가능합니다. |
| image | array | - | - | 편집할 소스 이미지는 1개에서 5개로, URL, 데이터 URI, 업로드된 이미지 객체 등입니다. 프롬프트만으로 생성할 때는 빈 상태로 두세요. |
| images | array | - | - | 여러 이미지 참조를 위한 복수 별칭. |
| quality | enum | auto | auto, low, medium | 렌더링 품질. 자동 기능은 모델이 각 요청에 대해 티어를 선택할 수 있게 하며, 청구는 해당 티어에 따라 적용됩니다. 로우 리턴은 몇 초 만에 전송되고 이미지당 비용이 더 저렴합니다. 미디엄은 더 오래 걸리고 더 세밀한 디테일을 처리합니다. |
| resolution | enum | 1k | 1k, 2k | 출력 해상도 계층. 2k는 1k보다 더 많은 픽셀을 렌더링하고 이미지당 비용이 더 많이 듭니다. |
| aspect_ratio | enum | auto | auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 21:9, 5:... | 출력 화면 비율. Auto는 모델이 프롬프트에 가장 적합한 것을 선택할 수 있게 합니다. 편집 시 auto는 첫 번째 소스 이미지를 따라갑니다. 21:9 및 5:2 와이드스크린 및 배너 포맷을 포함합니다. |
| num_images | number | 1 | 1 ~ 10 | 출력 이미지 수. 각 출력 이미지는 별도로 청구됩니다. |
| response_format | enum | url | url, b64_json | 기본적으로 서명된 이미지 URL을 반환하거나, 요청 시 base64 이미지 데이터를 포함b64_json. |
텍스트 프롬프트에서 이미지를 생성하거나 자연어 명령어로 최대 다섯 개의 소스 이미지를 편집합니다. 모드 - 텍스트-이미지: 이미지가 없는 프롬프트를 전송합니다. - 이미지 편집: 한 장의 이미지를 첨부하고 원하는 변경 사항을 설명합니다. - 다중 이미지 편집: 2에서 5개의 이미지를 첨부하여 주제를 결합하거나 스타일을 전송하거나 장면을 구성합니다. 프롬프트에서 이들을,, 등으로 참조합니다<IMAGE_0><IMAGE_1>. 예시 다중 이미지 프롬프트 ' Place the product from <IMAGE_0> onto the marble surface in <IMAGE_1>. '' 기본값 - 1K 해상도 자동 품질 - 자동 화면비, 모델이 프롬프트에 가장 적합한 것을 선택합니다 - 요청당 출력 이미지 품질과 해상도 품질은 렌더링에 들어가는 작업을 결정합니다. Auto는 모델이 각 요청에 대해 티어를 선택할 수 있으며, 현재 텍스트 프롬프트에는 낮은 단계, 편집에는 중간 단계로 제공됩니다. 낮은 단계는 몇 초 후에 돌아옵니다. 중간 해상도는 더 오래 걸리고 더 세밀한 디테일을 해결합니다. 해상도는 1K 또는 2K 출력 계층을 선택합니다. 품질과 해상도는 네 가지 가격대로 결합되므로, 낮은 1K 이미지가 가장 저렴한 옵션이고, 중간 규모의 2K 이미지가 가장 상세한 선택입니다. 컨트롤 프롬프트, 원본 이미지(URL 또는 업로드), 품질, 해상도, 화면 비율을 16가지 비율(자동 및 21:9 및 5:2 와이드스크린 포맷 포함), 이미지 수, 응답 형식을 지원합니다. 제한 - 편집당 최대 5개의 소스 이미지 - 요청당 최대 10개의 출력 이미지 - 최대 8,000자 수 청구 - 출력된 이미지별로 품질과 해상도에 따라 요금이 부과되며, 첨부한 소스 이미지당 추가 요금이 부과됩니다. 텍스트-이미지 변환은 소스-이미지 수수료가 없습니다. - 자동 품질에서는 해당 요청에 대해 제공된 모델의 등급에 따라 요금이 부과됩니다. 품질을 낮음 또는 중간 수준으로 설정하려면 가격을 미리 정하세요. - 검증에 실패하거나 이미지가 생성되기 전에 거부된 요청은 청구되지 않습니다. - 생성되었지만 콘텐츠 정책에 의해 차단된 이미지는 여전히 청구됩니다. 이는 xAI 사용 정책을 따르며, 콘텐츠 안전 검사가 출력을 차단하더라도 생성 비용을 청구합니다. 이를 방지하기 위해 프롬프트와 소스 이미지를 사용 정책 내에 유지하세요. 콘텐츠 안전 생성된 이미지는 자동 콘텐츠 안전 검사를 통과합니다. 명시적으로 표시된 이미지는 반환되지 않습니다. 검사 전에 이미지가 생성되기 때문에 플래그가 붙은 생성은 여전히 청구됩니다.
EmpirioLabs에서 Grok Imagine Image 2.0은(는) 종량제로 청구됩니다: 저품질 1K $0.048 이미지별로; 저화질, 2K $0.072 이미지별로; 중간 품질, 1K $0.072 이미지별로; 중간 품질, 2K $0.096 이미지별로; 이미지 입력 $0.05 이미지별로. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.
Grok Imagine Image 2.0은(는) api.empiriolabs.ai의 POST /v1/images/generations를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.
네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 Grok Imagine Image 2.0을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.
EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.
