Qwen Image 3.0 API: Hướng dẫn tích hợp và trạng thái

Chuẩn bị ranh giới hội nhập

Giữ ID mô hình và chi phí tín dụng trong cấu hình phía máy chủ. Trình duyệt phải gửi lời nhắc và các tùy chọn tới API của riêng bạn thay vì hiển thị khóa nhà cung cấp.

• Xác thực mọi yêu cầu tạo trả phí
• Xác thực độ dài lời nhắc, mô hình và tỷ lệ khung hình phía máy chủ
• Lưu trữ khóa của nhà cung cấp bên ngoài gói ứng dụng khách
• Điểm cuối tạo và bỏ phiếu giới hạn tỷ lệ

Hãy coi việc tạo là một công việc không đồng bộ

Tạo một nhiệm vụ cục bộ, khấu trừ các khoản tín dụng nguyên tử, gửi cho nhà cung cấp, sau đó thăm dò ý kiến cho đến khi thành công hay thất bại. Nhiệm vụ không thành công phải tuân theo chính sách hoàn trả tín dụng rõ ràng.

• đang chờ xử lý → đang xử lý → thành công hay thất bại
• Duy trì ID tác vụ của nhà cung cấp để khôi phục
• Sao chép tài sản đã hoàn thành vào kho lưu trữ đồ vật lâu bền
• Không bao giờ tin tưởng vào giá trị hoặc giá trị tín dụng do trình duyệt gửi

Sử dụng ID mẫu Qwen Image 3 đã được xác minh

Điểm cuối thương mại đã được xác minh sẽ hiển thị ID mô hình alibaba/qwen-image-3/text-to-image. Việc tích hợp chấp nhận lời nhắc tiếng Trung và tiếng Anh lên tới 800 ký tự, kích thước hình ảnh được hỗ trợ, mở rộng lời nhắc, kiểm tra an toàn, hạt giống và các định dạng đầu ra hình ảnh phổ biến.

Duy trì mọi hình ảnh thành công bên ngoài URL của nhà cung cấp tạm thời

URL đầu ra của nhà cung cấp có thể hết hạn. Tải xuống các tệp thành công trên máy chủ, xác thực loại và kích thước nội dung, tải chúng lên bộ lưu trữ đối tượng riêng tư và lưu URL lâu dài cùng với bản ghi tác vụ.

• Không để lộ khóa API của nhà cung cấp trong mã trình duyệt
• Sao chép đầu ra sang R2 hoặc bộ lưu trữ S3 tương thích
• Sử dụng URL đã ký cho nội dung người dùng riêng tư
• Thử lại việc lưu trữ riêng biệt với việc tạo mô hình

Vận hành tích hợp sản xuất một cách an toàn

Giữ ID mô hình, danh sách cho phép đầu vào và chi phí tín dụng trên máy chủ. Giám sát các lỗi gửi, độ trễ hàng đợi, khối kiểm duyệt, tiền hoàn lại và bản sao lưu trữ, trong khi vẫn giữ lại cấu hình 2.0 bị vô hiệu hóa để khôi phục khẩn cấp.

Ước tính chi phí Qwen Image 3 API trên mỗi tài sản có thể sử dụng

Thế hệ rẻ nhất không phải lúc nào cũng là thế hệ có chi phí thấp nhất. Ước tính chi phí từ giá của nhà cung cấp, số lần thử lại, lỗi kiểm duyệt, dung lượng lưu trữ, băng thông và tỷ lệ phần trăm đầu ra vượt qua quá trình đánh giá. Theo dõi chi phí trên mỗi hình ảnh được phê duyệt cho từng trường hợp sử dụng thay vì chỉ so sánh giá API tiêu đề.

• Ghi riêng phí nhà cung cấp và chi phí tín dụng nội bộ
• Đo lường số lần thử lại trên mỗi sản phẩm, áp phích hoặc tài sản xã hội được phê duyệt
• Bao gồm băng thông tải xuống và lưu trữ bền bỉ
• Đặt cảnh báo ngân sách trước khi tăng tính đồng thời

Sử dụng danh sách kiểm tra khởi động sản xuất

Trước khi gửi lưu lượng truy cập của khách hàng đến tích hợp Qwen Image 3 API, hãy chạy lời nhắc cố định thông qua mọi tỷ lệ và ngôn ngữ được hỗ trợ. Xác minh thời gian chờ, nội dung gửi trùng lặp, khoản hoàn trả do nhiệm vụ không thành công, phản hồi kiểm duyệt, URL tạm thời và tình trạng ngừng hoạt động của nhà cung cấp. Một bộ thử nghiệm nhỏ được ghi lại sẽ ngăn chặn những sự hồi quy tốn kém sau khi cập nhật nhà cung cấp.

• Kiểm tra tính tạm thời để các lần thử lại không tính phí gấp đôi cho người dùng
• Độ trễ nhật ký, ID yêu cầu của nhà cung cấp và mã lỗi chuẩn hóa
• Xác minh quyền sở hữu đầu ra và các điều khoản lưu giữ cho gói của bạn
• Giữ một mô hình khôi phục tài liệu và thông báo trạng thái