APIMaster.ai

Idempotencia y recuperación de solicitudes de imágenes

Idempotencia y recuperación de solicitudes de imágenes

Envía un Idempotency-Key único en la primera solicitud y guárdalo antes de enviarla. Si se pierde la respuesta, consulta la solicitud con la clave de idempotencia original y una clave de API de la misma cuenta. Repetir el mismo envío con la misma clave no vuelve a generar la imagen ni a cobrar el importe. Si cambias la solicitud y reutilizas la clave, recibirás HTTP 409.

Recuperar el envío original

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'

Para los trabajos asíncronos, el ID de tarea y el comprobante se guardan antes de contactar con el proveedor. Cuando tengas el ID, consulta GET /v1/tasks/{task_id}. El cuerpo de la respuesta original está disponible durante 10 horas desde que se guarda. Después, la consulta del cuerpo devuelve HTTP 410 y submission_response_expired. Consulta response_expires_at para ver el momento de caducidad. El comprobante mantiene el ID y los datos de facturación.

Facturación del cliente

Consulta data.customer_billing para ver la retención, el cargo, el reembolso y el importe neto en USD. Si final: true, net_amount es definitivo; null indica que el importe no se pudo verificar. El historial de uso muestra movimientos recientes y un reembolso puede aparecer sin el cargo correspondiente. Un HTTP 404 no confirma si la solicitud fue aceptada ni si el importe es cero. Crea una solicitud de reemplazo con una nueva clave solo cuando el comprobante lo autorice. Para casos antiguos, envía al soporte el ID de solicitud o de tarea.

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