Qwen Image 3.0
qwen/qwen-image-3Qwen Image 3.0 (Qwen-Image-3.0-Pro) là mô hình tạo ảnh tiên tiến của Alibaba dành cho hình ảnh chân thực, bố cục có cấu trúc, chi tiết phong phú và typography chất lượng cao. Tạo và chỉnh sửa hình ảnh với văn bản nhỏ chính xác, kết xuất đa ngôn ngữ và bố cục phức tạp thông qua một Qwen Image 3.0 API duy nhất.
Tổng quan
Qwen Image 3.0 (Qwen-Image-3.0-Pro) là mô hình tạo ảnh tiên tiến của Alibaba dành cho hình ảnh chân thực, bố cục có cấu trúc, chi tiết phong phú và typography chất lượng cao. Tạo và chỉnh sửa hình ảnh với văn bản nhỏ chính xác, kết xuất đa ngôn ngữ và bố cục phức tạp thông qua một Qwen Image 3.0 API duy nhất.
Xác thực
Tất cả request API yêu cầu khóa API hợp lệ được truyền qua header Authorization sử dụng scheme Bearer.
Bắt đầu nhanh
Thông tin xác thực
Đặt biến môi trường RUNBASE_API_KEY.
export RUNBASE_API_KEY=your-api-keyTạo lượt chạy
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen/qwen-image-3",
"input": {
"prompt": "A cinematic product photo of a ceramic lamp"
}
}'Lượt chạy
Các lượt chạy được xử lý bất đồng bộ. Gửi request, sau đó poll để lấy kết quả.
Tạo lượt chạy
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen/qwen-image-3",
"input": { "prompt": "A cinematic product photo of a ceramic lamp" }
}'Lấy trạng thái lượt chạy
curl -s https://runbase.net/api/v1/runs/RUN_ID \
-H "Authorization: Bearer $RUNBASE_API_KEY"Lấy kết quả
Poll endpoint trạng thái cho đến khi status là "succeeded", sau đó đọc output.urls từ response.
Schema đầu vào
| Tham số | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| prompt | string | Bắt buộc | PromptTối đa 3000 ký tự |
| aspect_ratio | string | Tùy chọn | Aspect ratioTùy chọn: 1:12:33:23:44:39:1616:921:9Mặc định: 1:1 |
| resolution | string | Tùy chọn | ResolutionTùy chọn: 1k2kMặc định: 1k |
| image_urls | string[] | Tùy chọn | Reference imagesTối đa 14 ảnh |
Schema đầu ra
| Trường | Loại | Mô tả |
|---|---|---|
| urls | string[] | URL đầu ra đã tạo |
Lỗi
API sử dụng mã trạng thái HTTP tiêu chuẩn để biểu thị thành công hoặc thất bại.
| Mã trạng thái | Mô tả |
|---|---|
| 400 | Ungültige Anfrage – fehlende oder fehlerhafte Parameter |
| 401 | Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel |
| 402 | Unzureichendes Guthaben |
| 403 | Zugriff verweigert – IP nicht erlaubt, Konto gesperrt oder Ausgabenlimit des API-Schlüssels überschritten |
| 404 | Ausführung nicht gefunden |
| 429 | Rate-Limit überschritten |
| 500 | Interner Serverfehler |

