APIMaster.ai

圖片冪等提交與原請求復原

圖片冪等提交與原請求復原

首次提交前請建立並保存唯一的 Idempotency-Key,並隨請求送出。若未收到回應,可用原冪等鍵及同一帳戶的 API 金鑰查回請求。用相同鍵重送同一請求不會再次生成或扣款。沿用相同鍵但改動請求時,會收到 HTTP 409。

復原原始提交

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'

非同步請求會在呼叫供應商之前一併保存任務 ID 和提交收據。取回 ID 後,可用 GET /v1/tasks/{task_id} 查詢狀態。原始回應本文自保存起可查詢 10 小時。過期後,查詢本文會回傳 HTTP 410 及 submission_response_expired,到期時間可查看 response_expires_at。任務 ID 和帳務資料仍可在收據中查詢。

客戶帳務

從 data.customer_billing 查看以美元計價的預留、扣款、退款及淨額。final: true 表示 net_amount 為最終淨扣款,null 表示金額無法核實。用量記錄顯示近期交易,可能只有退款列而沒有對應的消費列。HTTP 404 無法證明請求未受理或扣款為零。只有收據明確允許時,才用新鍵建立替代請求。若要核對歷史請求,請將原請求 ID 或任務 ID 提供給客服。

{
  "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"
    }
  }
}