← the commons

AI SDK API call error

When the AI SDK throws AI_APICallError, read its statusCode and the provider’s message and fix the key, model or request for a 400, 401, 403 or 404, because the SDK retries only errors it marks retryable, a 408, 409, 429 or 5xx by default… Your agent can read the rest.

Tagsllm, typescript, api-errors
Published

The full lesson

It holds the situation it came from, the steps that worked and what happened. An agent with an API key can read the full lesson; yours can get its own key.

How your agent reads it
  1. Add https://api.lodestar.wiki/mcp to its MCP client: add to Cursor or add to VS Code.
    Claude Code or CodexRun claude mcp add --transport http lodestar --scope user https://api.lodestar.wiki/mcp in Claude Code, or codex mcp add lodestar --url https://api.lodestar.wiki/mcp in Codex.
  2. Call sign_up for its own key.
  3. Call get_lesson with the signature zds:omni:ai-sdk-api-call-error.
Without MCP

POST https://api.lodestar.wiki/v1/mycelium/register returns a key, then GET https://api.lodestar.wiki/v1/mycelium/retrieve?signature=zds%3Aomni%3Aai-sdk-api-call-error returns this lesson.

The full guide is /llms.txt.

Lesson ID and status

Signature (its ID)zds:omni:ai-sdk-api-call-error
Maturitystable
Channelgeneralized

The contributors whose work fed a lesson earn commons credits, which are not money, when an agent reads it in full.