メインコンテンツまでスキップ

よくある質問

まず API リクエストとクライアント設定を確認し、その後に個別のエラーを調べます。

API リクエスト​

API Key が完全にコピーされているか確認するには​

Key は通常、作成時に一度だけ完全表示されます。安全なローカル場所へコピーし、前後の空白、改行、スマートクォートがないことを確認します。完全な値が見えなくなった場合は推測せず、古い Key を無効にして作り直します。

ソフトウェアと curl のどちらを先に試すべきですか​

先に curl を試します。アドレス、Key、モデル、リクエスト本文を明示できるため、クライアントのキャッシュや環境変数の継承を切り分けられます。

curl は動くのにソフトウェアが失敗するのはなぜですか​

Provider の種類、Base URL の階層、API Key、Model の各項目を確認し、新しい会話を作るかクライアントを再起動します。

Base URL と完全な Endpoint の違いは何ですか​

Base URL はプロトコルのルートで、クライアントがパスを追加します。完全な Endpoint には操作のパスが含まれています。

モデル一覧が空なのはなぜですか​

第三者のモデル一覧を自動取得しないクライアントがあります。Key と Base URL が正しければ、モデルと料金から YOUR_MODEL をコピーして手入力できます。

アカウント状態やクォータ不足を確認するには​

Key、モデル、パスが正しいのに 403 または 429 が返る場合は、ポータルでアカウント状態、クォータ、現在のモデルの利用可否を確認します。公開ドキュメントの古いスクリーンショットだけで判断しないでください。

最小リクエストで切り分ける​

URL、Key、モデル、本文を固定して短いメッセージを一つ送ります。curl が成功する場合はクライアント設定や古いセッションを確認し、失敗する場合は HTTP ステータスからエラー修正を開きます。

クライアントとローカル環境​

コマンドが見つからない​

  • 症状： クライアントや端末に「コマンドが見つからない」と表示されるか、保存後もリクエストが失敗します。
  • 原因： 端末が claude、codex、gemini を見つけられない場合、インストール先が PATH にないか、古い端末が環境を更新していません。
  • 確認：
    1. クライアントを起動する同じセッションでコマンド、環境変数、Provider、Base URL、Key、モデルを確認します。
    2. 古いセッションとプロセスを閉じて再起動します。
    3. 最終 URL をクイックスタートの表と照合します。
  • 対処： 新しい端末でバージョンコマンドを実行します。まだ失敗する場合は公式ソースから再インストールし、不明なミラーは使いません。
  • 検証： クライアントを再起動して短いメッセージを送ります。想定した URL、モデル、認証で正常な内容が返れば復旧です。

環境変数が反映されない​

  • 症状： クライアントや端末に「環境変数が反映されない」と表示されるか、保存後もリクエストが失敗します。
  • 原因： 変数を設定した端末とは別の古いウィンドウ、ショートカット、バックグラウンドプロセスからアプリを起動しています。
  • 確認：
    1. クライアントを起動する同じセッションでコマンド、環境変数、Provider、Base URL、Key、モデルを確認します。
    2. 古いセッションとプロセスを閉じて再起動します。
    3. 最終 URL をクイックスタートの表と照合します。
  • 対処： アプリを起動する同じ端末で変数を表示し、設定後は古いセッションを閉じて開き直します。
  • 検証： クライアントを再起動して短いメッセージを送ります。想定した URL、モデル、認証で正常な内容が返れば復旧です。

保存後も既定サービスへ送信される​

  • 症状： クライアントや端末に「保存後も既定サービスへ送信される」と表示されるか、保存後もリクエストが失敗します。
  • 原因： クライアントが古い Provider をキャッシュしているか、現在の会話が新設定へ切り替わっていません。
  • 確認：
    1. クライアントを起動する同じセッションでコマンド、環境変数、Provider、Base URL、Key、モデルを確認します。
    2. 古いセッションとプロセスを閉じて再起動します。
    3. 最終 URL をクイックスタートの表と照合します。
  • 対処： 新しい会話を作るかクライアントを再起動し、Provider、Base URL、Key、モデルが PopGo 設定か確認します。
  • 検証： クライアントを再起動して短いメッセージを送ります。想定した URL、モデル、認証で正常な内容が返れば復旧です。

モデルが利用できない​

  • 症状： クライアントや端末に「モデルが利用できない」と表示されるか、保存後もリクエストが失敗します。
  • 原因： モデル ID の綴り、アクセス範囲、ライブ可用性が変わっています。
  • 確認：
    1. クライアントを起動する同じセッションでコマンド、環境変数、Provider、Base URL、Key、モデルを確認します。
    2. 古いセッションとプロセスを閉じて再起動します。
    3. 最終 URL をクイックスタートの表と照合します。
  • 対処： モデルと価格ページからモデル ID を再コピーし、古いスクリーンショットから手入力せず最小リクエストで確認します。
  • 検証： クライアントを再起動して短いメッセージを送ります。想定した URL、モデル、認証で正常な内容が返れば復旧です。

