APIMaster.ai

Idempotenza e recupero delle richieste di immagini

Idempotenza e recupero delle richieste di immagini

Invia un valore Idempotency-Key univoco al primo tentativo e salvalo prima dell'invio. Se perdi la risposta, recupera la richiesta con la stessa chiave di idempotenza e una chiave API dello stesso account. Reinviare la stessa richiesta con la stessa chiave non ripete la generazione né l'addebito. Se modifichi la richiesta e riusi la chiave, riceverai HTTP 409.

Recuperare la richiesta originale

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'

Per le richieste asincrone, l'ID del processo e la ricevuta vengono salvati prima della chiamata al fornitore. Usa GET /v1/tasks/{task_id} per lo stato dopo aver recuperato l'ID. Il corpo della risposta originale resta disponibile per 10 ore dal salvataggio. Alla scadenza, la richiesta del corpo restituisce HTTP 410 e submission_response_expired. response_expires_at indica quando scade. L'ID e i dati di fatturazione rimangono nella ricevuta.

Fatturazione del cliente

Leggi data.customer_billing per importo riservato, addebito, rimborso e importo netto in USD. Con final: true, net_amount è definitivo. Un valore null indica che l'importo non è stato verificato. Il registro di utilizzo mostra i movimenti recenti e può riportare un rimborso senza la relativa riga di consumo. Un HTTP 404 non conferma né il rifiuto della richiesta né un addebito nullo. Invia una richiesta sostitutiva con una nuova chiave solo se la ricevuta lo consente. Per le richieste precedenti, fornisci all'assistenza l'ID della richiesta o dell'attività.

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