qianwen-model-selector

Qwen モデルセレクター（アドバイザー）

キー種別の検出

次のコマンドを実行して、API キーの種別を検出します（token-plan、payg、not-set のいずれかを出力します）。

python3 -c "
import os
from pathlib import Path
env_file = Path('.env')
if not env_file.exists():
    for parent in [Path.cwd()] + list(Path.cwd().parents):
        if (parent / '.git').exists() or (parent / 'skills').is_dir():
            env_file = parent / '.env'
            break
if env_file.exists():
    for line in env_file.read_text().splitlines():
        line = line.strip()
        if not line or line.startswith('#') or '=' not in line:
            continue
        k, v = line.split('=', 1)
        k, v = k.strip(), v.strip().strip('\"').strip(\"'\")
        if k in ('QIANWEN_API_KEY', 'DASHSCOPE_API_KEY') and k not in os.environ:
            os.environ[k] = v
key = os.environ.get('QIANWEN_API_KEY') or os.environ.get('DASHSCOPE_API_KEY') or ''
print('token-plan' if key.startswith('sk-sp-') else 'payg' if key else 'not-set')
"

出力	課金モード	アクション
token-plan	Token Plan（クレジット）	現在のToken Plan モデルカタログを取得し、その中からのみ選択してください。エディションが不明な場合は、デフォルトで Team の上位集合を使用します。CDN にアクセスできない場合は、ローカルの代替ファイルを使用してください。
payg	従量課金	モデルカタログ全体を利用できます。以下に進んでください。
not-set	キー未設定	処理を中断しないでください。 ユーザーに「どの方法を使う予定ですか？（1）標準の PAYG キー（2）Token Plan キー（3）今はスキップして、おすすめを確認するだけ」と尋ねてください。選択に応じて進めます。

Windows：python3 が利用できない場合は、python を使用してください。複数行の -c 文字列は、PowerShell と CMD のどちらでも動作します。または、スニペットを一時的な .py ファイルに保存して実行してください。

このスキルは、次の 2 つのモードで動作します。

1. 対話型アドバイザー — 診断の質問をして、適切なモデルをおすすめします（「診断フロー」を参照）。
2. スキル間の解決 — ユーザーとの対話なしでモデルを決定する必要がある実行スキル向けに、モデルをすばやく検索します。まずCDN のおすすめを取得してください。CDN にアクセスできない場合は、ローカルの代替ファイルを使用してください。

モデル名を捏造しないでください。CDN モデルカタログに記載されているモデル、または CLI が返すモデルのみをおすすめしてください。 このスキルは QianWen-AI/qianwen-ai の一部です。

スキルのディレクトリ

必要に応じて読み込んでください。モデルの一覧、デフォルト、またはおすすめが必要な場合は、ドキュメントに記載されている CDN モデルカタログを取得します。ユーザーから最新データを明示的に求められない限り、ほかの外部 URL を取得しないでください。

cdn/ 以下の各パスは、主要な情報源ではなくローカルの代替ファイルです。cdn/<path> については、まず https://alioth.alicdn.com/skills-info/models/<path> を取得し、その CDN リクエストに失敗した場合にのみローカルファイルを使用してください。

場所	用途
references/cli-usage.md	CLI 優先のデータ戦略：CLI を使うタイミング、3 ステップのログイン手順、表示ルール
references/error-handling.md	CLI エラーの分類と復旧手順（認証、見つからない場合、ネットワークなど）
CDN モデルのおすすめ	分野横断のおすすめと Token Plan の制約。利用できない場合は、ローカルの代替ファイルを使用してください
references/pricing-disclaimer.md	PAYG のみ：料金に関する免責事項（中国語／英語）とコンソールへのリンク
references/pricing.md	安定した課金単位、コストに関する注意事項、CDN 料金の代替情報
CDN モデルカタログ	分野横断のモデルカタログのスナップショット。利用できない場合は、ローカルの代替ファイルを使用してください
references/sources.md	公式ドキュメントの URL（手動での参照のみ）

前提条件

QianWen CLI の使用を強くおすすめします。モデルの利用可否、料金、クォータを確認するための、信頼できるリアルタイムデータソースです。次のコマンドで確認してください。

qianwen version

インストールされていない場合：

npm install -g @qianwenai/qianwen-cli

CLI には Node.js 18 以上が必要です。CLI がなくても、CDN カタログを参照して、特定時点での一般的なナビゲーションや基本的なモデル情報に関する質問には回答できます。ただし、現在の利用可否、正確な現在の料金、スナップショットの範囲を超える機能検索の結果、アカウント固有のクォータ情報は確認できません。

セキュリティと認証情報のモデル

QianWen には独立した認証情報システムが 2 つあります。混同しないでください。

認証情報	用途	指定方法
API キー（sk-... / sk-sp-...）	コードからモデル API を呼び出す	$DASHSCOPE_API_KEY / $QIANWEN_API_KEY 環境変数
CLI セッション	qianwen CLI サブコマンドを認証する	qianwen auth login（ブラウザーのデバイスフロー）

厳守事項（どちらのシステムにも適用されます）：

• 認証情報の値を平文で出力しないでください。 変数参照を使用し、状態（「設定済み」／「未設定」、「有効」／「無効」）のみを報告してください。.env ファイルや設定ファイルの内容を表示しないでください。
• 2 つのシステムを混同しないでください。 CLI が Not authenticated / AUTH_REQUIRED を返した場合は、3 ステップのデバイスフローログインを実行してください（cli-usage.md を参照）。ユーザーに API キーを尋ねないでください。また、CLI の認証を修正するために $DASHSCOPE_API_KEY を設定しようとしないでください。

データの参照順序

ユーザーの質問に適したデータソースを選んでください。上位のデータソースで復旧手順を試す前に、下位のデータソースへ切り替えないでください。

質問の種類	主なデータソース	備考
一般的なナビゲーション、または特定時点での基本的なモデルの詳細	CDN の推奨情報とドメインカタログ	回答する前に取得してください。CDN にアクセスできない場合は、対応するローカルのフォールバックを使用してください。最新性が重要な場合は、カタログデータがスナップショットであることを明記してください。
現在の情報／正確な情報／アカウント固有の情報（利用可否、料金、クォータ）	CLI を必ず使用してください — cli-usage.md を参照	スナップショットでは現在の状態を確認できません。数値をでっち上げないでください
機能による検索（「X を実行できるモデル」）	qianwen models search "<X>" --format json	スナップショットのキーワードの網羅性は不完全です
CLI がエラーを返した	error-handling.md の復旧手順を実行し、その後再試行	認証エラーの場合は 3 ステップのログインを実行し、スナップショットに切り替えないでください
CLI をまったく利用できず、ユーザーがインストールやログインを拒否した	CDN モデルカタログ + pricing.md	スナップショットで裏付けられる情報のみを回答し、データが古い可能性があることを注記してください。現在の利用可否、正確な現在の料金、アカウントのクォータについて断定しないでください
上記の方法で回答できず、ユーザーがオンライン検索を明示的に確認した場合	sources.md に記載の URL	先回りして取得しないでください

診断フロー（対話型アドバイス）

前提条件：上記のキー種別の検出を完了し、候補を絞り込んでから進めてください。CDN カタログから取得した推奨情報は、すべてユーザーの課金範囲内に収める必要があります。

次の順にユーザーに質問してください。

1. コンテンツの種類は？ — テキスト／画像／動画／音声／ビジョン
2. 主なタスクは？ — 生成／理解／コーディング／推論／翻訳
3. 優先事項は？ — 品質と速度とコストのどれを優先しますか？
4. 入力サイズは？ — 短い／中程度／長いコンテキスト
5. 構造化出力は必要ですか？ — JSON／関数呼び出しが必要ですか？

デフォルトの推奨事項

モデルを推奨する前に、公式の提供終了リスト（id、expiredTime）と、CLI の lifecycle 結果で、モデルの正確な ID を必ず確認してください。カタログやプランにまだ掲載されていても、提供終了が予定されているモデルや、すでに提供終了したモデルは、デフォルト設定や推奨対象から除外してください。ユーザーが明示的に選択した場合は、提供終了日と告知を伝え、サポート対象の代替モデルを提案し、黙って置き換えないでください。ライフサイクル情報を確認できない場合は、その旨を伝えてください。スナップショットだけでは、現在利用可能であることの証明にはなりません。

デフォルトモデルを選択したり、モデルを推奨したりする前に、上記でリンクされている最新の CDN 推奨事項を取得して読み込んでください。Token Plan キーの場合は、上記でリンクされている Token Plan のモデルカタログも読み込み、候補をそのカタログに掲載されているモデルに限定してください。

• ユーザーがモデルを明示的に指定した場合は、ユーザーの請求対象範囲で利用可能であることを確認してから使用してください。
• それ以外の場合は、最も強いタスクのシグナルを優先して照合し、適切な品質、速度、またはコストのティアを選択してください。
• 不足している要件によって選択が大きく変わる場合は、関連する分野の選択肢を比較して、ユーザーに確認してください。
• ユーザーまたはタスクが上書きを必要とする場合を除き、選択したモデルに記載されている思考のデフォルト設定を維持してください。単純なタスクに対して、一般的なデフォルトとして思考を有効にしないでください。

CLI クイックリファレンス

認証が必要です。 すべての models コマンドと usage コマンドには、有効なCLI セッション（ブラウザーのデバイスフローログイン。API キーではありません）が必要です。コマンドが Not authenticated / AUTH_REQUIRED を返した場合：

1. cli-usage.mdのデバイスフローログインを3ステップで実行してください（OS に適したコマンドで認証 URL を先に開き、その後すぐにポーリングしてください）。
2. success の後、元のコマンドを再実行してください。
3. $DASHSCOPE_API_KEY / $QIANWEN_API_KEY をユーザーに尋ねないでください。これらはモデル API の呼び出し用であり、CLI セッション用ではありません。上記のセキュリティと認証情報モデルを参照してください。
4. スナップショットに黙ってフォールバックしないでください。

Token Plan（sk-sp- キー）：有効な CLI セッションを確立すると（デバイスフローログイン）、qianwen usage コマンドは、ログイン中のアカウントについて、従量課金の使用状況と Token Plan のシート割り当て／共有パッケージのクレジットの両方を報告します。共有パッケージの購入、シート数の変更、または請求履歴全体の確認については、ユーザーをToken Plan のサブスクリプションコンソールに案内してください。Token Plan で利用可能なモデル（テキスト＋画像＋動画＋TTS）は、上記でリンクされている CDN の Token Plan モデルカタログに記載されています。

必要な情報	コマンド
モデルカタログ全体	qianwen models list --all --format json
モダリティで絞り込む	qianwen models list --input image --output text --format json
単一モデルの詳細	qianwen models info <model-id> --format json
キーワード検索	qianwen models search "<query>" --format json
無料ティアの残量	qianwen usage free-tier --format json
認証状態	qianwen auth status --format json

表示ルール：--format json の出力を解析し、人が読みやすい要約を表示してください。生の JSON をそのまま出力しないでください。--format text の出力はそのまま表示し、その後 --- に続けて分析を追加してください。詳細はcli-usage.mdを参照してください。

CLI のエラー処理 — クイックガイド

CLI が失敗した場合は、まず分類し、復旧してから再試行してください。スナップショットへのフォールバックを黙って行わないでください。

カテゴリ	復旧（概要）
auth-failure	3 ステップのログインを実行 → 元のコマンドを再試行します。ユーザーが拒否した場合に限り、フォールバックします。
not-installed	インストールコマンドを表示 → ユーザーにインストールを依頼 → 再試行します。スナップショットを黙って使用してはいけません。
model-not-found	qianwen models search "<keyword>" を実行 → 上位 3 件を提示 → 正しい ID で再試行します。
network-timeout	2 秒後に 1 回再試行します。2 回目も失敗した場合に限り、フォールバックするかユーザーに確認します。
quota-exhausted	Billing Console を表示します。スナップショットを使用してはいけません。
version-mismatch	qianwen version --check または更新確認スキルを提案 → アップグレード → 再試行します。
other	標準エラー出力をそのまま表示し、ドキュメントへのリンクを提示します。ユーザーがオプトアウトした場合に限り、フォールバックします。

分類の詳細、判定シグナル、フローの例については、error-handling.md を参照してください。

料金とコストの見積もり（PAYG のみ）

Token Plan の場合は、このセクションをスキップしてください。

• 最新の料金：まず qianwen models info <model> --format json を実行してください。pricing.md からリンクされている CDN の料金リファレンスは、フォールバックとしてのみ使用します。料金を捏造してはいけません。
• 必須の免責事項：コストに関する回答はすべて、pricing-disclaimer.md に記載された免責事項で必ず締めくくってください（ユーザーへの回答言語に合った中国語版または英語版を使用します）。免責事項を省略することは重大な失敗です。
• 無料枠：無料枠が利用可能だと決めつけてはいけません。qianwen usage free-tier を使って確認するか、ユーザーをコンソールに案内してください。
• 利用状況／請求に関する問い合わせ：適切なコンソールページをユーザーに案内してください。pricing-disclaimer.md の表を参照してください。

更新の確認

ユーザーから更新の確認を依頼された場合（「更新を確認」「バージョンを確認」「新しいバージョンはありますか」「スキルを更新」など）：

1. qianwen-update-check を探す：兄弟スキルのディレクトリ内で qianwen-update-check/SKILL.md を探します。
2. 見つかった場合 — 次を実行して、結果を報告します：python3 <qianwen-update-check-dir>/scripts/check_update.py --print-response ユーザーが強制確認を依頼した場合は、--force を使用します。
3. 見つからない場合 — qianwen version --check を実行して、結果を報告します。

アンチパターン

• モデル名を決してでっち上げないでください — CDN モデルカタログに記載されているか、CLI から返されたモデルのみを推奨してください。
• リクエストの文面から API キーの種類を決して推測しないでください — 設定済みのキーまたは呼び出し時のコンテキストを使用してください。
• ユーザーの課金対象範囲外のモデルを決して推奨しないでください — Token Plan キーには、上記のリンク先にある Token Plan モデルカタログのモデルのみを提示してください。PAYG キーでは、カタログ全体を使用できます。これに違反すると、ユーザーに重大なエラーが発生します。
• 価格を決してでっち上げたり推測したりしないでください — CLI、pricing.md、または公式料金ページのみを使用してください。価格の捏造は重大な失敗です。
• CLI でエラーが発生したときに、スナップショットへ黙ってフォールバックしないでください — まず error-handling.md の復旧手順を適用してください。
• 無料枠が利用できると決して決めつけないでください — クォータはすでに消費されている、期限切れになっている、または削除されている可能性があります。必ず有料の単価を先に提示してください。
• API キーを平文で決して出力しないでください —「セキュリティ」セクションを参照してください。
• CLI セッションと API キーを決して混同しないでください — CLI 認証ではブラウザーのデバイスフローログインを使用します。CLI の Not authenticated／AUTH_REQUIRED エラーの解決策として、$DASHSCOPE_API_KEY や $QIANWEN_API_KEY を決して提示しないでください。
• 任意の URL を先回りして取得したり、ウェブ検索を実行したりしないでください。 モデル情報が必要な場合は、記載されている CDN モデルカタログを取得してください。その他のオンラインソースへのアクセスは、CLI と CDN カタログでは回答できず、かつユーザーが承認した場合に限ります。
• 利用状況／課金／コンソールの URL を決して作成しないでください — このスキルまたはその参照資料に記載されている正確なリンクのみを使用してください。URL が記載されていない場合は、作成しないでください。
• 料金に関する回答には必ず免責事項を含めてください（pricing-disclaimer.md を参照）。

参照資料

ソース	用途
cli-usage.md	CLI 優先の方針、3 ステップのログイン、表示ルール、モデル詳細 URL
error-handling.md	CLI エラーの分類と復旧
qianwen-model-recommendations.md (CDN) (ローカルのフォールバック)	分野横断の推奨事項と Token Plan の制約
pricing-disclaimer.md	料金に関するガイダンス＋必須の免責事項＋課金コンソールのリンク
pricing.md	安定した課金単位、料金に関する注意事項、CDN 料金情報へのフォールバック
qianwen-model-list.md (CDN) (ローカルのフォールバック)	分野横断のモデルカタログのスナップショット
sources.md	公式ドキュメントの URL
qianwen models list --format json	動的：価格、機能、クォータを含む全モデルカタログ
qianwen models info <id> --format json	動的：単一モデルの詳細（料金区分、コンテキスト、レート制限）
qianwen models search "<q>" --format json	動的：キーワードベースのモデル検索
qianwen usage free-tier --format json	動的：モデルごとの残りの無料枠クォータ