> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hostlinku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# よく発生するエラー

> 最もよく見られるエラーコード「Hostlinku」の原因と解決策。

すべてのエラーは同じエンベロープ「`{"error": {"code": "...", "message": "..."}}`」を使用しています。完全なリストは [エラー](https://docs.hostlinku.com/ja/errors.md) に記載されています。

## 401 アクセス拒否

APIキーが存在しない、コピーミスがある、無効化されている、または有効期限が切れている可能性があります。ヘッダーに「`Authorization: Bearer sk-...`」または「`x-api-key`」が使用されていることを確認し、コンソールの**API Keys**でキーのステータスを確認してください。

## 402 支払いが必要

原因は2つあります：

* **アカウントの残高**が、リクエストの推定費用に不足しています。
* **APIキーのクレジット上限**に達しました（1日、1週間、1か月、または合計）。

エラーメッセージを確認して、原因を特定してください。コンソールで残高とキーの制限を確認してください。詳細：[請求・残高](https://docs.hostlinku.com/ja/billing.md)。

## 404 MODEL\_NOT\_FOUND

カタログにこのモデルのslugがありません。`GET /v1/models` または [モデル](https://docs.hostlinku.com/ja/models.md) ページから正確なslugを取得してください。表示名からslugを推測しないでください。

## 400 MODEL\_NOT\_IN\_SERVICE\_MODE

モデルは存在しますが、使用されているService Mode API keyでは利用できません。例：キー「Low-Cost」が、ルート「Performance」のみを持つモデルを呼び出しています。適切なモードのキーを作成するか、別のモデルを選択してください。

## 422 検証に失敗しました

リクエスト本文が検証に失敗しました：`messages` が空であるか、フィールドのタイプが間違っているか、必須フィールドが欠落しています。レスポンスにはフィールドごとの詳細が含まれています。[Chat Completions](https://docs.hostlinku.com/ja/chat-completions.md) のリクエスト本文の例を確認してください。

## 429 RATE\_LIMITED

リクエスト制限を超えました。ヘッダー `Retry-After` および `RateLimit-*` を確認し、指数関数的なバックオフを適用して再試行してください。リミッターによって拒否されたリクエストは、残高から差し引かれません。詳細：[使用状況と制限](https://docs.hostlinku.com/ja/usage-and-limits.md)。

## 503 MODEL\_UNAVAILABLE / UPSTREAM\_ERROR

このモデルは非推奨または利用不可となっています。あるいは、アップストリームで一時的な障害が発生しています。`UPSTREAM_ERROR`については、しばらくしてから再度お試しください。`MODEL_UNAVAILABLE`については、エラーメッセージに`replacement_slug`が含まれていないかご確認ください。

デバッグのヒント

レスポンスヘッダーの「`x-request-id`」を保存してください。このIDは、サポートに連絡する際、リクエストとコンソールのログを照合するために使用できます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.