API統合チュートリアル

白雲APIチュートリアル:チャットテキストインターフェース

白雲SI編集チーム2026-10-09読むのに約7分

チャットコンプリートがSSEストリーミングと同期する例、プレーンテキストリクエスト。完全な検査手順、実務検証、エラー処理が含まれます。

チャットコンプリートのテキストインターフェース

インターフェースアドレス:POST https://api.baiyun.si/v1/chat/completions。

現在、OpenAIのチャットプロトコルを明示的にサポートするクライアント向けにチャットスタイルのプレーンテキスト会話が利用可能です。サイトキーの使用をリクエストし、この会話に必要な全文の文脈を提出してください。

リクエスト構造

{
  "model": "gpt-6-luna",
  "messages": [
    {"role": "system", "content": "用简洁的中文回答。"},
    {"role": "user", "content": "请解释什么是 Token。"}
  ],
  "stream": false
}

model これはこのサイトで実際に入手可能なモデルの名前です。messages テキストメッセージは順番通りに提出されていました。stream 同期返却かストリーミングかを決めてください。本記事ではオープンな基本テキスト構造のみを紹介します。複雑なSDKパラメータや拡張機能はデフォルトで利用できないべきです。

同期コール

curl --fail-with-body https://api.baiyun.si/v1/chat/completions \
  -H "Authorization: Bearer $BAIYUN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-6-luna","messages":[{"role":"user","content":"用一句话解释 Token。"}],"stream":false}'

生成されたテキストは以下の通りです。 choices[].message.content；用量情報はこちらにあります usage。具体的な内容、トークン数、手数料は、この時の実際の応答および消費記録に基づきます。

ストリームコール

curl --no-buffer --fail-with-body https://api.baiyun.si/v1/chat/completions \
  -H "Authorization: Bearer $BAIYUN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model":"gpt-6-luna",
    "messages":[{"role":"user","content":"用三句话介绍 Token。"}],
    "stream":true,
    "stream_options":{"include_usage":true}
  }'

SSEによるストリームリターン:read(読み) data: JSON、順番に連結してください choices[].delta.content。data: [DONE] 川の終点を示します。発足 include_usage 最後に記載された使用メッセージは、その後も保持しておく必要があります。すべてのSSEシャードを独立したHTTPレスポンスとして扱わないでください。

対話の文脈とパラメータ境界

現在のチャンネルはモデルのデフォルトのサンプリングを使用しています。temperature、top_p、frequency_penalty そして presence_penalty 現時点では調整可能な操作は提供されていません。クライアント側の一般的なデフォルト値は互換性処理によって除去され、モデルのサンプリング設定は変更されません。

複数のラウンドの対話が存在すべきです messages 必要な完全なテキスト履歴を提出してください。現在、外部ツール、ネットワーク、画像、ファイル機能は停止されており、チェックされていない外部履歴によるテキスト送信を回避する方法はありません。

モデルやクライアントによって出力パラメータのサポートは異なります。たとえ記入をお願いしても max_tokens、max_completion_tokens また、8192などの数値も含めてこのサイトが保証する固定された出力の長さやコスト制限とは見なせません。簡単なリクエストから始め、支出記録を確認し、自分に合った鍵の残高上限を設定しましょう。

同じバウチャーは最大でも同時に処理可能です 2件の要請；モデルコールは周波数によっても制限されています。 429に遭遇したら、待って押してください誤った記述原因を特定し、高周波ループの再試行を避けましょう。

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

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

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

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

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

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

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

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

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

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

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

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

コミュニティに戻って読み進めてください私の経験を共有します