Skip to main content
The API uses standard HTTP status codes and returns detailed error messages.

​
Status codes

StatusMeaningDescription
200SuccessRequest completed successfully
400Bad RequestInvalid request body on the OpenAI-compatible endpoint
401UnauthorizedInvalid or missing API key
402Payment RequiredPayment challenge for enabled self-serve personas when no API key is sent
403ForbiddenAPI key is not associated with an active billing account
404Not FoundInvalid persona ID
422Unprocessable EntityInvalid request body or parameters
429Too Many RequestsInsufficient balance or quota exhausted on API-key billing
500Internal Server ErrorServer error. Contact support if persistent

​
ThinkFeel endpoint validation errors

The /generate and /personify endpoints return plain text for most validation and authentication errors. 
Unknown `personaId` was provided in the body.
Quota and unexpected server errors may return JSON, so clients should check the response content type before parsing errors. Requests without API-key headers may also receive a payment challenge instead of a JSON or plain-text error when self-serve payment access is enabled for the target persona. If a persona is not enabled for self-serve payment access, send an API key header. Unauthenticated requests can return 404 instead of confirming persona availability.

​
OpenAI-compatible error format

{
  "error": {
    "message": "Missing required `model`.",
    "type": "invalid_request_error",
    "param": "model",
    "code": null
  }
}