Alibaba Cloud Model Studio:Qwen への最初の API 呼び出し

DashScope Python SDK

Python と DashScope Python SDK をインストールしたら、最初の API リクエストを送信してみましょう。

1. hello_qwen.py という名前のファイルを作成してください。
2. 次のコードを hello_qwen.py にコピーして保存してください。

import os
from dashscope import MultiModalConversation
import dashscope

# 以下の URL は Singapore リージョン用です。呼び出し時は、{WorkspaceId} をお使いのワークスペース ID に置き換えてください。URL はリージョンによって異なります。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'
messages = [
    {'role': 'system', 'content': [{'text': 'You are a helpful assistant.'}]},
    {'role': 'user', 'content': [{'text': 'Who are you?'}]}
]
response = MultiModalConversation.call(
    # Singapore、US (Virginia)、China (Beijing) の API キーに互換性はありません。API キーの取得： https://www.alibabacloud.com/help/model-studio/get-api-key
    # 環境変数が設定されていない場合は、api_key = "sk-xxx" に置き換えてください
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    model="qwen3.8-max",
    messages=messages
)

if response.status_code == 200:
    print(response.output.choices[0].message.content[0]["text"])
else:
    print(f"HTTP status code: {response.status_code}")
    print(f"Error code: {response.code}")
    print(f"Error message: {response.message}")
    print("See: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

3. コマンドラインから python hello_qwen.py または python3 hello_qwen.py を実行してください。

   注記この例のコマンドは、Python ファイルが保存されているディレクトリから実行する必要があります。別の場所から実行する場合は、完全なパスを指定してください。

   出力は次のとおりです。

I am a large-scale language model from Alibaba Cloud. My name is Qwen.

OpenAI Python SDK

Python と OpenAI Python SDK をインストールしたら、最初の API リクエストを送信してみましょう。

1. hello_qwen.py という名前のファイルを作成してください。
2. 次のコードを hello_qwen.py にコピーして保存してください。

import os
from openai import OpenAI

try:
    client = OpenAI(
        # 環境変数が設定されていない場合は、api_key = "sk-xxx" に置き換えてください
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        # 以下の URL は Singapore リージョン用です。呼び出し時は、{WorkspaceId} をお使いのワークスペース ID に置き換えてください。URL はリージョンによって異なります。
        base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
    )

    completion = client.chat.completions.create(
        model="qwen3.8-max",
        messages=[
            {'role': 'system', 'content': 'You are a helpful assistant.'},
            {'role': 'user', 'content': 'Who are you?'}
        ]
    )
    print(completion.choices[0].message.content)
except Exception as e:
    print(f"Error message: {e}")
    print("See: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

US (Virginia) リージョンの場合、エンドポイントドメインは {WorkspaceId}.us-east-1.maas.aliyuncs.com となり、ベース URL にはワークスペース ID (WorkspaceId) プレフィックスが含まれません。これは China (Beijing)、Singapore、およびその他のリージョンとは異なる形式です。

import os
from openai import OpenAI

try:
    client = OpenAI(
        # 環境変数が設定されていない場合は、api_key = "sk-xxx" に置き換えてください
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        # 以下のベース URL は US (Virginia) リージョン用です。このリージョンではワークスペース固有のドメインを使用しないため、WorkspaceId を含めないでください。
        base_url="https://us-east-1.maas.aliyuncs.com/compatible-mode/v1",
    )

    completion = client.chat.completions.create(
        model="qwen3.8-max",
        messages=[
            {'role': 'system', 'content': 'You are a helpful assistant.'},
            {'role': 'user', 'content': 'Who are you?'}
        ]
    )
    print(completion.choices[0].message.content)
except Exception as e:
    print(f"Error message: {e}")
    print("See: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

3. コマンドラインから python hello_qwen.py または python3 hello_qwen.py を実行してください。

   No such file or directory が表示される場合は、ファイルの完全なパスを指定してください。

   出力は次のとおりです。

I am a large-scale language model developed by Alibaba Cloud. My name is Qwen.

OpenAI 互換 HTTP

この例の URL は Singapore リージョンのものです。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。China (Beijing) リージョンを使用する場合は、URL を https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions に置き換えてください。

API リクエストを送信します：

curl -X POST "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" ^
-H "Authorization: Bearer %DASHSCOPE_API_KEY%" ^
-H "Content-Type: application/json" ^
-d "{
    \"model\": \"qwen3.8-max\",
    \"messages\": [
        {
            \"role\": \"system\",
            \"content\": \"You are a helpful assistant.\"
        },
        {
            \"role\": \"user\",
            \"content\": \"Who are you?\"
        }
    ]
}"

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3.8-max",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "Who are you?"
        }
    ]
}'

API リクエストを送信すると、次のレスポンスが返されます：

{
    "choices": [
        {
            "message": {
                "role": "assistant",
                "content": "I am a large-scale language model from Alibaba Cloud. My name is Qwen."
            },
            "finish_reason": "stop",
            "index": 0,
            "logprobs": null
        }
    ],
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 22,
        "completion_tokens": 16,
        "total_tokens": 38
    },
    "created": 1728353155,
    "system_fingerprint": null,
    "model": "qwen3.8-max",
    "id": "chatcmpl-39799876-eda8-9527-9e14-2214d641cf9a"
}

DashScope HTTP

この例の URL は Singapore リージョンのものです。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。

• US (Virginia) リージョンを使用する場合は、URL を https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation に置き換えてください。
• China (Beijing) リージョンを使用する場合は、URL を https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation に置き換えてください。{WorkspaceId} をお使いのワークスペース ID に置き換えてください。

API リクエストを送信します：

curl -X POST "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation" ^
-H "Authorization: Bearer %DASHSCOPE_API_KEY%" ^
-H "Content-Type: application/json" ^
-d "{
  \"model\": \"qwen3.8-max\",
  \"input\": {
    \"messages\": [
      {
        \"role\": \"system\",
        \"content\": [{\"text\": \"You are a helpful assistant.\"}]
      },
      {
        \"role\": \"user\",
        \"content\": [{\"text\": \"Who are you?\"}]
      }
    ]
  },
  \"parameters\": {
    \"result_format\": \"message\"
  }
}"

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3.8-max",
    "input":{
        "messages":[
            {
                "role": "system",
                "content": [{"text": "You are a helpful assistant."}]
            },
            {
                "role": "user",
                "content": [{"text": "Who are you?"}]
            }
        ]
    },
    "parameters": {
        "result_format":"message"
    }
}'

API リクエストを送信すると、次のレスポンスが返されます：

{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [{"text": "I am a large-scale language model from Alibaba Cloud. My name is Qwen."}]
                }
            }
        ]
    },
    "usage": {
        "total_tokens": 38,
        "output_tokens": 16,
        "input_tokens": 22
    },
    "request_id": "87f776d7-3c82-9d39-b238-d1ad38c9b6a9"
}