APIMaster.ai

Tính lũy đẳng và khôi phục yêu cầu tạo ảnh

Tính lũy đẳng và khôi phục yêu cầu tạo ảnh

Tạo và lưu một Idempotency-Key duy nhất trước khi gửi yêu cầu đầu tiên. Nếu không nhận được phản hồi, hãy dùng khóa lũy đẳng ban đầu và khóa API của cùng tài khoản để tìm lại yêu cầu. Gửi lại cùng yêu cầu với cùng khóa không tạo ảnh hoặc tính phí lần nữa. Thay đổi yêu cầu mà vẫn dùng khóa cũ sẽ trả về HTTP 409.

Khôi phục yêu cầu ban đầu

curl --fail-with-body 'https://apimaster.ai/v1/image-submissions/by-key' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: image-order-123-attempt-1'

curl --fail-with-body 'https://apimaster.ai/v1/image-submissions/by-request/REQUEST_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl --fail-with-body 'https://apimaster.ai/v1/image-submissions/by-key/response' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: image-order-123-attempt-1'

Với yêu cầu bất đồng bộ, mã tác vụ và biên nhận được lưu trước khi gọi nhà cung cấp. Khi tìm được mã, hãy xem trạng thái bằng GET /v1/tasks/{task_id}. Nội dung phản hồi gốc có thể truy xuất trong 10 giờ kể từ lúc lưu. Sau thời hạn đó, yêu cầu lấy nội dung sẽ trả về HTTP 410 và submission_response_expired. Xem response_expires_at để biết thời điểm hết hạn. Mã tác vụ và thông tin tính phí vẫn còn trong biên nhận.

Thông tin tính phí của khách hàng

Xem data.customer_billing để biết số tiền tạm giữ, đã thu, đã hoàn và phí ròng tính bằng USD. Khi final: true, net_amount là số tiền cuối cùng. Giá trị null cho biết chưa xác minh được số tiền. Nhật ký sử dụng hiển thị các giao dịch gần đây và có thể có dòng hoàn tiền mà không có dòng tiêu thụ tương ứng. HTTP 404 không xác nhận yêu cầu bị từ chối hay không có phí. Chỉ gửi yêu cầu thay thế với khóa mới khi biên nhận cho phép. Với yêu cầu cũ, hãy gửi mã yêu cầu hoặc mã tác vụ cho bộ phận hỗ trợ.

{
  "data": {
    "customer_billing": {
      "currency": "USD",
      "status": "settled",
      "final": true,
      "precharged_amount": "0.015876",
      "charged_amount": "0.015876",
      "refunded_amount": "0.000000",
      "net_amount": "0.015876"
    }
  }
}