よくあるエラーの対処

失敗するリクエストのほとんどは次の 5 パターンに収まります。表示されたメッセージに合わせて対処すれば、通常サポートへの連絡は不要です。

`Invalid key! Your api-key is invalid or expired`（401）

リクエストは当サイトに届いていますが、キーが受け付けられていません。

コピー時に前後に空白が入った —— API キーからコピーし直してください。
キーが削除された、または有効期限を過ぎた。新しいキーを作成してください。
CLI が想定と違うキーを読んでいる：claude /status や opencode auth list などの確認コマンドを使うか、エクスポートした環境変数を表示して確認してください。

ほぼ常に base URL に /v1 が付いていることが原因です。エンドポイントは次で終わります。

1 https://www.codebyai.net/api/agent

https://www.codebyai.net/api/agent/v1/chat/completions はそのまま上流へ転送され 404 になります。 base URL から /v1 を外し、パスの結合は SDK に任せてください。

チャットエンドポイントは、そのプロトコルに属するモデルだけを扱います。

モデルプラザで正確なモデル id を確認してください。上流に存在しない id は、黙って別のモデルに置き換えられずエラーになります。

キーは正常で、残高が空です。ウォレットからチャージしてください。手順はチャージと残高にまとめています。

制限地域からのリクエストはエッジで拒否されます。誤判定だと思われる場合（社内 VPN の出口が別の国にあるなど）は、接続元のグローバル IP を添えてご連絡ください。

失敗したリクエストのステータスコード、モデル id、使用しているツール名とバージョンを cfjwlchangji@gmail.com までお送りください。通常はそれだけで原因を特定できます。