이미지 생성 / 편집

POST/v1/images/generations

이미지를 동기 생성 또는 편집합니다. image를 전달하면 프롬프트에 따라 참조 이미지를 편집합니다.

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

application/json

TypeScript 타입 정의

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

model*string

플랫폼 모델 ID.

prompt*string

생성할 이미지 또는 참조 이미지의 편집 내용을 설명하세요.

길이1 <= length

image?|array<>

참조 이미지는 최대 3장입니다. 각 이미지는 10 MB 이하, 긴 변과 짧은 변의 비율은 10:1 이하, 가로와 세로는 각각 1–8000픽셀이어야 합니다. 텍스트 생성 시 생략하세요. null이나 빈 배열은 오류가 발생합니다.

n?integer

출력 이미지 수.

범위1 <= value <= 6

기본값1

size?string

WIDTHxHEIGHT 또는 auto. 생략하면 모델이 선택합니다. 픽셀 면적은 512×512–2048×2048, 종횡비는 1:8–8:1입니다.

negative_prompt?string

이미지에서 제외할 내용을 설명하세요.

seed?integer

랜덤 시드.

범위0 <= value <= 2147483647

prompt_extend?boolean

프롬프트 강화 여부.

기본값true

prompt_extend_mode?string

프롬프트 강화 모드. agent는 텍스트 생성 전용이며 이미지 편집에 사용하면 400을 반환합니다.

기본값"direct"

허용 값

"direct"
"agent"

enable_thinking?boolean

사고 활성화 여부. prompt_extend가 true일 때만 적용됩니다.

기본값true

watermark?boolean

워터마크 추가 여부.

기본값false

response_format?string

항상 이미지 URL을 반환합니다. b64_json은 무시됩니다.

응답 본문

`application/json`

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": 1793980667,
  "data": [
    {
      "url": "https://example.com/result.png"
    }
  ]
}

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

Alibaba Cloud Qwen 이미지 생성 및 편집 APIOpenAI 호환 API의 필드와 반환 형식을 확인하세요.

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`