Error troubleshooting

Reduce the problem before retrying it. Repeated concurrent retries can make a rate, concurrency, or balance problem worse.

Collect safe details first

• Request time and time zone.
• API key name, never the full key.
• Model ID, endpoint, and HTTP status.
• A redacted error message and whether the client retries automatically.

401: authentication failed

• Use Authorization: Bearer YOUR_KEY.
• Check for copied whitespace or a disabled key.
• Confirm the SDK uses https://1pkapi.com/v1 as its base URL.

429: request limited

• Lower concurrency and use bounded exponential backoff.
• Check whether multiple applications share the same key.
• Review the current key, model, and account limits in the console.

Model unavailable

Use the current key's model list rather than an ID from another account or an old tutorial.

Temporary availability errors

Wait, then retry once with a short request. Preserve the error time and model if the problem persists.