DEV Community

Cover image for Qwen 3.7 Plus API の使い方
Akira
Akira

Posted on • Originally published at apidog.com

Qwen 3.7 Plus API の使い方

Qwen 3.7 Plusは、Alibabaのマルチモーダルエージェントモデルです。テキスト、画像、動画を入力でき、100万トークンのコンテキストを持ち、手頃な価格で利用できます。APIとしてのみ提供されるため、実装時にまず確認すべきことは、APIキーの取得方法、画像・動画の送信方法、そして料金です。このガイドでは、Python、curl、JavaScriptで最初のリクエストを送信し、マルチモーダルペイロード、料金、レート制限、テスト方法までを実装目線で整理します。

今すぐApidogを試す

この記事では、アクセス方法、APIキーの取得、最初のリクエスト、画像・動画ペイロード、費用例、レート制限を扱います。途中で、Apidogを使ってテストリクエストを実行し、生のレスポンスを確認し、モックエンドポイントを作成する方法も紹介します。機能とベンチマークを先に確認したい場合は、Qwen 3.7 Plusの概要を参照してください。テキスト専用の主力モデルについては、Qwen 3.7基本APIガイドをご覧ください。

TL;DR

Qwen 3.7 Plusは、Alibaba Cloud Model StudioのOpenAI互換エンドポイントから利用します。

実装時の基本は次のとおりです。

  1. Alibaba Cloud Model StudioでAPIキーを作成する
  2. リージョンに合ったベースURLを選ぶ
  3. Authorization: Bearer <API_KEY> を付ける
  4. /chat/completions に model: "qwen3.7-plus" を指定する
  5. 画像・動画を使う場合は、messages[].content にマルチモーダルパーツを追加する

料金は入力100万トークンあたり $0.40、出力100万トークンあたり $1.60、キャッシュ入力100万トークンあたり $0.08 です。永続的な無料枠はありませんが、新規アカウントには1回限りの無料クォータが付与されます。

モデルIDや動画ペイロードの詳細は変更される可能性があるため、本番投入前にModel Studioの公式ドキュメントで確認してください。

Qwen 3.7 Plusへのアクセス方法

Qwen 3.7 Plusを試す方法は大きく2つあります。

Qwen 3.7 Plus

1. Qwenチャットで試す

chat.qwen.ai にサインインし、Plusモデルを選択すると、画像を使った簡単な評価ができます。

たとえば、スクリーンショットをアップロードして、UI上のボタン位置を認識できるか確認できます。

ただし、これは評価用です。アプリケーションに統合するAPIアクセスではありません。

2. Alibaba Cloud Model StudioでAPIを使う

本番統合にはAlibaba Cloud Model Studio、つまりDashScopeを使います。

Model StudioはOpenAI互換エンドポイントを提供しているため、既存のOpenAI SDK利用コードは、主に次の2点を変更するだけで流用できます。

  • base_url
  • api_key
方法 APIアクセス 費用 最適
Qwenチャット (chat.qwen.ai) なし 無料、レート制限あり 画像を使った迅速な評価
Model Studio / DashScope あり、OpenAI互換 トークンごとの支払い 本番環境での統合
セルフホスティング なし 該当なし 利用不可。ウェイトは非公開

注意点として、Qwen 3.7 Plusはプロプライエタリモデルです。オープンウェイトは提供されていないため、セルフホストやエアギャップ環境での実行はできません。詳細はQwen 3.7 Plusの概要で説明しています。

Qwen 3.7 Plus APIキーの取得

APIキーはAlibaba Cloud Model Studioから取得します。

手順は次のとおりです。

  1. Alibaba Cloudアカウントを作成する
  2. Model Studioコンソールを開く modelstudio.console.alibabacloud.com
  3. 利用するリージョンでModel Studioを有効化する
  4. APIキー管理画面を開く
  5. sk- で始まるAPIキーを生成する
  6. 生成直後にコピーし、安全に保存する

キーはリージョンごとにスコープ設定されます。たとえば、シンガポールリージョンで作成したキーは、北京リージョンのエンドポイントでは認証できません。

ベース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

APIキーはソースコードに直接書かず、環境変数で管理してください。

# macOS / Linux
export DASHSCOPE_API_KEY="sk-your-key-here"

# Windows PowerShell
setx DASHSCOPE_API_KEY "sk-your-key-here"
Enter fullscreen mode Exit fullscreen mode

