curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-APIMart-Response-Version: 2026-07-27' \
--data '{
"model": "grok-imagine-image-2.0",
"prompt": "비 내리는 밤, 네온 불빛이 비추는 영화 같은 도시 거리",
"n": 1,
"aspect_ratio": "16:9",
"resolution": "2k",
"quality": "medium"
}'
{
"code": 202,
"data": {
"id": "task_01KZQE5CM0Y3KZ6M1N1BK619MX",
"object": "generation.task",
"type": "image",
"status": "pending",
"progress": 0,
"poll_url": "/v1/tasks/task_01KZQE5CM0Y3KZ6M1N1BK619MX"
}
}
Grok Imagine 2.0 Ext
Grok Imagine Image 2.0 공식 이미지 생성 및 편집
grok-imagine-image-2.0 비동기 이미지 생성 및 편집
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-APIMart-Response-Version: 2026-07-27' \
--data '{
"model": "grok-imagine-image-2.0",
"prompt": "비 내리는 밤, 네온 불빛이 비추는 영화 같은 도시 거리",
"n": 1,
"aspect_ratio": "16:9",
"resolution": "2k",
"quality": "medium"
}'
{
"code": 202,
"data": {
"id": "task_01KZQE5CM0Y3KZ6M1N1BK619MX",
"object": "generation.task",
"type": "image",
"status": "pending",
"progress": 0,
"poll_url": "/v1/tasks/task_01KZQE5CM0Y3KZ6M1N1BK619MX"
}
}
이 엔드포인트는 비동기 방식입니다. 제출 성공 후 작업 ID가 반환됩니다. 작업 상태 조회를 폴링하여 최종 결과를 가져오세요.
image_urls를 생략하면 텍스트-이미지, 포함하면 이미지 편집 또는 다중 이미지 참조입니다.curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-APIMart-Response-Version: 2026-07-27' \
--data '{
"model": "grok-imagine-image-2.0",
"prompt": "비 내리는 밤, 네온 불빛이 비추는 영화 같은 도시 거리",
"n": 1,
"aspect_ratio": "16:9",
"resolution": "2k",
"quality": "medium"
}'
{
"code": 202,
"data": {
"id": "task_01KZQE5CM0Y3KZ6M1N1BK619MX",
"object": "generation.task",
"type": "image",
"status": "pending",
"progress": 0,
"poll_url": "/v1/tasks/task_01KZQE5CM0Y3KZ6M1N1BK619MX"
}
}
모델 기능
| 모델 | 해상도 | quality | 입력 이미지 | 출력 수 |
|---|---|---|---|---|
grok-imagine-image-2.0 | 1k, 2k | 텍스트-이미지에서만 low, medium | 0–3장 | 1–10장 |
Body
string
기본값:"grok-imagine-image-2.0"
필수
고정값:
grok-imagine-image-2.0.boolean
기본값:"false"
이미지 작업을 제출하기 전에 콘텐츠 검토를 실행할지 여부를 지정합니다.
true:omni-moderation-latest로 프롬프트와 입력 이미지를 검토false또는 생략: 검토 요청을 보내지 않으며 검토 비용이나 지연이 추가되지 않음(기본값)
string
필수
이미지 생성 또는 편집 지시문입니다. 공백 제거 후 비어 있지 않아야 하며 최대 8,000자입니다.
integer
기본값:"1"
출력 이미지 수:
1–10.string
기본값:"auto"
1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto를 지원합니다.string
기본값:"1k"
1k 또는 2k.string
텍스트-이미지에서만
low 또는 medium(기본값). image_urls가 있으면 보내지 마세요.array
참조 이미지 1–3장. 공개적으로 접근 가능한 절대 HTTP(S) URL만 지원합니다. 로컬 이미지는 먼저
POST /v1/uploads/images에 업로드한 후 반환된 url을 사용하세요.비동기 작업
제출 성공 시 HTTP202를 반환하고 작업 ID는 data.id에 있습니다. data.poll_url 또는 GET /v1/tasks/{task_id}를 사용해 completed 또는 failed가 될 때까지 조회하세요.
장기 API 키를 브라우저 코드, 공개 환경 변수, URL, 로컬 스토리지 또는 클라이언트 로그에 노출하지 마세요. 백엔드 또는 BFF에서 호출하세요.