白雲APIチュートリアル:すぐに始めましょう
ログイン、入金、鍵作成から最初の平文APIリクエストまで。 完全な検査手順、実務検証、エラー処理が含まれます。
始めましょう
このページでは、ウェブサイトチャットやAPIコールからサイトの利用を始めるのに役立ちます。 現在のサービス範囲は以下の通りです:完全で検証可能な平文要求。
ウェブサイトで体験してください
- このサイトのアカウントに登録またはログインしてください。
- 開けて財布Doken(WordKnife、DK)の金額と実際のRMBの支払い額を確認した後、AlipayまたはWeChatでチャージしてください。 現在の単価は0.30元/DKです。
- 開けてチャット体験オープンモデルを選択し、まず短い普通のテキスト質問を送信します。
- 存在するコントロールコンソール使用量と消費履歴を閲覧できます。
現在、消費はバランスに基づいており、会員登録は必要ありません。 充電や試合を終了する前に必ずお読みください使用ルール。
アプリケーション用のコールキーを作成します
存在するキー管理モデルコール用のAPIキーを作成すること; 実際のニーズに応じてバランスやモデルの上限を設定し、貯蓄後に適切に保管しましょう。
このアプリはモデルコールキーウェブログインパスワードではありません。 公開コード、スクリーンショット、チャットコンテンツ、ブラウザでアクセス可能なフロントエンドコードにキーを書き込まないでください。 漏洩した鍵は取り消し、鍵管理で再作成すべきです。
クライアントの設定
| 構成項目 | 現在のコンテンツ |
|---|---|
| API Base URL | https://api.baiyun.si/v1 |
| API Key | サイトのキー管理によって作成されたコールキー |
| モデル | 例えば、gpt-6-luna; 正確なリストについてはモデル・スクエアを参照してください |
| インターフェース | チャットの完了や返信のためのテキストモード |
クライアントによってアドレスの定義は異なります:入力してください Base URL 通常はその時点で保持される /v1； チャットの全アドレスを記入する必要がある場合は、ぜひ記入してください https://api.baiyun.si/v1/chat/completions。 しまわないで /v1 継ぎ目を2回繰り返します。 すべてのクライアント、プラグイン、機能がデフォルトで互換性があるわけではありません。
最初のAPIリクエスト
キー入力時に共有端末や録画画面に入らないように、ローカル端末の環境変数を設定してください:
read -r -s -p '请输入本站 API 密钥：' BAIYUN_API_KEY
printf '\n'
export BAIYUN_API_KEY
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": "你好，请用一句话介绍你能帮我做什么。"}],
"stream": false
}'リクエストが成功すると、生成されたテキストおよび使用情報が返され、DK残高は表示された参照単価から差し引かれます。 1 DKは、選択された商業APIの参照見積もりに基づいて1 USDで価格が設定されたトークンのバッチであり、固定トークン数や米ドルに換算可能な現金ではありません。 上記の通常のリクエストも少量の消費を生み出します。
現在の0.30元/DKはこのサイトのリチャージ価格であり、実際のテストで証明された正確なサブスクリプション料金ではありません。 同じトークンの参照価値およびサブスクリプションコストは、人民元または円の換算で示されています三段階の請求指示。
出力を継続的に受信したいなら、確認してくださいチャットストリーミングの例； Responsesを使うと、アプリはそれを閲覧できます回答の例。
呼び出せるモデルを確認してください
モデルリストインターフェースには鍵認証も必要です:
curl --fail-with-body https://api.baiyun.si/v1/models \
-H "Authorization: Bearer $BAIYUN_API_KEY"実際に現在の鍵を返すモデルが優先されます。 モデルが存在しないか利用できない場合は、モデル名、キーリミット、バランスを確認し、サポートされていないリクエストを繰り返し再試行しないでください。
実用使用前のチェックリスト
- ご自身のアカウントとアクセスキーを用意し、他人の共有資格情報は使わないでください。
- トラブルシューティング時に簡単に再現できるよう、クライアントのバージョン、システム、モデルを記録します。
- 元の設定やスクリーンショットを保存し、キー、検証コード、プライベートコンテンツを隠してください。
- テストが1文と1つのリクエストから始まるDKを少量消費する可能性があることを確認してください。
- 追加の機能を有効にするかどうか決める前に、現在のモデルプラザとステータスページを確認してください。
詳細な調査:問題の範囲を順に絞り込む
まず、口座が完全で、鍵が有効で、DK残高が十分であることを確認し、その後プロトコル、アドレス、モデルを確認します。 同じキーで最小限のテキストリクエストを行います。 成功して初めてアタッチメントやツールを復元したり、自動的に各アイテムを再挑戦します。 クライアント設定を保存した後、以前のベンダーを古いセッションで使わないようにセッションを再開してください。
このセクションが学習されたことを確認する方法
「設定が正常に保存されました」というプロンプトだけを確認しないでください。 現在のベースURL、キーの使用状況、選択したモデル、リクエストプロトコルを明確に表示でき、対応するコンソールで操作結果を検証できるはずです。 クライアント側のチュートリアルでは、最初の完了標準として単一の実際のプレーンテキスト応答と対応するログを使用します。 アカウントチュートリアルは包括的なセキュリティ情報に基づいています。 請求チュートリアルでは、プリンシパル、チャネル手数料、DKの対応関係を標準として使っています。
エラーが発生した場合は、発生時刻、HTTPステータス、匿名化されたエラーの内容、そして実際の期待結果を記録します。 ページキー全体をスクリーンショットで撮らず、パスワードや認証コードを他人に教えないでください。 401では認証を先に解決し、400ではパラメータを先に解決し、429では集中的な再試行を停止し、404ではリクエストパスと上流検証を検証する必要があります。充電ではすべてのエラーを解決することはできません。
練習にふさわしい小さな課題
このセクションの最低限の手順を自分のテスト環境で完了し、「最初にどのように設定したか、どの項目を修正したか、どのような結果を見たか」をテキストで記録してください。 本番データ、実際の支払い、回復不能なコマンドを演習として扱わないでください。 このセクション以上の機能に遭遇した場合は、機能追加を検討する前に対応するプロトコルチュートリアルを確認してください。 一度に一つの構成だけを変更することで、どの段階がエラーにつながるかを簡単に判断できます。
次のステップはバージョンの境界です
学習マップの完全な戻る · 効率的なAPIサイト構成 · このサイトのリアルタイム状況。
チュートリアルは2026年10月9日に作成されました。 具体的なインターフェースや機能はクライアントや上流バージョンによって異なります。 設定ガイドラインはすべてのクライアントバージョンがテストに合格したことを意味しません。 残高支払い、QQ/Alipayログイン、オープンチャネルについては、実際のページページをご覧ください。 圧縮インターフェース:以前は上流の404やRAW画像チャンネルが利用できなかったため、設定ファイルが自動的に削除できるとは限りません。