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