API統合チュートリアル

白雲APIチュートリアル:Python、Node.js、そしてLangChain

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

サーバーサイド環境変数、Responses/Chat SDKの最小限の例と再試行。完全な検査手順、実務検証、エラー処理が含まれます。

Python、Node.js、そしてLangChain

サーバーが鍵を保存します

キーはプロセス環境変数を通過します BAIYUN_API_KEY 読んでみて。ブラウザのウェブページやモバイルアプリには共有キーが内蔵されてはなりません。リクエストを送るためには、自分でバックエンド認証とクォータを持つ必要があります。デプロイメント前に、ログにリクエストヘッダーや環境変数が印刷されているかを確認してください。

Python

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["BAIYUN_API_KEY"],
                base_url="https://api.baiyun.si/v1",
                timeout=120.0, max_retries=0)
response = client.responses.create(model="gpt-6-luna",
                                   input="用一句话说明 Token 是什么。")
print(response.output_text)

output_text SDKが提供する利便性が問題です。 REST JSONを直接解析する際は、それをトラバースする必要があります output メッセージ項目内のテキストフィールド。依存関係は隔離された環境にインストールし、プロジェクトのロックファイルは保持すべきです。テストのためだけに本番プロジェクト全体をアップグレードしないでください。

Node.js

import OpenAI from 'openai';
const client = new OpenAI({
  apiKey: process.env.BAIYUN_API_KEY,
  baseURL: 'https://api.baiyun.si/v1',
  maxRetries: 0,
  timeout: 120000,
});
const stream = await client.chat.completions.create({
  model: 'gpt-6-luna', stream: true,
  messages: [{role: 'user', content: '你好'}],
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

LangChain

OpenAI互換アドレスをサポートするモデルアダプターを使用し、APIキー、ベースURL、モデルを現在のバージョンで設定してください。まずプレーンテキストを呼び出し、その後リンク、検索、ツールを追加します。フレームワークによって自動的に追加される追加パラメータは、サイトのオープンスコープに準拠しなければなりません;フレームワーク名を互換性の保証とみなさないでください。

ミスと再挑戦

まず、HTTP状態、SDK解析エラー、ビジネスリターンエラーを区別します。生成割り込みはすでにお金を消費している場合があります;自動で無限にやり直すわけではありません。 429 指示通り撤退、401 修理資格、400 修理パラメータ。接続タイムアウトになったら、再試行の判断前にステータスページとネットワークを確認してください。

公式Python SDKプロジェクト · 公式Node SDKプロジェクト · 公式のLangChainドキュメント

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

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

詳細なトラブルシューティング:リクエストの問題とコードの問題を分けています

まず、同じキーとモデルで最小カールを実行し、その後SDKの実際のアドレス、リクエストプロトコル、パラメータを比較します。 curlが成功してもSDKが失敗した場合は、プロキシ環境、SDKの自動再試行、タイムアウト、追加フィールドのトラブルシューティングをしてください。エラーログにAuthorizationを印刷しないでください。デプロイ中のキーはフロントエンドのビルド変数に書き込むことはできません。

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

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

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

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

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

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

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

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

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