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에서 사전 확보 금액, 청구액, 환불액, 순청구액을 USD로 확인하세요. final: true이면 net_amount가 확정 금액입니다. null은 금액을 확인할 수 없다는 뜻입니다. 사용량 로그는 최근 거래를 표시하며 소비 항목 없이 환불만 표시될 수 있습니다. HTTP 404만으로 요청이 접수되지 않았거나 청구액이 0이라고 판단할 수 없습니다. 영수증에서 허용한 경우에만 새 키로 대체 요청을 보내세요. 과거 요청은 요청 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"
    }
  }
}