Error Codes - Inception Platform

Response Format

Responses are returned in JSON. Successful responses have a 2xx status code and contain the requested data. Error responses have a 4xx or 5xx status code and usually include an error object describing what went wrong:

{
  "error": {
    "message": "Incorrect API key provided",
    "type": "authentication_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

Error Codes

Code	Meaning	Solution
`400`	Invalid request	Check the request parameters. A `context_length_exceeded` error means the request exceeds the model’s context window; reduce the messages or completion length.
`401`	Invalid authentication	Verify your API key is correct and sent as `Authorization: Bearer $INCEPTION_API_KEY`, or generate a new key.
`402`	Payment required	Billing is inactive or your quota is exceeded. If the message is `Account is inactive`, check your account and payment information under Billing.
`404`	Model not found	The requested model is not available for your account. Verify the model name, such as `mercury-3`, `mercury-2.5`, `mercury-2`, or `mercury-edit-2`. See Models.
`413`	Decision request body too large	Reduce the request body.
`422`	Invalid decision request	Check the question types, criteria, and field locations in `detail`.
`429`	Rate limit reached	Pace requests and implement exponential backoff. See Rate Limits.
`500`	Server error	Retry after a brief wait; contact support if it persists.
`502`	Invalid upstream response	Retry after a brief wait; contact support if it persists.
`503`	Engine overloaded	Retry after a brief wait; contact support if it persists.
`504`	Decision service timeout	Retry after a brief wait; contact support if it persists.