Qwen 3.7 Plusは、Alibabaのマルチモーダルエージェントモデルです。テキスト、画像、動画を入力でき、100万トークンのコンテキストを持ち、手頃な価格で提供されます。APIとしてのみ提供されるため、実践的な疑問がすぐに生じます。キーの入手方法、画像の送信方法、そして費用はいくらか？ このガイドでは、これら3つの疑問すべてに答えます。
アクセス方法、キーの取得、Python、curl、JavaScriptでの最初のリクエスト、マルチモーダルペイロード形式、費用例を含む詳細な料金内訳、およびレート制限について説明します。この過程で、Apidogを使用してテストリクエストを実行し、生のレスポンスを検査し、エンドポイントをモックしてアプリが構築を続けられるようにします。最初に機能とベンチマークを知りたい場合は、Qwen 3.7 Plusの概要から始めてください。テキストのみの主力モデルについては、Qwen 3.7基本APIガイドをご覧ください。
ボタン
TL;DR (要点)
Qwen 3.7 Plusは、OpenAI互換のエンドポイントを介してAlibaba Cloud Model Studioで動作します。リージョンのベースURLを設定し、キーをBearerトークンとして渡し、モデルID qwen3.7-plus で /chat/completions を呼び出します。マルチモーダルリクエストは、メッセージコンテンツに画像または動画のパートを追加します。料金は入力トークン100万あたり$0.40、出力トークン100万あたり$1.60で、キャッシュされた入力は$0.08と、Qwen3.7-Maxの約6分の1の安さです。永続的な無料枠はありませんが、新規アカウントには1回限りの無料クォータが付与されます。ビジョントークンはコンテキスト予算を共有するため、画像や動画が料金に影響を与えます。出荷前にModel Studioのドキュメントで正確なモデルIDを確認してください。
Qwen 3.7 Plusへのアクセス方法
チャット専用のプレビュー版として初期段階を過ごしたテキスト主力モデルとは異なり、Plusは初日から商用APIとして提供されています。重要なポイントは2つあります。
Qwenチャット (chat.qwen.ai)。 画像を使ってPlusを試す最も速い方法です。サインインしてPlusモデルを選択し、スクリーンショットをドロップして、そのグラウンディング能力を確認します。これは評価用であり、統合用ではありません。
Alibaba Cloud Model Studio (DashScope)。 これが実際のAPIです。Model Studioは、OpenAI互換のエンドポイントを介してPlusを公開しているため、OpenAI SDKと連携する既存のコードは、ベースURLとキーを交換するだけで呼び出すことができます。
一つ計画すべき厳しい制限があります：Plusはプロプライエタリです。ダウンロードできるオープンウェイトはないため、セルフホストしたり、エアギャップ環境で実行したりすることはできません。それが要件である場合は、Qwen 3.7 Plusの概要で詳細を説明しています。
| 方法 | APIアクセス | 費用 | 最適 |
|---|---|---|---|
| Qwenチャット (chat.qwen.ai) | なし | 無料、レート制限あり | 画像を使った迅速な評価 |
| Model Studio (DashScope) | あり、OpenAI互換 | トークンごとの支払い | 本番環境での統合 |
| セルフホスティング | なし | 該当なし | 利用不可; ウェイトは非公開 |
Qwen 3.7 Plus APIキーの取得
アクセスはAlibaba Cloudアカウントを介して行われます。
- Alibaba Cloudアカウントを作成し、Model Studioコンソール (
modelstudio.console.alibabacloud.com) を開きます。 - お使いのアカウントとリージョンでModel Studioを有効にします。キーはリージョンごとにスコープ設定されているため、シンガポールのキーでは北京に対して認証できません。
- APIキーセクションを開き、キーを生成します。
sk-の後に文字列が続く形式です。 - 一度コピーし、パスワードのように安全に保管してください。
リージョンによってベースURLが設定されます。
| リージョン | ベースURL |
|---|---|
| シンガポール | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| 米国 (バージニア) | https://dashscope-us.aliyuncs.com/compatible-mode/v1 |
| 北京 (中国) | https://dashscope.aliyuncs.com/compatible-mode/v1 |
キーをソース管理に入れないでください。環境変数を使用してください。
# macOS / Linux
export DASHSCOPE_API_KEY="sk-your-key-here"
# Windows PowerShell
setx DASHSCOPE_API_KEY "sk-your-key-here"
最初の要求: Python、curl、JavaScript
エンドポイントはOpenAI互換であるため、DashScopeベースURLを指す公式のOpenAI SDKを使用することも、生のHTTP呼び出しを行うこともできます。モデルIDは qwen3.7-plus ですが、識別子が変更される可能性があるため、出荷前にModel Studioモデルリストで現在の文字列を確認してください。
OpenAI SDKを使用するPython
pip install openai でインストールした後、以下を実行します。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DASHSCOPE_API_KEY"],
base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)
resp = client.chat.completions.create(
model="qwen3.7-plus",
messages=[{"role": "user", "content": "Qwen 3.7 Plusの料金モデルを2つの文で要約してください。"}],
)
print(resp.choices[0].message.content)
curl
curl "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.7-plus",
"messages": [{"role": "user", "content": "Qwen 3.7 Plus APIからのこんにちは。"}]
}'
JavaScript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DASHSCOPE_API_KEY,
baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
});
const resp = await client.chat.completions.create({
model: "qwen3.7-plus",
messages: [{ role: "user", content: "Qwen 3.7 Plus APIからのこんにちは。" }],
});
console.log(resp.choices[0].message.content);
画像と動画の送信
PlusをMaxより優先する理由は、マルチモーダル入力にあります。OpenAI Vision APIが使用するのと同じ形式で、メッセージの content 配列に追加のパーツとして視覚コンテンツを渡します。
resp = client.chat.completions.create(
model="qwen3.7-plus",
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "このフォームを送信するボタンはどれですか？ピクセル座標を教えてください。"},
{"type": "image_url", "image_url": {"url": "https://example.com/screenshot.png"}},
],
}],
)
画像は公開URLまたはBase64データURIとして渡すことができます。動画も同じパターンで動画パーツとして渡されます。これがGUIグラウンディング動作を可能にします。Plusにスクリーンショットを渡すと、click at (x=487, y=232) のような構造化されたアクションが返されます。動画の正確なパーツ名はリージョンによって異なる場合があるため、現在のスキーマについてはOpenAI互換性ドキュメントを確認してください。
料金
Plusは予算に優しいマルチモーダルティアとして価格設定されています。テキスト主力モデルとの比較は次のとおりです。
| モデル | 入力 / 1M | 出力 / 1M | キャッシュ入力 / 1M |
|---|---|---|---|
| Qwen 3.7 Plus | $0.40 | $1.60 | $0.08 |
| Qwen 3.7 Max | $2.50 | $7.50 | $0.25 |
これは、Maxの入力に比べて約6分の1の安さです。永続的な無料枠はありませんが、新しいModel Studioアカウントには、課金が従量課金制に切り替わる前にモデルを評価するための1回限りの無料トークンクォータ（通常はシンガポールリージョンで）が付与されます。古いQwen OAuthの無料パスは2026年4月15日に廃止されたため、それに頼らないでください。公式の数値はModel Studio料金ページと無料クォータガイドに記載されています。より広範なファミリーを無料で試す方法については、Qwen 3.7を無料で利用する方法ガイドをご覧ください。
実際のリクエスト費用
テキストは安価です。画像や動画は、同じトークン単価と同じ1Mコンテキスト予算を共有するトークンに変換されるため、視覚コンテンツが料金を押し上げます。高解像度のスクリーンショットは数千トークンになる可能性があり、動画フレームは急速に積み上がります。
| リクエスト | 入力トークン | 出力トークン | おおよその費用 |
|---|---|---|---|
| テキストのみのプロンプト | 10,000 | 2,000 | ~$0.007 |
| 1080pスクリーンショット1枚 + プロンプト | ~1,500 | 300 | ~$0.001 |
| 30秒の動画を2 fpsでサンプリング | ~77,000 | 500 | ~$0.032 |
フレームあたりのトークン数は解像度とサンプリングレートに依存するため概算ですが、Plusでのテキストエージェントはほぼ無料であるのに対し、動画を多用するワークロードは1回の呼び出しあたり30倍以上の費用がかかる可能性があるという教訓は変わりません。スクリーンショットは縮小し、動画は控えめにサンプリングしてください。より広範なコスト戦略については、エージェントトークンコストを削減する方法に関するメモ、およびPlusがこの価格になった2026年の中国LLM価格競争をご覧ください。
レート制限とエラー
Model Studioは、アカウントごとのレート制限を1分あたりのリクエスト数と1分あたりのトークン数で強制し、その上限は公開されている単一の数値ではなく、アカウントのティアとリージョンによって異なります。現在の制限についてはコンソールのクォータページで確認し、上限に達した場合はそこで引き上げを申請してください。
よくある失敗に対処してください。
- 401 Unauthorized: キーが間違っているか、ベースURLに対して間違ったリージョンのキーを使用しています。
- 429 Too Many Requests: レート制限に達しました。指数関数的遅延でバックオフして再試行してください。
- 400 Bad Request: 通常、マルチモーダルペイロードの形式が間違っている、画像が大きすぎる、またはビジョントークンがカウントされた後にコンテキストがあふれています。
429と5xxのエラーに対しては、バックオフを伴うリトライで呼び出しをラップし、送信前に画像のサイズを検証してください。
ApidogでAPIをテストおよびモックする
マルチモーダルリクエストは間違いやすいものです。Base64エンコードされた画像を扱い、コンテンツ配列をネストし、構造化されたアクションプランを読み取ることがよくあり、これはターミナルで目視確認するにはすぐに飽きてしまいます。
Apidogは、そのための実際のワークスペースを提供します。画像と動画パーツを含むQwen 3.7 Plusリクエストを送信し、生のJSONレスポンスを検査し、環境ごとにModel Studioキーを保存してコードに貼り付ける必要がないようにし、プロンプトを調整しながらフロントエンドを構築できるようエンドポイントをモックします。PlusがGUIとCLIエージェント実行をまたいでツール呼び出しを連鎖させている場合、ApidogのAIエージェントデバッガーは、実行がどこで中断したかを見つけるために、シーケンス全体を表示します。
本番環境に接続する前に、Qwen 3.7 Plus APIをテスト、デバッグ、モックするためにApidogをダウンロードしてください。
FAQ
Qwen 3.7 Plus APIに無料枠はありますか？ 永続的な無料枠はありません。新しいAlibaba Cloud Model Studioアカウントには、通常シンガポールリージョンで、評価のために1回限りの無料トークンクォータが付与され、その後は従量課金制に移行します。
モデルIDは何ですか？ Model Studioでは qwen3.7-plus です。識別子は変更される可能性があるため、出荷前にModel Studioのモデルリストで現在の文字列を確認してください。
画像と動画の費用はどのように計算されますか？ 視覚コンテンツは、標準の入力料金で課金されるトークンに変換されます。1080pのスクリーンショットは数千トークンかかることがあり、動画はサンプリングされたフレームごとにトークンが追加されるため、大きなメディアペイロードが料金の大部分を占めます。
このAPIはQwen 3.7 Maxとどう違いますか？ OpenAI互換の形状とベースURLは同じです。Plusはメッセージコンテンツに画像と動画のパーツを受け入れ、費用は約6分の1です。Maxはテキスト専用で、純粋なテキストベンチマークではわずかに優位性があります。
Qwen 3.7 Plusをセルフホストできますか？ いいえ。ウェイトは非公開なので、Alibaba Cloud Model Studioを介してのみ実行されます。
どのベースURLを使用すべきですか？ キーを作成したリージョン（シンガポール、米国（バージニア）、北京）に一致するものです。キーは、異なるリージョンのエンドポイントに対して認証されません。
結論
Qwen 3.7 Plusを呼び出すには、OpenAI SDKのベースURLとキーを交換するだけで、視覚が必要な場合は画像または動画パーツを追加します。料金はテキストに対しては非常に安価であり、視覚ペイロードに応じて変動するため、API自体ではなく、どれだけのピクセルを送信するかが重要です。キーを取得し、最初のマルチモーダルリクエストを送信し、本番環境に接続する前にApidogでフロー全体をテストしてください。
ボタン