ApiV1ReferenceErrors
Errors Reference
Where to find error JSON shapes and error_id meanings for the Skytells API.
Errors reference
If a call fails, you usually need two things: what the JSON looks like, and what error_id means. Use this page to pick the right shape; use the catalog for codes and fixes.
Error objects
JSON examples and field lists for each error body type.
API errors
Status codes, error_id tables, and how to resolve common failures.
Pick your API
The error body is not the same everywhere. Match the API you called:
| You called | Error body | Full detail |
|---|---|---|
| Chat, Responses, or Embeddings | One top-level key: "error": { ... } (OpenAI-compatible — no status / response wrapper) | Inference error response |
| Most other REST (auth, models, predictions, rate limits, …) | Unified envelope: status, response, nested error | Unified API error |
| Predictions — job failed after it was created | Still a prediction record, with status: "failed" | Failed prediction object · guide |
Chat / Responses / Embeddings use a different list of error_id values and retry rules than the general catalog — see Inference API errors. Predictions routes also document route-specific codes — Prediction errors.
How is this guide?