最初のリクエストを送信する

エンドポイントはOpenAI互換です。OpenAI SDKを使う場合でも、生のHTTPリクエストを使う場合でも、基本的な構造は同じです。

モデルIDは qwen3.7-plus です。ただし、識別子は変更される可能性があるため、本番リリース前にModel Studioモデルリストで最新の値を確認してください。

Pythonで呼び出す

まずOpenAI SDKをインストールします。

pip install openai
Enter fullscreen mode Exit fullscreen mode

次に、DashScopeのベースURLを指定して呼び出します。

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)
Enter fullscreen mode Exit fullscreen mode

curlで呼び出す

SDKを使わずにHTTPで確認したい場合は、次のように送信します。

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からのこんにちは。"
      }
    ]
  }'
Enter fullscreen mode Exit fullscreen mode

JavaScriptで呼び出す

Node.jsではOpenAI SDKをそのまま利用できます。

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);
Enter fullscreen mode Exit fullscreen mode

画像を送信する

Qwen 3.7 Plusを使う主な理由は、マルチモーダル入力です。

画像は、OpenAI Vision APIと同様に、messages[].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"
                    }
                },
            ],
        }
    ],
)

print(resp.choices[0].message.content)
Enter fullscreen mode Exit fullscreen mode

画像は次の形式で渡せます。

  • 公開URL
  • Base64データURI

Base64で送る場合は、概念的には次のような形式になります。

{
  "type": "image_url",
  "image_url": {
    "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
  }
}
Enter fullscreen mode Exit fullscreen mode

Qwen 3.7 PlusはGUIグラウンディング用途にも使えます。たとえばスクリーンショットを渡すと、次のようなアクション指示を返すケースがあります。

click at (x=487, y=232)
Enter fullscreen mode Exit fullscreen mode

動画を送信する

動画も同様に、メッセージのコンテンツ配列に動画パーツとして渡します。

ただし、動画の正確なパーツ名やスキーマはリージョンや互換モードの仕様によって異なる場合があります。実装前にOpenAI互換性ドキュメントで現在の形式を確認してください。

実装時は、動画全体をそのまま送るのではなく、次のように前処理することを検討してください。

  • 必要な区間だけ切り出す
  • FPSを下げてサンプリングする
  • 解像度を落とす
  • 重要フレームだけ抽出する

動画はフレーム数が増えるほど入力トークンが増え、料金にも直接影響します。

料金

Qwen 3.7 Plusは、低価格なマルチモーダルティアとして価格設定されています。

モデル 入力 / 100万トークン 出力 / 100万トークン キャッシュ入力 / 100万トークン
Qwen 3.7 Plus $0.40 $1.60 $0.08
Qwen 3.7 Max $2.50 $7.50 $0.25

入力料金だけを見ると、PlusはMaxの約6分の1です。

永続的な無料枠はありません。ただし、新しいModel Studioアカウントには、課金が従量課金制に切り替わる前に評価用の1回限りの無料トークンクォータが付与されます。通常はシンガポールリージョンで提供されます。

古いQwen OAuthの無料パスは2026年4月15日に廃止されたため、それに依存しないでください。

公式の数値は次のページで確認できます。

より広範なQwenファミリーを無料で試す方法については、Qwen 3.7を無料で利用する方法ガイドも参照してください。

リクエスト費用の目安

テキストのみのリクエストは非常に安価です。一方、画像や動画はトークンに変換され、同じ入力料金で課金されます。

リクエスト 入力トークン 出力トークン おおよその費用
テキストのみのプロンプト 10,000 2,000 約 $0.007
1080pスクリーンショット1枚 + プロンプト 約1,500 300 約 $0.001
30秒の動画を2fpsでサンプリング 約77,000 500 約 $0.032

フレームあたりのトークン数は解像度とサンプリングレートに依存します。実装時は、次の対策でコストを抑えられます。

  • スクリーンショットを縮小する
  • 不要な余白をクロップする
  • 動画のFPSを下げる
  • 必要な場面だけ送る
  • キャッシュ可能な入力を活用する

より広範なコスト削減戦略については、エージェントトークンコストを削減する方法と、Plusがこの価格帯になった背景である2026年の中国LLM価格競争も参考になります。

レート制限とエラー処理

Model Studioは、アカウントごとにレート制限を適用します。

主な制限は次の2種類です。

  • 1分あたりのリクエスト数
  • 1分あたりのトークン数

