ネットワークと接続について

接続方式

クライアントのプロトコルに応じて、適切な Base URL を選択してください。

ストリーミングモードの推奨

すべての対話型シーンで stream: true を有効にすることを推奨します。 ストリーミングモードでは最初のトークンが届くまでの待ち時間を 2〜3 秒に短縮できます。非ストリーミングではモデルがすべてのコンテンツを生成し終わるまで待つ必要があり、大規模モデルが長い回答を生成する場合はタイムアウトしやすくなります。

Cherry Studio、ChatBox などのクライアントでレスポンスのタイムアウトや空のコンテンツが発生した場合は、まずストリーミング（Streaming）モードが有効になっているか確認してください。

接続のトラブルシューティング

1. Base URL がクライアントのプロトコルと一致しているか確認してください。
2. 外部ネットワークが api.portal.aiin1.ai へのアクセスを許可しているか確認してください。
3. プロキシ、ファイアウォール、またはゲートウェイが HTTPS ロングコネクション / SSE をブロックしていないか確認してください。
4. ローカルの DNS と証明書の検証が正常か確認してください。
5. レスポンスがタイムアウトしたり長時間コンテンツが返らない場合：リクエストに "stream": true が含まれているか確認してください。非ストリーミングリクエストでは、モデルが長いコンテンツを生成する際にタイムアウトする可能性があります。

OpenAI Compatible の例（ストリーミング）

curl https://api.portal.aiin1.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-nex-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "こんにちは"}],
    "max_tokens": 256,
    "stream": true
  }'

Anthropic Messages API の例（ストリーミング）

curl https://api.portal.aiin1.ai/v1/messages \
  -H "x-api-key: sk-nex-your-key-here" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "こんにちは"}],
    "max_tokens": 256,
    "stream": true
  }'

クライアントが Base URL の入力のみを求める場合、Anthropic ネイティブクライアントでは https://api.portal.aiin1.ai を入力してください。SDK がプロトコルに従い /v1/messages にリクエストを送信します。