Errors and credits

Generation endpoints can reserve or spend credits through the same billing paths used by the Sume web app.

Check credits

sume credits
curl https://www.sume.so/api/v1/credits \
  -H "Authorization: Bearer $SUME_API_KEY"

The response includes plan, available credits, and active concurrency information when available.

Error envelope

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this request.",
    "details": {}
  },
  "request_id": "req_..."
}

Log the request_id for support, but avoid logging API keys, signed URLs, or raw private media URLs.