API統合チュートリアル

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

白雲SI編集チーム2026-10-09読書に約6分

Responses 同步与 SSE 流式文本请求及完整上下文说明。附完整检查步骤、实操验证和错误处理。

Responses 文本接口

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

适合明确支持 Responses 协议的应用。当前可使用同步和 SSE 流式文本请求；完整接口的工具、文件、图像等扩展功能暂未开放。

同步文本请求

curl --fail-with-body https://api.baiyun.si/v1/responses \
  -H "Authorization: Bearer $BAIYUN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model":"gpt-6-luna",
    "input":"请用一句话介绍你能帮我做什么。",
    "stream":false
  }'

响应中的 output 数组包含输出项。读取消息项 content 中 type 为 output_text 的 text 字段，并保留 usage 用量信息。不要假设原始 REST JSON 一定存在 SDK 提供的便利字段 output_text。

SSE 流式请求

curl --no-buffer --fail-with-body https://api.baiyun.si/v1/responses \
  -H "Authorization: Bearer $BAIYUN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-6-luna","input":"请写两句普通的问候语。","stream":true}'

按 SSE 事件类型解析：response.output_text.delta 提供文本增量；完整结束时应收到 response.completed。流未完成、出现失败事件或网络中断时，不应把已经显示的部分内容当成完整响应。

提交完整文本历史

{
  "model": "gpt-6-luna",
  "instructions": "用中文简短回答。",
  "input": [
    {"role": "user", "content": "什么是 Token？"},
    {"role": "assistant", "content": "Token 是模型处理文本时使用的计量单位。"},
    {"role": "user", "content": "它与字数完全相同吗？"}
  ],
  "stream": false
}

当前应把必要上下文以文本随本次请求提交。引用上游会话的 previous_response_id、外部历史、工具调用或不可检查的媒体载荷暂不开放。

使用前核对

先通过带 Bearer 鉴权的 /v1/models 核对实际模型名称。
当前仅开放文本模式，不支持任意 Responses 扩展字段或 SDK 自动附加的工具功能。
max_output_tokens 等参数不是已保证的输出或费用硬上限；按实际用量和消费记录核对费用。
每凭据最多 2 个并发请求；遇限流先等待，避免自动无限重试。

完整政策和暂未开放范围见本站使用规则；Chat 客户端查看Chat 文本接口。

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

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

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

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

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

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

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

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

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

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

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

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

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