エラーコードのトラブルシューティング方法、認証、レート制限、一時ブロック、インターフェース、料金問題。 完全な検査手順、実務検証、エラー処理が含まれます。

429に関するよくある誤り

エラーが発生した場合は、まずHTTPの状態と返されたバージョンを確認してください error.message、error.code そしてリクエスト番号。 同じステータスコードが異なる段階から来ることがあり、根本原因は数字だけで確認できません。

共通状態

残高不足、利用できないモデル、未設定の価格設定などのビジネスエラーも読み取り、本文に戻すべきです。ステータスコードやフロントエンドのポップアップだけを見るだけでは不十分です。

429 必ずしも「求めすぎ」というわけではありません

429は特定のレイヤーがリクエストを制限していることを示しています。 現在、各資格は最大でも同時に処理可能です 2件の要請、モデル呼び出し周波数の限界は次の通りです。 毎分60拍； 上流にも独自のリソースと使用量の制限があります。

• concurrency_limit: 既存のリクエストが完了するまで次のリクエストを送信しないでください。 ストリームリクエストは終了するまで並行状態を維持します。
• 通常の周波数制限または上流429:尊重 Retry-After(可能であれば)リトライ回数を限定し、待ち時間を徐々に延長して即時の繰り返しリクエストを避けましょう。
• ページが直接表示するHTTPエラー429:ブラウザのページリクエストも制限されることがあります。 少し待ってからリフレッシュしてください。続く場合は、発生時刻と経路を管理者のものに残してください。

通常のテキスト問題が誤判された場合、リクエスト番号や必要な非機動性メモを提供してレビューすることが可能です。 利用可能な鍵、パスワード、または機密性の高い原文を送らないでください。

403 バウチャー付きの一時的な封印

content_policy_violation これは、このリクエストがサイトの利用制限を満たし、上流に送る前に却下されたことを示しています。

credential_temporarily_blocked 帰還 403、 と Retry-After 待機プロンプト:同じ認証情報が30分以内に複数回ルールに当たったら、30分間一時停止します。 関連コンテンツは停止し、回復を待ってください。キーを変えて試み続けるのはやめてください。 これは429の並行性や頻度制限とは異なります。

インターフェースアドレスとモデルの問題

基本URLは https://api.baiyun.si/v1、チャットの完全なアドレスは以下の通りです /v1/chat/completions、回答のアドレス: /v1/responses。 重複がないか確認してください /v1/v1、クライアントがこのサイトで開かれていないプロトコルを選択しているかどうかも含まれます。

モデル名は以下に関連付けられなければなりませんモデルスクエアおよび現在のキー /v1/models 一貫して返信し、実際の呼び出し名を置き換えるためにクライアント側の表示エイリアスを使用しないでください。

ストリーミングとコストの問題

チャットSSEは以下の通りです [DONE]； SSEはイベントの終了全文を読むべきです。 ネットワーク切断後の一部のテキストは完全な成功した応答とは見なされません。

投入パラメータと出力パラメータは、ハードコストキャップを保証するものではありません。 通常のリクエスト、上流入力後の障害、またはクライアントのキャンセルは実際の消費記録と照合する必要があります。 ローカルで拒否され、上流に出ずに拒否されたリクエストのみ、このモデルコールの料金はかかりません。

検査中に何が提供されますか?

1. 時間とタイムゾーン。
2. リクエスト番号、モデル名、インターフェースパス、HTTPステータス。
3. キーや機密コンテンツを削除した後にエラーメッセージが出ます。
4. 支払いに関する質問には、注文番号とステータスを記載し、決済商人のキーは提供しないでください。

局は依然として徐々に改善中であり、24時間体制の手動対応や固定処理時間の制限はまだ実施していません。

実用使用前のチェックリスト

1. ご自身のアカウントとアクセスキーを用意し、他人の共有資格情報は使わないでください。
2. トラブルシューティング時に簡単に再現できるよう、クライアントのバージョン、システム、モデルを記録します。
3. 元の設定やスクリーンショットを保存し、キー、検証コード、プライベートコンテンツを隠してください。
4. テストが1文と1つのリクエストから始まるDKを少量消費する可能性があることを確認してください。
5. 追加の機能を有効にするかどうか決める前に、現在のモデルプラザとステータスページを確認してください。

詳細な調査:問題の範囲を順に絞り込む

まず、口座が完全で、鍵が有効で、DK残高が十分であることを確認し、その後プロトコル、アドレス、モデルを確認します。 同じキーで最小限のテキストリクエストを行います。 成功して初めてアタッチメントやツールを復元したり、自動的に各アイテムを再挑戦します。 クライアント設定を保存した後、以前のベンダーを古いセッションで使わないようにセッションを再開してください。

このセクションが学習されたことを確認する方法

「設定が正常に保存されました」というプロンプトだけを確認しないでください。 現在のベースURL、キーの使用状況、選択したモデル、リクエストプロトコルを明確に表示でき、対応するコンソールで操作結果を検証できるはずです。 クライアント側のチュートリアルでは、最初の完了標準として単一の実際のプレーンテキスト応答と対応するログを使用します。 アカウントチュートリアルは包括的なセキュリティ情報に基づいています。 請求チュートリアルでは、プリンシパル、チャネル手数料、DKの対応関係を標準として使っています。

エラーが発生した場合は、発生時刻、HTTPステータス、匿名化されたエラーの内容、そして実際の期待結果を記録します。 ページキー全体をスクリーンショットで撮らず、パスワードや認証コードを他人に教えないでください。 401では認証を先に解決し、400ではパラメータを先に解決し、429では集中的な再試行を停止し、404ではリクエストパスと上流検証を検証する必要があります。充電ではすべてのエラーを解決することはできません。

練習にふさわしい小さな課題

このセクションの最低限の手順を自分のテスト環境で完了し、「最初にどのように設定したか、どの項目を修正したか、どのような結果を見たか」をテキストで記録してください。 本番データ、実際の支払い、回復不能なコマンドを演習として扱わないでください。 このセクション以上の機能に遭遇した場合は、機能追加を検討する前に対応するプロトコルチュートリアルを確認してください。 一度に一つの構成だけを変更することで、どの段階がエラーにつながるかを簡単に判断できます。

次のステップはバージョンの境界です

学習マップの完全な戻る · 効率的なAPIサイト構成 · このサイトのリアルタイム状況。

チュートリアルは2026年10月9日に作成されました。 具体的なインターフェースや機能はクライアントや上流バージョンによって異なります。 設定ガイドラインはすべてのクライアントバージョンがテストに合格したことを意味しません。 残高支払い、QQ/Alipayログイン、オープンチャネルについては、実際のページページをご覧ください。 圧縮インターフェース:以前は上流の404やRAW画像チャンネルが利用できなかったため、設定ファイルが自動的に削除できるとは限りません。