圖片冪等提交與原請求復原
圖片冪等提交與原請求復原
首次提交前請建立並保存唯一的 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"
}
}
}
