Tích hợp API Qwen Image 3.0
Dùng Qwen Image 3.0 qua Rivya Public API v1 với ID mô hình qwen-image-3, đầu vào được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ phản hồi.
qwen-image-3
text, file
Bắt buộc cho chế độ tham chiếu
per_output_plus_input_image · output=4.8 · input_image=0.5 · ⌈total⌉
Hình ảnh
FIXED
800 ký tự
Quy ước yêu cầu
Gửi ID mô hình ở cấp trên cùng. Điều khiển riêng của mô hình nằm trong params.
| Key | Loại | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|---|
| model | string | Có | qwen-image-3 | Dùng qwen-image-3 làm ID mô hình API. |
| prompt | string | Có | - | Tối đa 800 ký tự cho mô hình này. |
| params | object | Có | - | Đối tượng tham số riêng của mô hình. Dùng các dòng bên dưới để xem key được phép. |
| client_request_id | string | Không | - | ID phía client không bắt buộc để theo dõi yêu cầu trong hệ thống của bạn. |
Tham số mô hình
| Key | Loại | Bắt buộc | Mặc định | Phạm vi | Tùy chọn | Mô tả |
|---|---|---|---|---|---|---|
| resolution | select | Có | 1K | - | 1K, 2K | Độ phân giải |
| image_size | select | Không | 16:9 | - | 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9 | Kích thước ảnh |
| output_format | select | Không | png | - | png, jpeg | Định dạng đầu ra |
| prompt_extend | select | Không | true | - | true, false | Cho phép mô hình viết lại một prompt tích cực đơn giản trước khi tạo, hoặc tắt để kiểm soát câu chữ chặt chẽ hơn. |
| nsfw_checker | select | Không | false | - | false, true | Bật bộ lọc nội dung tùy chọn của mô hình. Không bộ lọc tự động nào có thể bảo đảm bao quát hoàn toàn. |
| negative_prompt | text | Không | - | - | - | Negative prompt |
| seed | number | Không | 1 | min 0 / max 2147483647 / step 1 | - | Để trống để mỗi lần nhận một kết quả ngẫu nhiên mới. Dùng lại cùng một số nguyên sẽ giúp dễ tái tạo hoặc tinh chỉnh kết quả trước đó hơn. Kết quả chỉ gần hơn khi prompt và các thiết lập quan trọng khác cũng tương tự, và không đảm bảo khớp 1:1. |
Chính sách tải lên
Trước tiên tải tệp tham chiếu lên, rồi đặt URL và duration token được trả về vào params.referenceMediaItems.
Ảnh tham chiếu: Tải lên tối đa ba ảnh JPEG, PNG, WebP, BMP, GIF hoặc TIFF, mỗi ảnh không quá 10 MB.
3
image
Tham chiếu video và audio nên mang durationToken từ /api/v1/files khi cần xác minh thời lượng.
| kind | Kích thước tối đa | Loại MIME |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff |
Yêu cầu tối thiểu
{
"model": "qwen-image-3",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"resolution": "1K",
"image_size": "16:9",
"output_format": "png",
"prompt_extend": "true",
"nsfw_checker": "false",
"negative_prompt": "Các thành phần hoặc lỗi tùy chọn cần tránh, tối đa 5.000 ký tự.",
"seed": 1
}
}Yêu cầu có tệp tham chiếu
{
"model": "qwen-image-3",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"resolution": "1K",
"image_size": "16:9",
"output_format": "png",
"prompt_extend": "true",
"nsfw_checker": "false",
"negative_prompt": "Các thành phần hoặc lỗi tùy chọn cần tránh, tối đa 5.000 ký tự.",
"seed": 1,
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png",
"width": 1024,
"height": 1024,
"sizeBytes": 1048576,
"imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
}
]
}
}Phản hồi tạo
Điểm cuối tạo trả về ID tác vụ công khai. Hãy thăm dò điểm cuối trạng thái cho đến khi tác vụ succeeded hoặc failed.
{
"id": "task_qwen_image_3_example",
"status": "queued",
"model": "qwen-image-3",
"reserved_credits": 5,
"final_credits": 0,
"settlement_status": "RESERVED",
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Lỗi thường gặp
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Một số chế độ cần tải tệp tham chiếu qua Files API.