When credits are used
Use returned usage fields and the credit log to determine the outcome of a particular request. Do not infer a charge or refund solely from an HTTP timeout: the server may have processed the request before the connection ended.
Avoid accidental duplicate operations
Preserve the same idempotency key and request body when retrying one intended send. Starting a new operation with a new key can create another message and another charge. Bulk responses can contain failures alongside successes; retry only the intended failed work after reconciling its outcome.Limits and billing questions
Atier_limit error indicates a plan restriction; insufficient_credits indicates the available credit/overage policy prevented processing. They require different remedies. Check the response and account settings before changing the workflow.
For a billing discrepancy, send support the environment, request ID, timestamp, and relevant usage entry. Do not include API keys or card information. See Limits and Logs.
