Tạo / chỉnh sửa ảnh

POST/v1/images/generations

Tạo hoặc sửa ảnh đồng bộ. Khi có image, sửa ảnh tham chiếu theo lời nhắc.

Xác thực

bearerAuth

Xác thựcBearer <token>

Dùng khóa API của nền tảng.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

model*string

ID mô hình trên nền tảng.

prompt*string

Mô tả ảnh cần tạo hoặc chỉnh sửa cho ảnh tham chiếu.

Độ dài1 <= length

image?|array<>

Tối đa 3 ảnh tham chiếu. Mỗi ảnh không quá 10 MB, tỷ lệ cạnh dài/ngắn không quá 10:1, chiều rộng và cao từ 1–8000 pixel. Bỏ qua khi tạo từ văn bản. null hoặc mảng rỗng gây lỗi.

n?integer

Số ảnh đầu ra.

Phạm vi1 <= value <= 6

Giá trị mặc định1

size?string

Kích thước WIDTHxHEIGHT hoặc auto. Nếu bỏ qua, mô hình tự chọn. Diện tích từ 512×512 đến 2048×2048 pixel, tỷ lệ từ 1:8 đến 8:1.

negative_prompt?string

Mô tả nội dung không muốn xuất hiện.

seed?integer

Hạt giống ngẫu nhiên.

Phạm vi0 <= value <= 2147483647

prompt_extend?boolean

Có tăng cường lời nhắc hay không.

Giá trị mặc địnhtrue

prompt_extend_mode?string

Chế độ tăng cường. agent chỉ dùng khi tạo từ văn bản, dùng để sửa ảnh sẽ trả 400.

Giá trị mặc định"direct"

Giá trị được phép

"direct"
"agent"

enable_thinking?boolean

Có bật suy nghĩ hay không. Chỉ hiệu lực khi prompt_extend là true.

Giá trị mặc địnhtrue

watermark?boolean

Có thêm dấu chìm hay không.

Giá trị mặc địnhfalse

response_format?string

Luôn trả URL ảnh. b64_json bị bỏ qua.

Nội dung phản hồi

`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": "Tạo ảnh chụp chiếc cốc trắng trên bàn gỗ, với ánh sáng dịu từ cửa sổ bên trái."
  }'

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

Thay URL của ví dụ sửa ảnh bằng ảnh vừa tạo ở bước trước. Với Base64, thay BASE64_BYTES bằng dữ liệu thực và giữ tiền tố Data URL đúng định dạng ảnh.

API tạo và sửa ảnh Qwen của Alibaba CloudCác trường và định dạng phản hồi tương thích OpenAI.

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`