APIMaster.ai

Idempotence et récupération des demandes d’image

Idempotence et récupération des demandes d’image

Enregistrez une clé Idempotency-Key unique avant le premier envoi. Si la réponse est perdue, utilisez la clé d’idempotence d’origine et une clé API du même compte pour retrouver la demande. Renvoyer la même demande avec la même clé ne relance ni la génération ni la facturation. Une demande modifiée avec la même clé reçoit le code HTTP 409.

Récupérer la demande d’origine

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'

Pour une demande asynchrone, l’identifiant de la tâche et son reçu sont enregistrés avant l’appel au fournisseur. Une fois l’identifiant obtenu, consultez GET /v1/tasks/{task_id}. Le corps de la réponse reste accessible pendant 10 heures après son enregistrement. Après expiration, le téléchargement du corps renvoie HTTP 410 et submission_response_expired. Le champ response_expires_at indique la date d’expiration. L’identifiant et la facturation restent accessibles dans le reçu.

Facturation du client

Consultez data.customer_billing pour la réserve, le débit, le remboursement et le montant net en USD. Avec final: true, net_amount est définitif. Une valeur null indique que le montant n’a pas pu être vérifié. Le journal d’utilisation affiche les mouvements récents. Un remboursement peut y figurer sans ligne de consommation correspondante. Un code HTTP 404 ne confirme ni le refus de la demande ni un montant nul. Utilisez une nouvelle clé pour une demande de remplacement uniquement si le reçu l’autorise. Pour un ancien envoi, communiquez au support l’identifiant de la demande ou de la tâche.

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