よくある質問

一般的な質問

Puyun AI と OpenAI/Claude API の直接呼び出しの違いは何ですか？

Puyun AI は AI API 統合ゲートウェイです。Puyun AI を使用すると：

  • 1つの API Key で 40 以上のプロバイダーのすべてのモデルにアクセス
  • 自動プロトコル変換により、異なるモデルのために異なる SDK を適合させる必要がない
  • インテリジェントルーティング、フェイルオーバー、負荷分散を利用可能
  • 統合された課金と管理ダッシュボード

各プロバイダーを直接呼び出すには、個別のアカウント登録、複数の API Key の管理、異なるプロトコルへの適合が必要です。

プロトコル自動変換はどのように機能しますか？

OpenAI プロトコルで Claude モデルを呼び出すと、Puyun AI は以下を行います：

  1. OpenAI 形式のリクエストを受信
  2. それを Anthropic ネイティブ形式に変換して上流に送信
  3. Anthropic ネイティブレスポンスを OpenAI 形式に変換して返却

逆方向も同様です — Anthropic プロトコルで OpenAI モデルを呼び出す場合も自動変換されます。整プロセスはクライアント側から完全に透過的です。

どのモデルに対応していますか？

OpenAI、Anthropic、Google、AWS Bedrock、Azure、DeepSeek、Mistral、Meta など 40 以上のプロバイダーのモデルに対応しています。完全なモデル一覧はホームページでご確認いただくか、GET /v1/models API で照会してください。

アカウントと課金

3つのサービス階層の違いは何ですか？

階層位置づけ安定性料金
Testテスト検証基本最安
Flex個人開発良好中程度
Enterpriseエンタープライズ本番最高やや高め

詳細な比較は使い方ページをご覧ください。

チャージ方法は？

Portal にログインし、アカウントページでチャージ金額を選択します。前払い方式に対応しており、Token 消費は残高からリアルタイムで引き落とされます。

残高が不足したらどうなりますか？

残高が尽きると、API リクエストは 429 Too Many Requests エラーを返します。サービスを再開するにはチャージを行ってください。

使用量の確認方法は？

Portal にログインし、使用量ページで日付やモデルごとの Token 消費量と費用の明細を確認できます。

接続と設定

API Base URL は何ですか？

  • OpenAI プロトコル：https://ai.tracup.com/v1
  • Anthropic プロトコル：https://ai.tracup.com
  • Gemini プロトコル：https://ai.tracup.com

なぜ OpenAI プロトコルの Base URL には /v1 があり、Anthropic にはないのですか？

これは各プロトコルの慣例です：

  • OpenAI SDK はデフォルトでベース URL の後に /chat/completions などのパスを付加するため、ベース URL に /v1 を含める必要があります
  • Anthropic SDK はデフォルトでベース URL の後に /v1/messages を付加するため、ベース URL に /v1 を含めるべきではありません

ストリーミングレスポンスに対応していますか？

対応しています。すべてのプロトコルのエンドポイントでストリーミング出力に対応しており、stream: true を設定するだけで有効になります。

モデルと機能

Anthropic プロトコルで OpenAI モデルを呼び出すことはできますか？

はい。Puyun AI のプロトコル自動変換機能により、クロスプロトコルでの任意モデル呼び出しに対応しています。Anthropic プロトコルで GPT-4o を呼び出す場合、リクエストとレスポンスが自動的に適応されます。

Function Calling に対応していますか？

対応しています。Function Calling / Tool Use はプロトコル変換において正しくマッピングされます。

画像入力に対応していますか？

対応しています。OpenAI、Anthropic、Gemini プロトコルのすべてで画像入力（Vision）に対応しています。具体的な形式は各プロトコルの API リファレンスドキュメントをご参照ください。

Extended Thinking に対応していますか？

Extended Thinking は Claude モデルの固有機能であり、Anthropic プロトコルで Claude モデルを呼び出す場合のみ利用可能です。プロトコル変換を通じて Claude 以外のモデルを呼び出す場合はこの機能に対応しません。

トラブルシューティング

401 エラーが返される

  • API Key が正しいことを確認
  • ヘッダーの形式を確認：Authorization: Bearer sk-xxx または x-api-key: sk-xxx
  • API Key が期限切れでないことを確認

429 エラーが返される

  • 残高不足：Portal でチャージ
  • レート制限：しばらく待ってから再試行するか、より高いサービス階層にアップグレード

404 エラーが返される

  • リクエストパスが正しいことを確認
  • モデル名のスペルが正しいことを確認
  • Base URL が正しく設定されていることを確認（OpenAI プロトコルには /v1 が必要）

レスポンス形式が異常

  • 使用しているプロトコルエンドポイントがクライアントと一致していることを確認
  • モデルが使用している機能に対応していることを確認
  • curl で直接リクエストして検証してみる

接続タイムアウト

  • ネットワークから ai.tracup.com にアクセスできることを確認
  • Base URL のスペルが正しいことを確認
  • プロキシを使用している場合は、プロキシ設定を確認