> ## 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ゲートウェイに関して最もよく寄せられる質問

## トピック

* [ストリームモード](https://docs.hostlinku.com/ja/faqs/stream-mode.md)：OpenAI SDK、Python `requests`、およびcurlを使用してSSEを利用する方法。
* [よく発生するエラー](https://docs.hostlinku.com/ja/faqs/errors.md)：401、402、404、422、429、および503。
* [レート制限](https://docs.hostlinku.com/ja/faqs/rate-limits.md)：クォータ、`Retry-After`ヘッダー、およびバックオフ。
* [請求・チャージ](https://docs.hostlinku.com/ja/faqs/billing.md)：残高、リミットキー、およびエラー402。
* [モデルは利用不可](https://docs.hostlinku.com/ja/faqs/model-unavailable.md)：404 対 503、非推奨、および Service Mode。

## OpenAIの公式SDKは使用できますか？

可能です。コードの変更は不要です。`base_url`/`baseURL`を`https://api.hostlinku.com/v1`にリダイレクトし、`sk-…`およびHostlinkuのAPIキーを`api_key`として使用してください。 完全な例は [Chat Completions](https://docs.hostlinku.com/ja/chat-completions.md#contoh-python-sdk-resmi-openai) にあります。

## どのようなエンドポイントが利用可能ですか？

現在、ゲートウェイでは、OpenAIと互換性のある2つの主要なエンドポイントを優先しています：

* `POST /v1/chat/completions`: [Chat Completions](https://docs.hostlinku.com/ja/chat-completions.md)
* `GET /v1/models`: [モデル](https://docs.hostlinku.com/ja/models.md)

その他のエンドポイント（例：埋め込み）は、パブリックゲートウェイではまだ利用できません。`/v1`以外のパブリックカタログ（サイト用）は、`/api/public/models`で利用可能です。コンソールページでは、APIキーではなく、セッションクッキーを使用した`/api/*`エンドポイントが使用されます。

## どのようなモデルが使用できますか？

[モデル](https://docs.hostlinku.com/ja/models.md)を参照してください：公式リストは`GET /v1/models`、またはコンソールの**モデル**メニューから取得できます。 カタログには、OpenAI、Anthropic、Google、DeepSeek、Qwenなどのモデルが含まれており、それぞれに固有のslugが割り当てられています。

## なぜ私のリクエストが401で拒否されたのですか？

最も一般的な原因：`Authorization`ヘッダーが存在しない、または`Bearer`の形式ではない、APIキーのコピーが間違っている、APIキーが失効している、または有効期限が切れている。 [console.hostlinku.com](https://console.hostlinku.com) で API キーを作成または確認してください。詳細はこちら：[認証](https://docs.hostlinku.com/ja/authentication.md)。

## 残高があるのに、なぜ402エラーが表示されるのですか？

エラーメッセージを確認してください。402エラーには2つの原因があります：**アカウント残高**が不足している（`available`：リクエストの推定費用を下回っている）、または**APIキーのクレジット制限**に達している場合です。 メッセージに「APIキーのクレジット制限」と表示されている場合は、リセット期間（毎日／毎週／毎月）を待つか、コンソールで制限を変更してください。詳細は[課金と残高](https://docs.hostlinku.com/ja/billing.md)をご覧ください。

## 1回のリクエストにかかる費用はいくらですか？

費用 = 入力トークン × 入力単価 + 出力トークン × 出力単価（トークン単位、モデルに応じて）。各モデルの単価はカタログに記載されています。各リクエストの実際の費用は、`hostlinku.cost` およびコンソールログに表示されます。詳細については、[請求と残高](https://docs.hostlinku.com/ja/billing.md) をご覧ください。

## レート制限はありますか？

はい：チャット補完機能については、APIキーあたり毎分600リクエスト、さらにコンソールエンドポイントについてはIPごとの制限があります。詳細な数値およびバックオフ戦略については、[使用状況と制限](https://docs.hostlinku.com/ja/usage-and-limits.md)をご覧ください。

## 画像やマルチメディアメッセージを送信するにはどうすればよいですか？

`messages[].content`に、OpenAI形式のコンテンツ配列を格納します （例：`image_url` 型のオブジェクト 1 つと、`text` 型のオブジェクト 1 つ）し、カタログから `vision`/`image-input` の機能を備えたモデルを選択してください。サポートの程度はモデルプロバイダーによって異なります。

## 漏洩したAPIキーの使用を停止するにはどうすればよいですか？

コンソールの**API Keys**メニューで、直ちにそのAPIキーを**revoke**してください。**revoke**されたAPIキーは、それ以降のすべてのリクエストに対して即座に拒否（401）されます。完全に削除するには、**purge**を使用してください。**revoke**前の利用履歴は、監査のために引き続き記録されます。

## リクエストログには、私の会話の内容が記録されていますか？

リクエストログには、**技術的なメタデータ**（モデル、ステータス、トークン数、料金、レイテンシ、リクエストID）が記録されます。これらのデータは、課金および監視のために必要です。 コンプライアンス要件に基づくデータ保持期間に関するご質問は、[halo@hostlinku.com](mailto:halo@hostlinku.com) までお問い合わせください。

## サポートにはどのように連絡すればよいですか？

[サポート](https://docs.hostlinku.com/ja/support.md)をご覧ください：**[halo@hostlinku.com](mailto:halo@hostlinku.com)** 宛てにメールをお送りください。問題のある返信に含まれる「`x-request-id`」を必ず記載してください。

答えが見つかりませんか？

ご質問は [halo@hostlinku.com](mailto:halo@hostlinku.com) までお送りください。このFAQは、最も頻繁に寄せられる質問に基づいて更新されています。


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