npm のグローバルインストール権限エラー​

  • 症状： クライアントや端末に「npm のグローバルインストール権限エラー」と表示されるか、保存後もリクエストが失敗します。
  • 原因： Windows ではインストール権限が不足し、macOS/Linux では Node.js の導入方法によってグローバルディレクトリを書き込めないことがあります。
  • 確認：
    1. クライアントを起動する同じセッションでコマンド、環境変数、Provider、Base URL、Key、モデルを確認します。
    2. 古いセッションとプロセスを閉じて再起動します。
    3. 最終 URL をクイックスタートの表と照合します。
  • 対処： Windows では必要に応じて権限のある PowerShell を開き直します。macOS/Linux では公式の方法またはパッケージマネージャーを使い、長期的に sudo npm install -g に依存しないでください。
  • 検証： クライアントを再起動して短いメッセージを送ります。想定した URL、モデル、認証で正常な内容が返れば復旧です。

Claude Code が公式アカウントへのログインを求める​

  • 症状： クライアントや端末に「Claude Code が公式アカウントへのログインを求める」と表示されるか、保存後もリクエストが失敗します。
  • 原因： Claude Code が環境変数を読み取れず、公式ログインフローへ戻っています。
  • 確認：
    1. クライアントを起動する同じセッションでコマンド、環境変数、Provider、Base URL、Key、モデルを確認します。
    2. 古いセッションとプロセスを閉じて再起動します。
    3. 最終 URL をクイックスタートの表と照合します。
  • 対処： 同じ端末で ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN を確認し、古いウィンドウを閉じて再起動し、claude doctor を実行します。
  • 検証： クライアントを再起動して短いメッセージを送ります。想定した URL、モデル、認証で正常な内容が返れば復旧です。

Codex で認証エラーが出る​

  • 症状： クライアントや端末に「Codex で認証エラーが出る」と表示されるか、保存後もリクエストが失敗します。
  • 原因： ローカル設定が POPGO_API_KEY を読めないか、config.toml の Provider 名、model_provider、env_key が対応していません。
  • 確認：
    1. クライアントを起動する同じセッションでコマンド、環境変数、Provider、Base URL、Key、モデルを確認します。
    2. 古いセッションとプロセスを閉じて再起動します。
    3. 最終 URL をクイックスタートの表と照合します。
  • 対処： 変数名が POPGO_API_KEY と完全に一致することを確認し、model_provider = popgo と model_providers.popgo の対応を確認します。
  • 検証： クライアントを再起動して短いメッセージを送ります。想定した URL、モデル、認証で正常な内容が返れば復旧です。

Base URL の入力後に 404 が返る​

  • 症状： クライアントや端末に「Base URL の入力後に 404 が返る」と表示されるか、保存後もリクエストが失敗します。
  • 原因： アプリが入力値の後ろにパスを追加し、/v1/v1 や完全な Endpoint の重複になることがあります。
  • 確認：
    1. クライアントを起動する同じセッションでコマンド、環境変数、Provider、Base URL、Key、モデルを確認します。
    2. 古いセッションとプロセスを閉じて再起動します。
    3. 最終 URL をクイックスタートの表と照合します。
  • 対処： Quickstart の Base URL 階層表を確認します。Base URL 欄にはプロトコルのルートを、完全な Endpoint 欄にだけ完全なパスを入力します。
  • 検証： クライアントを再起動して短いメッセージを送ります。想定した URL、モデル、認証で正常な内容が返れば復旧です。

証明書または SSL エラー​

  • 症状： クライアントや端末に「証明書または SSL エラー」と表示されるか、保存後もリクエストが失敗します。
  • 原因： ローカルプロキシ、会社ネットワークの遮断、システム時刻の誤り、証明書チェーンの異常などが一般的な原因です。
  • 確認：
    1. クライアントを起動する同じセッションでコマンド、環境変数、Provider、Base URL、Key、モデルを確認します。
    2. 古いセッションとプロセスを閉じて再起動します。
    3. 最終 URL をクイックスタートの表と照合します。
  • 対処： TLS 検証を無効にしないでください。時刻を確認し、ローカルプロキシを外すか別ネットワークで試し、セキュリティソフトの HTTPS 検査を確認します。
  • 検証： クライアントを再起動して短いメッセージを送ります。想定した URL、モデル、認証で正常な内容が返れば復旧です。

参照音声と出力音声の違い​

generate_audioは出力トラックだけです。参照入力の証拠ではありません。能力で動画／音声、動画のみ、音声のみを表示。動画参照は動画必須、音声のみは音声必須です。

Cは音声対応なのに動画非対応なのはなぜ？​

Cの動画入力は明確に非対応で、上限0を空欄にして回避できません。参照音声は最大3件です。Klingの資料は参照音声欄を公開していないため閉じ、Grokも非対応です。

オンライン素材の貼り付けは常に公開URLになる？​

HTTP(S)直リンクは保持しますが、バイナリだけのコピーはローカルです。生成素材もsourceUrlを保持した場合のみ公開。ラベルで取得元を見られますがサービス取得は保証しません。Base64非対応には取得可能URLが必要。

IDがあるのに参照が効かないのはなぜ？​

IDは受付のみを証明。モード、送信欄、取得、成片を確認します。先頭フレームと通常参照は違い、無視された欄でも生成・課金され得ます。動画タスクを参照。

推奨する切り分け順序​

  1. 最初に HTTP ステータス、リクエストパス、クライアント、発生時刻を記録します。
  2. クイックスタートの最小 curl で再現し、Key、モデル、URL、クライアントのどこに問題があるかを分けます。
  3. 一度に一つだけ変更します。ストリーミング、ツール、メディア設定を戻す前に短いテキストで確認します。