이미지 요청의 멱등성 및 복구
이미지 요청의 멱등성 및 복구
첫 요청을 보내기 전에 고유한 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"
}
}
}
