VS Codeを開く前に必要なもの
VS Code用のQwen APIキーは、APIキーと拡張機能内の適切なエンドポイント設定だけです。まずこれら3つの値を準備してください。
- Base URL:
https://api.uncensoredqwen.com/v1 - モデルID:
uncensored - APIキーは、Googleまたはメールアドレスとパスワードでサインアップ後に、APIキーページで作成されます
新規アカウントは、そのページでワンクリックして$0.50のトライアルクレジットを付与できます。カードは不要で、1人1回限りの制限があり、7日間有効です。これは、数日間の実際のコーディングのためにエディター設定をテストするのに十分な量です。
命名に関する注記:このサービスは独立したプロバイダーが運営するホスト型のオープンウェイトモデルです。Alibabaの公式APIではなく、他のベンダーへのルーターでもありません。エディター内では、あなたが付けた表示名の下に表示されます。
まず curl でキーをテスト
エディター設定を変更する前に、キーとURLが単独で機能することを確認してください。これが失敗する場合、どの拡張機能もうまく動作せず、問題がプラグインではなくキーにあることがわかります。
export API_KEY="paste-your-key-here"
curl https://api.uncensoredqwen.com/v1/models \
-H "Authorization: Bearer $API_KEY"
uncensoredを含むJSONリストは、認証が機能していることを意味します。次に、実際の補完を1つ送信します。
curl https://api.uncensoredqwen.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python function that reverses a string."}],"max_tokens":200}'
レスポンスヘッダーにはX-Balance-USDが含まれており、ターミナルを離れることなく残高クレジットをすばやく確認できる方法です。
VS Code拡張機能にプロバイダーを追加
AIコーディング支援用のいくつかのVS Code拡張機能は、任意のOpenAI互換サーバーと通信できます。ラベルはツールによってわずかに異なりますが、フィールドは1対1で対応します。「OpenAI Compatible」、「カスタムBase URL付きのOpenAI」、または「カスタムエンドポイント」のような名前のプロバイダー選択を探してください。
| 拡張機能のフィールド | 入力する値 |
|---|---|
| プロバイダー | OpenAI互換(またはカスタムベースURL付きのOpenAI) |
| Base URL / APIベース | https://api.uncensoredqwen.com/v1 |
| API キー | アカウントのキー |
| モデル ID | uncensored |
JSON構成ファイルを読み取る拡張機能は、通常、このような形状のものを必要とします。正確なキー名は異なるため、拡張機能のドキュメントを確認し、フィールド名を適応させてください。
{
"models": [
{
"title": "Uncensored API",
"provider": "openai",
"model": "uncensored",
"apiBase": "https://api.uncensoredqwen.com/v1",
"apiKey": "paste-your-key-here"
}
]
}
このファイルはコミットしないでください。設定がリポジトリ内にある場合は、拡張機能のシークレットストレージまたは環境変数を使用し、構成パスを.gitignoreに追加してください。
保存後、拡張機能のチャットパネルを開き、ファイルを開いた状態で「この関数を説明してください」などの短いメッセージを送信します。ストリーミングされた回答が返れば、セットアップは完了です。
一般的な設定ミスを修正
失敗したセットアップのほとんどは、いくつかのタイプミスに起因します。このリストを順番に確認してください。
URLの形式が間違っている
ベースURLは/v1で終わります。拡張機能は/chat/completionsを自身で追加します。フルパスを貼り付けると、クライアントが/v1/chat/completions/chat/completionsをリクエストするため、404エラーになります。末尾のスラッシュは通常問題ありませんが、/v1の欠落は問題です。
モデル名が間違っている
一部の拡張機能は、別のサービスの名称でモデルドロップダウンを事前に入力します。それを小文字のuncensoredで正確に上書きしてください。フィールドがカスタム入力項目のないドロップダウンの場合、「カスタムモデル」または「その他」オプションを探してください。
キーに不要な文字が含まれている
Webページからのコピーでは、末尾にスペースや改行が付加されることがあります。プレーンテキストエディタに貼り付けてトリミングし、再度貼り付けてください。401レスポンスは、ほぼ間違いなくこれが原因か、異なるアカウントのキーであることを示しています。
拡張機能がデフォルトサーバーと通信し続けている
チャットリクエスト後に残高が変更されない場合、エディターが組み込みプロバイダーを使用している可能性があります。編集したモデルプロファイルがアクティブであることを確認し、設定変更後にウィンドウをリロードしてください。
429エラーでリクエストが失敗する
これはレート制限であり、次のセクションで説明します。エラーボディには、どの制限に到達したかを示すコードが含まれています。
リクエストが実際にAPIに到達しているか確認
エディターは、どのサーバーが応答したかを教えてくれることはめったにありません。疑念を解消するために、2つの簡単な確認を行います。
- 残高を確認してください。 ターミナルから
/v1/modelsまたは短い補完リクエストを実行し、X-Balance-USDヘッダーをメモし、エディターで3つのチャットメッセージを送信してから、ターミナル呼び出しを繰り返します。数字はわずかに減少するはずです。同じ数値はGET /v1/balanceからも取得できます。 - デフォルトの設定では拒否または異なる方法で処理されるものを要求します。 小さく無害なテストとして、正確に5語の返信を要求します。回答が指示に従い、かつストリーミングで配信されれば、接続は正常です。
残高が動かない場合は、拡張機能の出力パネルまたは開発者コンソールを開きます。ほとんどの拡張機能はリクエストURLとHTTPステータスをログに記録しており、間違ったホストはすぐにわかります。Base URLを修正し、ウィンドウをリロードしてもう一度お試しください。
リポジトリを共有するチームは、1つの共有値ではなく、各人に個別のキーを付与すべきです。これにより、1人のユーザーがレート制限に達しても他のユーザーがブロックされず、リークしたキーを他の人に影響を与えずに置き換えることができます。
自動補完、チャット、レート制限
チャットは制限に寛容です:メッセージごとに1つのリクエストです。インライン自動補完は異なります。多くの拡張機能は入力中の短い一時停止時にリクエストを送信するため、作業中に1分間に数十回の呼び出しが発生する可能性があります。
数字を理解しましょう。フルキーでは同時リクエスト8件、1分あたり300件のリクエストが許可されます。トライアルキーでは同時リクエスト2件、1分あたり60件です。これらを超えると、APIはHTTP 429とコードrate_limited(1分あたりの数が多すぎる)またはconcurrency(同時実行が多すぎる)を返します。一時的な過負荷時には、Retry-After: 5ヘッダー付きの429も返されます。ストリーミングされた補完はストリームが終了するまで並列スロットを保持するため、低速なストリームはより長くカウントされます。
役立つ実践的な設定:
- チャット、編集、説明のためにサービスを使用し、トライアルキー使用中はタブの自動補完をオフにするか、ディバウンス遅延を上げてください。
- 自動補完の最大出力トークンを数十個に下げます。短い補完はすぐに完了し、スロットを解放します。
- トライアル中は、同じキーに対して複数のエディターウィンドウを実行しないようにしてください。
失敗または拒否されたリクエストは課金されません。つまり、エラーが発生しても時間のみが消費され、コストはかかりません。
コーディングセッションのコスト
コーディング用のプロンプトは、拡張機能がファイルの内容を付加するため入力が重くなります。入力は1Mトークンあたり$0.15、出力は1Mトークンあたり$0.50で課金されます。コードとコンテキストを6,000トークン送信し、800トークンを取得するチャット1ターンを想定してください:
- 入力: 6,000 x $0.15 / 1,000,000 = $0.0009
- 出力: 800 x $0.50 / 1,000,000 = $0.0004
- 合計:ターンあたり$0.0013
1日の作業中にこのようなターンを100回実行すると、コストは$0.13になります。$0.50のトライアルクレジットでは、この規模のターンが約380回分($0.50 / $0.0013 は約385)カバーできます。クレジットは前払いで、期限切れすることはありません。チャージは$20から$500までの整数金額で行え、$50以上で5%、$100以上で10%、$200以上で15%のボーナスが付与されます。お支払い方法については料金ページをご覧ください。
コンテキストウィンドウは100,000トークン(プロンプトと補完の合計)です。拡張機能がリポジトリ全体を各プロンプトにインデックスする場合、大きなリクエストはより多くのコストを要し、その上限に近づきます。実際に必要なファイルにのみコンテキストを絞り込んでください。
プライバシーと詳細情報
プロンプトはトレーニングには使用されません。ただし、ソースコードにはシークレットが含まれることが多いため、チャットに添付するファイルから.envファイルや認証情報を除外してください。ほとんどの拡張機能では、コンテキストからパスを除外できます。
このモデルはテキストのみに対応しています。コーディングの質問に答え、関数の草案を作成し、エラーを説明し、ツール呼び出しとJSONモードをサポートしますが、画像、音声、動画は生成しません。このページ以外のリクエストフィールドや例については、APIドキュメントをお読みください。上記の確認後も問題が解決しない場合は、よくあるQwen APIのエラーの記事で、修正方法付きのエラーパターンをさらに確認してください。
