Skip to main content
POST
이 엔드포인트는 별칭 grok-imagine-1.5-ext도 지원합니다. grok-imagine-1.5-apimart와 동일하며 서로 바꿔 사용할 수 있습니다.

Authorizations

string
필수
모든 API는 Bearer Token 인증이 필요합니다API Key 받기:API Key 관리 페이지에서 API Key를 받으세요요청 헤더에 추가:

Body

string
기본값:"grok-imagine-1.5-apimart"
필수
이미지 생성 모델 이름지원 모델:
  • grok-imagine-1.5-apimart - Grok 이미지 생성 및 편집(별칭 grok-imagine-1.5-ext)
예시:"grok-imagine-1.5-ext"
boolean
기본값:"false"
이미지 작업을 제출하기 전에 콘텐츠 검토를 실행할지 여부를 지정합니다.
  • true: omni-moderation-latest로 프롬프트와 입력 이미지를 검토
  • false 또는 생략: 검토 요청을 보내지 않으며 검토 비용이나 지연이 추가되지 않음(기본값)
string
필수
이미지 생성 또는 편집을 위한 텍스트 설명
string[]
참조 이미지 URL 목록. 생략하면 텍스트 투 이미지, 포함하면 이미지 편집.
  • 이 모델은 참조 이미지 1–5장을 지원합니다
  • 공개적으로 접근 가능한 절대 http:// 또는 https:// URL만 지원
  • 로컬 이미지는 먼저 POST /v1/uploads/images에 업로드한 후 반환된 url 사용
string
기본값:"1:1"
출력 이미지 크기지원 형식:
  • 1:1 - 정사각형(기본값)
  • 16:9 - 가로 와이드
  • 9:16 - 세로
  • 3:2 - 가로
  • 2:3 - 세로
integer
기본값:1
생성 이미지 수범위: 1-10(최소 1, 최대 10)⚠️ 주의: 숫자 그대로 전달하세요(예: 1). 따옴표를 붙이면 오류가 발생합니다

Response

integer
응답 상태 코드
array
응답 데이터 배열

사용 시나리오

시나리오 1: 텍스트 투 이미지

시나리오 2: 텍스트 투 이미지(크기 및 수량)

시나리오 3: 이미지 편집(배경)

시나리오 4: 이미지 편집(스타일)

공식 모델

grok-imagine-imagegrok-imagine-image-quality는 다른 이미지 모델과 동일한 비동기 작업 흐름을 사용합니다. 제출 후 반환된 작업 ID로 작업 상태 조회를 완료 또는 실패할 때까지 폴링하세요.
두 모델 모두 quality를 보내지 마세요. image_urls를 생략하면 텍스트-이미지, 1장이면 단일 이미지 편집, 여러 장이면 다중 이미지 참조입니다.

요청 매개변수

지원 aspect_ratio: 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.

작업 제출 응답

202
data.id 또는 data.poll_url로 상태가 completed 또는 failed가 될 때까지 조회합니다.