上限はアカウントのティアやリージョンによって異なります。現在の制限はModel Studioコンソールのクォータページで確認し、必要に応じて引き上げを申請してください。

よくあるエラー

401 Unauthorized

原因の例:

  • APIキーが間違っている
  • キーとベースURLのリージョンが一致していない
  • Authorization: Bearer ... が付いていない

確認すること:

echo $DASHSCOPE_API_KEY
Enter fullscreen mode Exit fullscreen mode

また、キーを作成したリージョンとベースURLが一致しているか確認してください。

429 Too Many Requests

レート制限に達しています。

対策:

  • 指数バックオフでリトライする
  • 並列数を下げる
  • 入力トークン数を削減する
  • クォータ引き上げを申請する

簡単なリトライ方針の例です。

import time

for attempt in range(5):
    try:
        resp = client.chat.completions.create(
            model="qwen3.7-plus",
            messages=[{"role": "user", "content": "こんにちは"}],
        )
        break
    except Exception as e:
        wait = 2 ** attempt
        time.sleep(wait)
Enter fullscreen mode Exit fullscreen mode

400 Bad Request

原因の例:

  • マルチモーダルペイロードの形式が間違っている
  • 画像が大きすぎる
  • 動画フレームが多すぎる
  • ビジョントークンを含めた結果、コンテキスト長を超えている

対策:

  • content が配列になっているか確認する
  • type とネスト構造を確認する
  • 画像を縮小する
  • 動画のサンプリング数を減らす

ApidogでAPIをテストおよびモックする

マルチモーダルリクエストは、ターミナルだけで検証するとミスを見落としやすくなります。

特に次の点は、GUIで確認した方が効率的です。

  • Base64画像の扱い
  • messages[].content のネスト構造
  • 生のJSONレスポンス
  • GUIグラウンディングの座標出力
  • エラー時のレスポンスボディ
  • 環境ごとのAPIキー切り替え

Apidog

Apidogを使うと、Qwen 3.7 Plusのリクエストをワークスペース上で作成し、画像・動画パーツを含むペイロードを送信できます。

実装前の確認手順は次のとおりです。

  1. Apidogで新しいリクエストを作成する
  2. Methodを POST にする
  3. URLに /chat/completions を指定する
  4. 環境変数にModel StudioのAPIキーを保存する
  5. Authorization: Bearer {{DASHSCOPE_API_KEY}} を設定する
  6. JSON Bodyに model と messages を指定する
  7. レスポンスのJSONを確認する
  8. 必要に応じてモックエンドポイントを作成する

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のスクリーンショットは数千トークンになる可能性があります。動画はサンプリングされたフレームごとにトークンが追加されるため、大きなメディアペイロードが料金の大部分を占めることがあります。

Qwen 3.7 PlusはQwen 3.7 Maxと何が違いますか？

OpenAI互換のAPI形状とベースURLは同じです。

主な違いは次のとおりです。

  • Plusは画像と動画のマルチモーダル入力に対応
  • PlusはMaxより低価格
  • Maxはテキスト専用
  • Maxは純粋なテキストベンチマークでわずかに優位性がある

Qwen 3.7 Plusをセルフホストできますか？

できません。

Qwen 3.7 Plusのウェイトは非公開です。Alibaba Cloud Model Studio経由でのみ実行できます。

どのベースURLを使用すべきですか？

APIキーを作成したリージョンに一致するベースURLを使用してください。

  • シンガポール: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • 米国 / バージニア: https://dashscope-us.aliyuncs.com/compatible-mode/v1
  • 北京 / 中国: https://dashscope.aliyuncs.com/compatible-mode/v1

異なるリージョンのキーとエンドポイントを組み合わせると、認証に失敗します。

結論

Qwen 3.7 Plusを呼び出すには、OpenAI SDKのベースURLとAPIキーをDashScope向けに差し替え、必要に応じて画像または動画パーツを messages[].content に追加します。

テキスト入力は非常に安価ですが、画像や動画はトークンに変換されるため、送信するピクセル量とフレーム数がコストに直結します。

実装の流れは次のとおりです。

  1. Model StudioでAPIキーを取得する
  2. リージョンに合ったベースURLを設定する
  3. Python、curl、JavaScriptで疎通確認する
  4. 画像・動画ペイロードを追加する
  5. 料金とレート制限を確認する
  6. 本番接続前にApidogでテスト、デバッグ、モックする

Top comments (0)