이미지 생성

OpenAI Images Generations 경로를 재사용하며 aspect_ratio, resolution 등의 Grok 전용 매개변수를 지원합니다.

POST/v1/images/generations

텍스트 프롬프트에 따라 이미지를 하나 이상 생성합니다. OpenAI 형식의 POST /v1/images/generations 엔드포인트를 재사용하며 Grok 이미지 모델의 가로세로 비율 및 해상도 매개변수를 추가합니다.

모델 ID 예시는 grok-imagine-image-pro와 grok-imagine-image입니다. 호출 전에 현재 API 키의 모델 목록에서 실제 사용 가능한 모델 ID를 확인하세요.

단일 요청에서 최대 10장의 이미지를 생성합니다. URL 응답은 임시 링크이므로 즉시 다운로드하거나 처리해야 합니다. 생성 콘텐츠가 콘텐츠 정책에 따라 필터링될 수 있으며 출력 이미지는 보통 JPG 형식입니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

application/json

Grok 이미지 생성 요청 매개변수입니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

model*string

이미지 생성에 사용할 모델 ID입니다. 모델 예시는 다음과 같습니다.

grok-imagine-image-pro: 고품질의 정교한 장면에 적합한 고급 이미지 모델입니다.
grok-imagine-image: 범용 이미지 생성 모델입니다.

실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 따릅니다.

길이1 <= length

prompt*string

생성할 이미지의 텍스트 설명입니다.

길이1 <= length

n?integer

생성할 이미지 수이며 범위는 1~10입니다.

범위1 <= value <= 10

기본값1

response_format?string

생성된 이미지의 반환 형식입니다. url은 임시 이미지 주소를 반환하므로 가능한 한 빨리 다운로드하거나 처리해야 합니다. b64_json은 Base64로 인코딩된 이미지 데이터를 반환합니다.

기본값"url"

허용 값

"url"
"b64_json"

aspect_ratio?string

생성할 이미지의 가로세로 비율입니다. 전달하지 않으면 모델이 자동으로 선택합니다. 일반적인 값의 예시는 다음과 같습니다.

1:1
16:9, 9:16
4:3, 3:4
3:2, 2:3
2:1, 1:2
19.5:9, 9:19.5
20:9, 9:20
auto

이 값은 일반적인 예시이며 닫힌 열거값 제한으로 사용하지 않습니다.

resolution?string

생성할 이미지의 출력 해상도이며 1k와 2k를 지원합니다.

허용 값

"1k"
"2k"

user?string

최종 사용자를 나타내는 고유 식별자이며 모니터링 및 위험 제어에 사용할 수 있습니다.

길이1 <= length

응답 본문

`application/json`

curl -X POST "https://example.com/v1/images/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "A cat in a tree",
    "n": 1,
    "response_format": "url"
  }'

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/generated-image-1.jpg"
    },
    {
      "url": "https://example.com/generated-image-2.jpg"
    }
  ]
}

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`