이미지 생성

OpenAI 호환 API로 텍스트 프롬프트에 따라 이미지를 생성합니다.

모델 기능에 따라 반환 개수, 크기, 품질, 스타일 및 응답 형식을 제어할 수 있습니다.

POST/v1/images/generations

텍스트 프롬프트에 따라 이미지를 하나 이상 생성합니다. 프롬프트로 대상, 장면, 구도, 시점, 예술적 스타일 및 전체 분위기를 설명하고 모델이 지원하는 크기, 품질 및 응답 형식으로 결과를 제어할 수 있습니다.

사용 가능한 모델과 n, quality, size, style 등의 구체적인 매개변수 제약은 선택한 모델에 따라 다릅니다. 현재 API 키에 표시되며 이미지 생성을 지원하는 모델 ID를 사용하세요.

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

application/json

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

TypeScript 타입 정의

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

model?string

사용할 이미지 생성 모델 ID입니다. 현재 API 키에 표시되며 이미지 생성을 지원하는 모델을 선택하세요. 지원 매개변수와 제한은 모델마다 다를 수 있습니다.

길이1 <= length

prompt*string

생성할 이미지의 텍스트 설명입니다. 대상, 주요 시각 요소, 구도, 시점, 예술적 스타일 및 분위기를 명확하게 설명하는 것이 좋습니다.

DALL·E 2는 최대 1,000자, DALL·E 3는 최대 4,000자를 허용합니다. 다른 모델의 제한은 실제 기능에 따라 다릅니다. 생성에 실패하면 프롬프트가 콘텐츠 정책을 준수하는지도 확인하세요.

길이1 <= length

n?integer|null

생성할 이미지 수이며 범위는 1~10입니다. DALL·E 3는 n=1만 지원합니다. 다른 모델의 여러 이미지 반환 지원 여부는 실제 기능에 따라 다릅니다.

범위1 <= value <= 10

기본값1

quality?string

이미지 품질입니다. hd는 더 정밀하고 일관된 이미지를 생성하며 DALL·E 3에만 적용됩니다. 다른 모델에서는 다른 값을 사용할 수 있습니다.

기본값"standard"

허용 값

"standard"
"hd"

response_format?string|null

이미지 응답 형식입니다. url은 생성 후 60분 동안 유효한 임시 이미지 주소를 반환하고 b64_json은 Base64로 인코딩된 이미지 데이터를 반환합니다.

기본값"url"

허용 값

"url"
"b64_json"
null

size?string|null

이미지 크기입니다. DALL·E 2는 256x256, 512x512, 1024x1024를 지원하고 DALL·E 3는 1024x1024, 1792x1024, 1024x1792를 지원합니다.

기본값"1024x1024"

허용 값

"256x256"
"512x512"
"1024x1024"
"1792x1024"
"1024x1792"
null

style?string|null

이미지 스타일입니다. vivid는 초현실적이고 극적인 효과를, natural은 자연스럽고 사실적인 표현을 지향합니다. 이 매개변수는 DALL·E 3에만 적용됩니다.

기본값"vivid"

허용 값

"vivid"
"natural"
null

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": "귀여운 아기 해달이 맑은 물에서 놀고 있으며 부드러운 자연광과 선명한 디테일이 돋보입니다",
    "n": 1,
    "size": "1024x1024"
  }'

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "revised_prompt": "귀여운 아기 해달이 맑은 물에서 놀고 있습니다. 동그란 눈과 복슬복슬한 털을 가지고 있습니다."
    }
  ]
}

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`