Tác vụ ảnh bất đồng bộ
Các route này nhận payload ảnh không stream giống endpoint đồng bộ. Gửi thành công trả về 202 Accepted, poll_url và Retry-After; gọi URL đó bằng cùng Key đến khi completed hoặc failed. Khi server không có storage tác vụ ảnh, tính năng trả 404 thay vì nhận công việc.
Cấu hình
curl 'https://ai.tavonilo.com/v1/images/generations/async' \
-H "Authorization: Bearer $AI_SHOP_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"<IMAGE_MODEL_ID>","prompt":"A minimal product illustration"}'
# The 202 response contains poll_url. Query that URL with the same key.Các route này nhận payload ảnh không stream giống endpoint đồng bộ. Gửi thành công trả về 202 Accepted, poll_url và Retry-After; gọi URL đó bằng cùng Key đến khi completed hoặc failed. Khi server không có storage tác vụ ảnh, tính năng trả 404 thay vì nhận công việc.
Xác minh và khôi phục
Kiểm tra Key bằng /v1/models, thực hiện một yêu cầu nhỏ không nhạy cảm và chỉ giữ thời điểm, route, model, trạng thái HTTP và request ID cho hỗ trợ. Timeout không chứng minh tác vụ có tính phí chưa được xử lý, do đó không gửi lại mù quáng yêu cầu dài hoặc yêu cầu ảnh.
Ranh giới bảo mật
Dùng một Key cho mỗi thiết bị hoặc workload. Không bao giờ gửi API Key, auth.json, prompt riêng tư đầy đủ, mật khẩu, mã xác minh hoặc dữ liệu thanh toán cho hỗ trợ; thu hồi và thay thế Key ngay khi nghi ngờ lộ.