이미지 생성 / 편집

POST/v1/images/generations

프롬프트로 이미지를 생성하거나 같은 JSON 요청의 image에 참조 이미지를 전달해 편집합니다.

인증

bearerAuth

인증Bearer <token>

플랫폼 API 키를 사용하세요.

전달 위치: header

요청 본문

application/json

TypeScript 타입 정의

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

model*string

플랫폼 모델 ID.

prompt?string

이미지 생성 또는 편집 지시. 레이어 분해 모드에서만 생략할 수 있습니다.

길이1 <= length

image?|array<>

참조 이미지. 생략하면 텍스트로 생성합니다. 각 이미지는 30 MB 이하여야 합니다. 이미지 수 제한은 모델 차이 페이지를 확인하세요. 레이어 분해에는 한 장만 사용할 수 있습니다.

size?string

해상도 프리셋 또는 WIDTHxHEIGHT. 값과 기본값은 모델 차이 페이지를 확인하세요.

optimize_prompt_options?

output_format?string

이미지 파일 형식. 레이어 분해에서는 배경 이미지에만 적용되며 레이어는 항상 PNG입니다.

기본값"jpeg"

허용 값

"png"
"jpeg"

background?string

투명 모드는 알파 채널이 있는 단일 입력 이미지에만 적용되며 PNG를 출력합니다.

기본값"opaque"

허용 값

"opaque"
"transparent"

response_format?string

이미지 URL 또는 Base64 데이터를 반환합니다.

기본값"url"

허용 값

"url"
"b64_json"

watermark?boolean

AI 생성 워터마크 추가 여부.

기본값true

layer_decomposition?boolean

한 이미지를 배경 이미지와 독립 레이어로 분해합니다. 일부 모델만 지원합니다.

기본값false

sequential_image_generation?string

연속 이미지 모드. auto이면 모델이 연속 이미지 생성 여부를 결정합니다.

기본값"disabled"

허용 값

"disabled"
"auto"

sequential_image_generation_options?

stream?boolean

생성 결과를 한 장씩 반환합니다. 일부 모델만 지원합니다.

기본값false

tools?array<>

웹 검색 도구. 일부 모델만 지원합니다.

응답 본문

`application/json`

type*string

model?string

실제로 사용한 모델 ID.

created?integer

초 단위 Unix 타임스탬프.

범위0 <= value

image_index*integer

0부터 시작하는 이미지 번호.

범위0 <= value

url?string

임시 다운로드 URL. 24시간 이내에 저장하세요.

형식uri

b64_json?string

이미지의 Base64 데이터.

size?string

WIDTHxHEIGHT 형식의 실제 출력 크기.

curl -X POST "https://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "왼쪽에서 부드러운 창빛이 들어오는 나무 책상 위 흰색 머그컵 사진을 생성하세요."
  }'

{
  "created": 1793980674,
  "data": [
    {
      "url": "https://example.com/result.jpeg"
    }
  ]
}

편집 예제 URL을 이전 단계에서 생성한 이미지 링크로 바꿀 수 있습니다. Base64 사용 시 BASE64_BYTES를 실제 이미지 데이터로 바꾸고 이미지 형식에 맞는 Data URL 접두사를 유지하세요.

Volcengine 이미지 생성 APIAPI 필드, 응답 및 기능별 가이드를 확인하세요.

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

403application/json

스트리밍 응답 이벤트

`application/json`

`application/json`

`application/json`