Skip to main content
POST
이 엔드포인트는 비동기 방식입니다. 제출 성공 후 작업 ID가 반환됩니다. 작업 상태 조회를 폴링하여 최종 결과를 가져오세요. image_urls를 생략하면 텍스트-이미지, 포함하면 이미지 편집 또는 다중 이미지 참조입니다.

모델 기능

Body

string
기본값:"grok-imagine-image-2.0"
필수
고정값: grok-imagine-image-2.0.
string
필수
이미지 생성 또는 편집 지시문입니다. 공백 제거 후 비어 있지 않아야 하며 최대 8,000자입니다.
integer
기본값:"1"
출력 이미지 수: 110.
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 또는 JPEG, PNG, WebP Base64 Data URL을 지원합니다.

비동기 작업

제출 성공 시 HTTP 202를 반환하고 작업 ID는 data.id에 있습니다. data.poll_url 또는 GET /v1/tasks/{task_id}를 사용해 completed 또는 failed가 될 때까지 조회하세요.
장기 API 키를 브라우저 코드, 공개 환경 변수, URL, 로컬 스토리지 또는 클라이언트 로그에 노출하지 마세요. 백엔드 또는 BFF에서 호출하세요.