Grok으로 이미지 생성

POST

images

generations

curl https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
    "model": "grok-imagine-image-2.0",
    "prompt": "A glass observatory above a quiet alpine lake at sunrise",
    "aspect_ratio": "16:9",
    "resolution": "1k",
    "quality": "low",
    "response_format": "url"
  }'

{
  "data": [
    {
      "url": "https://cdn.example.com/generated-image.jpg",
      "mime_type": "image/jpeg"
    }
  ]
}

이 경로를 사용하여 Grok 이미지 모델로 텍스트에서 이미지를 생성합니다. 요청 본문에서는 application/json을 사용합니다. model prompt도 필요합니다.

모델 선택

Grok 이미지 모델 ID를 Models 페이지에서 선택하세요. API 예제에서는 grok-imagine-image-2.0을 사용합니다. quality 은 grok-imagine-image-2.0에서만 사용할 수 있으며 low 또는 medium을 허용합니다. 애플리케이션이 특정 품질 수준에 의존하는 경우 명시적으로 설정하세요. Image 2.0에서 resolution을 생략하면 CometAPI는 1k을 사용합니다.

출력 구성

aspect_ratio을 사용하여 출력 형태를 선택하거나 auto을 사용하여 모델이 형태를 선택하도록 합니다.
resolution을 사용하여 1k 또는 2k 출력을 요청합니다.
n을 사용하여 1개에서 10개의 이미지를 요청합니다. 기본값은 1입니다.
response_format을 사용하여 임시 URL 또는 Base64 인코딩 이미지 데이터를 반환합니다.

모델별 동작은 xAI 이미지 생성 가이드를 참조하세요..

요청이 완료되면 URL 결과를 즉시 다운로드하세요. 생성된 이미지 URL은 임시입니다. 애플리케이션에서 API 응답의 이미지 바이트가 필요하면 b64_json을 사용하세요.

인증

Authorization

string

header

필수

Use your CometAPI API key as the bearer value.

본문

application/json

model

enum<string>

필수

The Grok image model ID. See the Models page for available model IDs.

사용 가능한 옵션:

grok-imagine-image,

grok-imagine-image-quality,

grok-imagine-image-2.0

예시:

"grok-imagine-image-2.0"

prompt

string

필수

A text description of the image to generate.

Minimum string length: 1

예시:

"A glass observatory above a quiet alpine lake at sunrise"

integer

기본값:1

The number of images to generate. Use an integer from 1 through 10.

필수 범위: 1 <= x <= 10

aspect_ratio

enum<string>

The output shape. Use auto to let the model select the 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

예시:

"16:9"

resolution

enum<string>

기본값:1k

The requested output resolution. Image 2.0 uses 1k when this field is omitted.

사용 가능한 옵션:

1k,

2k

예시:

"1k"

quality

enum<string>

Image quality for grok-imagine-image-2.0. This field is not available for the older Grok image model IDs.

사용 가능한 옵션:

low,

medium

예시:

"low"

response_format

enum<string>

기본값:url

The image representation in each response item. Use url for a temporary download URL or b64_json for Base64-encoded image bytes.

사용 가능한 옵션:

url,

b64_json

응답

200 - application/json

The generated image results.

data

object[]

필수

The generated images.

Minimum array length: 1

Option 1
Option 2

Show child attributes

usage

object

Additional usage metadata returned for the request. Its contents can vary by model.

마지막 수정일 2026년 8월 21일

curl https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
    "model": "grok-imagine-image-2.0",
    "prompt": "A glass observatory above a quiet alpine lake at sunrise",
    "aspect_ratio": "16:9",
    "resolution": "1k",
    "quality": "low",
    "response_format": "url"
  }'

{
  "data": [
    {
      "url": "https://cdn.example.com/generated-image.jpg",
      "mime_type": "image/jpeg"
    }
  ]
}

콘텐츠 검토

API 키

모델 선택

출력 구성

인증

본문

응답

​모델 선택

​출력 구성

인증

본문

응답

모델 선택

출력 구성