Skill

openrouter-common-errors

Diagnose and fix common OpenRouter API errors. Use when encountering error codes or unexpected failures. Trigger with phrases like 'openrouter error', 'openrouter 401', 'openrouter 429', 'fix openrouter'.

From openrouter-pack

Install

Run in your terminal

npx claudepluginhub nickloveinvesting/nick-love-plugins --plugin openrouter-pack

Tool Access

This skill is limited to using the following tools:

ReadWriteEditGrep

Supporting Assets

View in Repository

references/authentication-errors-(401).md

references/errors.md

references/examples.md

references/model-errors-(400).md

references/rate-limit-errors-(429).md

references/request-errors.md

Skill Content

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

138.6k

claude-opus-4-5-migration

2 files

Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.

claude-opus-4-5-migration

83.2k

evaluation-methodology

1 file

Details PluginEval's skill quality evaluation: 3 layers (static, LLM judge), 10 dimensions, rubrics, formulas, anti-patterns, badges. Use to interpret scores, improve triggering, calibrate thresholds.

plugin-eval

32.9k

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitMar 20, 2026

Actions

View Source View Plugin View on GitHub View README

Instructions

Identify the error code: Check the HTTP status code and the error.code field in the response body for the specific error type

Look up the error: Match the error against the common patterns below — 401 (auth), 402 (credits), 429 (rate limit), 400 (bad request), 5xx (server)

Apply the fix: Follow the resolution steps for the specific error; most common errors are configuration issues that can be fixed without code changes

Add error handling: Wrap API calls in try/catch blocks that handle each error category differently (retry for 429/5xx, fail fast for 401/400)

Prevent recurrence: Add validation middleware that catches common mistakes (missing API key, invalid model ID, malformed messages) before making the API call

Error Handling

Error	Cause	Fix
401 Unauthorized	Invalid, expired, or missing API key	Verify key starts with `sk-or-`; check it's not revoked at openrouter.ai/keys
402 Payment Required	No credits remaining	Add credits at openrouter.ai/credits; or use a free model like `google/gemma-2-9b-it:free`
429 Too Many Requests	Rate limit exceeded	Implement exponential backoff; respect `Retry-After` header; reduce request rate
400 Bad Request	Malformed request body	Validate `messages` array format; check `model` ID includes provider prefix
408 Request Timeout	Model took too long to respond	Retry with a faster model; reduce `max_tokens`; use streaming
502/503 Server Error	Upstream provider outage	Retry with backoff; check status.openrouter.ai; use fallback models

Error

Cause

Fix

401 Unauthorized

Invalid, expired, or missing API key

Verify key starts with sk-or-; check it's not revoked at openrouter.ai/keys

402 Payment Required

No credits remaining

Add credits at openrouter.ai/credits; or use a free model like google/gemma-2-9b-it:free

429 Too Many Requests

Rate limit exceeded

Implement exponential backoff; respect Retry-After header; reduce request rate

400 Bad Request

Malformed request body

Validate messages array format; check model ID includes provider prefix

408 Request Timeout

Model took too long to respond

Retry with a faster model; reduce max_tokens; use streaming

502/503 Server Error

Upstream provider outage

Retry with backoff; check status.openrouter.ai; use fallback models

See ${CLAUDE_SKILL_DIR}/references/errors.md for full error reference.

Instructions

Identify the error code: Check the HTTP status code and the error.code field in the response body for the specific error type

Look up the error: Match the error against the common patterns below — 401 (auth), 402 (credits), 429 (rate limit), 400 (bad request), 5xx (server)

Apply the fix: Follow the resolution steps for the specific error; most common errors are configuration issues that can be fixed without code changes

Add error handling: Wrap API calls in try/catch blocks that handle each error category differently (retry for 429/5xx, fail fast for 401/400)

Prevent recurrence: Add validation middleware that catches common mistakes (missing API key, invalid model ID, malformed messages) before making the API call

Error Handling

Error	Cause	Fix
401 Unauthorized	Invalid, expired, or missing API key	Verify key starts with `sk-or-`; check it's not revoked at openrouter.ai/keys
402 Payment Required	No credits remaining	Add credits at openrouter.ai/credits; or use a free model like `google/gemma-2-9b-it:free`
429 Too Many Requests	Rate limit exceeded	Implement exponential backoff; respect `Retry-After` header; reduce request rate
400 Bad Request	Malformed request body	Validate `messages` array format; check `model` ID includes provider prefix
408 Request Timeout	Model took too long to respond	Retry with a faster model; reduce `max_tokens`; use streaming
502/503 Server Error	Upstream provider outage	Retry with backoff; check status.openrouter.ai; use fallback models

Error

Cause

Fix

401 Unauthorized

Invalid, expired, or missing API key

Verify key starts with sk-or-; check it's not revoked at openrouter.ai/keys

402 Payment Required

No credits remaining

Add credits at openrouter.ai/credits; or use a free model like google/gemma-2-9b-it:free

429 Too Many Requests

Rate limit exceeded

Implement exponential backoff; respect Retry-After header; reduce request rate

400 Bad Request

Malformed request body

Validate messages array format; check model ID includes provider prefix

408 Request Timeout

Model took too long to respond

Retry with a faster model; reduce max_tokens; use streaming

502/503 Server Error

Upstream provider outage

Retry with backoff; check status.openrouter.ai; use fallback models

See ${CLAUDE_SKILL_DIR}/references/errors.md for full error reference.

openrouter-common-errors

openrouter-common-errors

Openrouter Common Errors

Overview

Prerequisites

Instructions

Output

Error Handling

Examples

Resources

Openrouter Common Errors

Overview

Prerequisites

Instructions

Output

Error Handling

Examples

Resources