Lưu ý khi gọi hình ảnh (thực hành tốt nhất)

Tạo ảnh là một yêu cầu đồng bộ, thời gian dài (thường 10–60 giây), khác với thói quen gọi của giao diện hội thoại. Trước khi triển khai ở quy mô lớn, hãy đọc kỹ trang này.

Timeout và retry

• Đặt timeout phía client ≥120 giây, thư viện HTTP mặc định 30 giây sẽ cắt kết nối trước khi quá trình tạo hoàn tất;
• Yêu cầu bị ngắt có thể đã đi vào quy trình tính phí ở phía upstream — nếu thất bại sẽ tự động hoàn lại số dư đã tạm trừ, nhưng không nên retry dồn dập ngay lập tức, khuyến nghị backoff theo cấp số nhân (5s → 15s → 45s);
• 429 cho biết đã chạm giới hạn tốc độ, cách xử lý xemGiới hạn tốc độ và 429。

Lựa chọn model và tỷ lệ khung hình

• Tỷ lệ khung hình/độ phân giải được chỉ định thông quahậu tố tên model(-portrait、-landscape、-2k、-4k 等), không dựa vào tham số size, quy tắc đầy đủ xemModel tạo ảnh và video;
• Trong các tình huống chạy batch, ưu tiên gói -fast, sau khi xác nhận prompt hãy chuyển sang gói tiêu chuẩn để tinh chỉnh;
• Model 4K có giá cao hơn và tạo chậm hơn, chỉ dùng ở giai đoạn sản phẩm cuối cùng.

Xử lý kết quả

• URL ảnh trả về có thời hạn sử dụng, hãy lưu chuyển ngay sang object storage của riêng bạn, không nên hotlink;
• Khi trả về base64, lưu ý body phản hồi khá lớn, cần nới giới hạn body của reverse proxy và gateway;
• Tính phí theo lần: thành công một lần trừ một lần, thất bại (lỗi upstream/timeout) không tính phí.

Kiểm soát chi phí

• Trước tiên dùng lô nhỏ để hiệu chỉnh template prompt, sau khi ổn định rồi mới tăng quy mô;
• Tạo riêng một API token cho nghiệp vụ hình ảnh và đặt hạn mức, để tránh bug chương trình làm vượt ngân sách;
• Mỗi khoản trừ phí có thể đối chiếu trong mục “log” của console, hoặc dùngAPI truy vấn log để đối soát。