すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Model Studio:Web エクストラクター

最終更新日:Nov 16, 2026

LLM は Web ページのデータに直接アクセスできません。Web エクストラクターは URL にアクセスし、そのコンテンツを抽出してモデルに提供します。

使用方法

Web エクストラクターは 4 つの方法で呼び出すことができます。必要なパラメーターは方法ごとに異なります:

OpenAI 互換 - レスポンス API

web_search と web_extractor を tools パラメーターに追加します。

数学やデータ分析の問題について精度をさらに高めるには、code_interpreter ツールも有効にしてください。

# 依存関係をインポートしてクライアントを作成します...
response = client.responses.create(
    model="qwen4-max",
    input="Please visit the official Alibaba Cloud Model Studio documentation for the code interpreter and summarize its main content",
    tools=[
        # Web 抽出を有効にするには、Web 検索ツールも有効にします
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    extra_body={
      # 思考モードを有効にする必要があります
      "enable_thinking": True
    }
)

print(response.output_text)

Anthropic 互換

tools に名前が web_fetch のツールを追加し、同じリクエストに名前が web_search のツールも追加します。エンドポイントは https://{WorkspaceId}.{region}.maas.aliyuncs.com/apps/anthropic です。

Claude Code などの Anthropic 公式クライアントでは、自然言語の質問から抽出を実行でき、追加設定は不要です。Anthropic SDK または HTTP で直接呼び出す場合は、system にクライアント識別子 x-anthropic-billing-header: cc_entrypoint=cli; を指定する必要があります。指定しない場合、抽出は機能しません。

type の日付サフィックスはクライアントのバージョンによって決まります。サーバーはツールのカテゴリを識別し、日付サフィックスを検証しないため、クライアントが実際に送信する値を使用してください。検索ツールを追加せずに抽出ツールだけを指定すると、InvalidParameter エラー The web_extractor tool must be executed with web_search tool. が返されます。

kimi-k3.1-pro もこの機能をサポートします。

以下は Anthropic クライアントを初期化した後の呼び出しコードです。初期化については Anthropic Messages API を参照してください。スナップショットを呼び出す場合は、model を deepseek-v4.1-flash-1017 に設定します。

# Import dependencies and create the client...
message = client.messages.create(
    model="qwen4-max",
    max_tokens=4096,
    # Pass the client identifier
    system=[{"type": "text", "text": "x-anthropic-billing-header: cc_entrypoint=cli;"}],
    messages=[{"role": "user", "content": "Read the Alibaba Cloud Model Studio code interpreter documentation and summarize the key points."}],
    tools=[
        # Enabling the web extractor requires the web search tool as well
        # The date suffix in type depends on the client version. The values below are the ones current Claude Code sends.
        {"type": "web_search_20250305", "name": "web_search", "max_uses": 5},
        {"type": "web_fetch_20250910", "name": "web_fetch", "max_uses": 5}
    ]
)

抽出リクエストと結果は、それぞれ server_tool_use と web_fetch_tool_result コンテンツブロックとして返されます。抽出回数は usage.server_tool_use.web_fetch_requests に記録されます。

対応モデル

deepseek-v4.1-flash-1017 は、モデルページに記載された全 6 リージョンと対応するデプロイ範囲で、Responses API の組み込み web_extractor ツールと Anthropic 互換 API の組み込み web_fetch ツールをサポートします。

kimi-k3.1-pro (Alibaba Cloud Model Studio にデプロイ) は、北京、シンガポール、米国 (バージニア)、ドイツ (フランクフルト)、日本 (東京)、中国 (香港) で、Responses API の組み込み web_extractor ツールと Anthropic 互換 API の web_fetch をサポートします。

推奨モデル

レスポンス API

Qwen-Max:qwen4-max 、Qwen3.8-Max シリーズ、Qwen3.7-Max シリーズ

Qwen-Plus:Qwen3.7-Plus シリーズ、Qwen3.6-Plus シリーズ、Qwen3.5-Plus シリーズ

DeepSeek:deepseek-v4-flash-0731、deepseek-v4-pro

GLM:glm-5.2

Qwen3.8 open-source シリーズ

その他のモデル

以下のモデルもこのツールをサポートしていますが、推奨モデルほどの性能が得られない場合があります。レスポンス API 経由でのみサポートされます。

  • Qwen-Flash:Qwen3.7-Flash シリーズ、Qwen3.6-Flash シリーズ、Qwen3.5-Flash シリーズ
  • Qwen3.6 open-source シリーズ (qwen3.6-27b を除く)
  • Qwen3.5 open-source シリーズ

クイックスタート

この例では、レスポンス API を使用して Web エクストラクターを呼び出し、技術ドキュメントを要約します。

API キーを取得し、環境変数として設定する必要があります。

import os
from openai import OpenAI

client = OpenAI(
    # 環境変数が設定されていない場合は、次の行を api_key="sk-xxx" (非推奨) に置き換え、Model Studio の API キーを使用してください。
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # Singapore リージョン。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
)

response = client.responses.create(
    model="qwen4-max",
    input="Please visit the official Alibaba Cloud Model Studio documentation for the code interpreter and summarize its main content",
    tools=[
        {
            "type": "web_search"
        },
        {
            "type": "web_extractor"
        },
        {
            "type": "code_interpreter"
        }
    ],
    extra_body = {
        "enable_thinking": True
    }
)
# 中間プロセスの出力を表示するには、次の行のコメントを解除します
# print(response.output)
print("="*20+"Response Content"+"="*20)
print(response.output_text)
# ツール呼び出し回数を出力します
usage = getattr(response, "tool_usage", {})
print("="*20+"Tool Call Count"+"="*20)
if usage:
    print(f"\nWeb extraction count: {usage.get('web_extractor', {}).get('num_requests')}")
import OpenAI from "openai";
import process from 'process';

const openai = new OpenAI({
    // 環境変数が設定されていない場合は、次の行を apiKey: "sk-xxx" に置き換え、Model Studio の API キーを使用してください。
    apiKey: process.env.DASHSCOPE_API_KEY,
    // Singapore リージョン。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
    baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
});

async function main() {
    const response = await openai.responses.create({
        model: "qwen4-max",
        input: "Please visit the official Alibaba Cloud Model Studio documentation for the code interpreter and summarize its main content",
        tools: [
            { type: "web_search" },
            { type: "web_extractor" },
            { type: "code_interpreter" }
        ],
        enable_thinking: true
    });

    console.log("====================Response Content====================");
    console.log(response.output_text);

    // ツール呼び出し回数を出力します
    console.log("====================Tool Call Count====================");
    if (response.tool_usage) {
        console.log(`Web extraction count: ${response.tool_usage.web_extractor?.num_requests}`);
        console.log(`Web search count: ${response.tool_usage.web_search?.num_requests}`);
    }
    // 中間プロセスの出力を表示するには、次の行のコメントを解除します
    // console.log(JSON.stringify(response.output[0], null, 2));
}

main();
# Singapore リージョン。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/responses \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen4-max",
    "input": "Please visit the official Alibaba Cloud Model Studio documentation for the code interpreter and summarize its main content",
    "tools": [
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    "enable_thinking": true
}'

出力例:

====================Response Content====================
Based on the official Alibaba Cloud Model Studio documentation, I have summarized the core content of the **コードインタープリター** feature for you:

## 1. Feature Positioning

...

> **Document Source**: Alibaba Cloud Model Studio official documentation - [Qwen Code Interpreter](https://www.alibabacloud.com/help/model-studio/qwen-code-interpreter) and [Assistant API Code Interpreter](https://www.alibabacloud.com/help/model-studio/code-interpreter)
====================Tool Call Count====================

Web extraction count: 1

ストリーミング出力

Web 抽出には時間がかかる場合があります。ストリーミング出力を有効にすると、中間結果をリアルタイムで受け取れます。

ツール実行の中間ステータスを取得するには、レスポンス API を使用してください。

OpenAI 互換 - レスポンス API

import os
from openai import OpenAI

client = OpenAI(
    # 環境変数が設定されていない場合は、次の行を api_key="sk-xxx" (非推奨) に置き換え、Model Studio の API キーを使用してください。
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # Singapore リージョン。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
)

stream = client.responses.create(
    model="qwen4-max",
    input="Please visit the official Alibaba Cloud Model Studio documentation for the code interpreter and summarize its main content",
    tools=[
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    stream=True,
    extra_body={"enable_thinking": True}
)

reasoning_started = False
output_started = False

for chunk in stream:
    # 思考プロセスを出力します
    if chunk.type == 'response.reasoning_summary_text.delta':
        if not reasoning_started:
            print("="*20 + "Thinking Process" + "="*20)
            reasoning_started = True
        print(chunk.delta, end='', flush=True)
    # ツール呼び出しの完了時に出力します
    elif chunk.type == 'response.output_item.done':
        if hasattr(chunk, 'item') and hasattr(chunk.item, 'type'):
            if chunk.item.type == 'web_extractor_call':
                print("\n" + "="*20 + "Tool Call" + "="*20)
                print(chunk.item.goal)
                print(chunk.item.output)
            elif chunk.item.type == 'reasoning':
                reasoning_started = False
    # 応答コンテンツを出力します
    elif chunk.type == 'response.output_text.delta':
        if not output_started:
            print("\n" + "="*20 + "Response Content" + "="*20)
            output_started = True
        print(chunk.delta, end='', flush=True)
    # 応答が完了したら、ツール呼び出し回数を出力します
    elif chunk.type == 'response.completed':
        print("\n" + "="*20 + "Tool Call Count" + "="*20)
        usage = getattr(chunk.response, "tool_usage", {})
        if usage:
            print(f"Web extraction count: {usage.get('web_extractor', {}).get('num_requests')}")
            print(f"Web search count: {usage.get('web_search', {}).get('num_requests')}")
import OpenAI from "openai";
import process from 'process';

const openai = new OpenAI({
    // 環境変数が設定されていない場合は、次の行を apiKey: "sk-xxx" に置き換え、Model Studio の API キーを使用してください。
    apiKey: process.env.DASHSCOPE_API_KEY,
    // Singapore リージョン。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
    baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
});

async function main() {
    const stream = await openai.responses.create({
        model: "qwen4-max",
        input: "Please visit the official Alibaba Cloud Model Studio documentation for the code interpreter and summarize its main content",
        tools: [
            { type: "web_search" },
            { type: "web_extractor" },
            { type: "code_interpreter" }
        ],
        stream: true,
        enable_thinking: true
    });

    let reasoningStarted = false;
    let outputStarted = false;

    for await (const chunk of stream) {
        // 思考プロセスを出力します
        if (chunk.type === 'response.reasoning_summary_text.delta') {
            if (!reasoningStarted) {
                console.log("====================Thinking Process====================");
                reasoningStarted = true;
            }
            process.stdout.write(chunk.delta);
        }
        // ツール呼び出しの完了時に出力します
        else if (chunk.type === 'response.output_item.done') {
            if (chunk.item && chunk.item.type === 'web_extractor_call') {
                console.log("\n" + "====================Tool Call====================");
                console.log(chunk.item.goal);
                console.log(chunk.item.output);
            } else if (chunk.item && chunk.item.type === 'reasoning') {
                reasoningStarted = false;
            }
        }
        // 応答コンテンツを出力します
        else if (chunk.type === 'response.output_text.delta') {
            if (!outputStarted) {
                console.log("\n" + "====================Response Content====================");
                outputStarted = true;
            }
            process.stdout.write(chunk.delta);
        }
        // 応答が完了したら、ツール呼び出し回数を出力します
        else if (chunk.type === 'response.completed') {
            console.log("\n" + "====================Tool Call Count====================");
            const usage = chunk.response.tool_usage;
            if (usage) {
                console.log(`Web extraction count: ${usage.web_extractor?.num_requests}`);
                console.log(`Web search count: ${usage.web_search?.num_requests}`);
            }
        }
    }
}

main();
# Singapore リージョン。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/responses \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen4-max",
    "input": "Please visit the official Alibaba Cloud Model Studio documentation for the code interpreter and summarize its main content",
    "tools": [
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    "enable_thinking": true,
    "stream": true
}'

課金

課金には以下が含まれます:

  • モデル呼び出し料金:Web ページから抽出したコンテンツがプロンプトに追加されるため、入力トークン数が増加します。これらのトークンは、モデルの標準レートで課金されます。料金の詳細については、Model Studio コンソールをご参照ください。

  • ツール呼び出し料金:Web 抽出および Web 検索が含まれます。

    • Web 検索の料金 (1,000 回あたり):

      • China (Beijing) リージョン:$0.57341。
      • シンガポールリージョン: $10.00。
    • Web エクストラクターは期間限定で無料です。