Dashscope

Dashscope provides access to Alibaba Cloud’s Qwen family of large language models. Qwen models are multilingual, efficient, and offer strong performance across various tasks including reasoning, coding, and creative writing. We recommend experimenting to find the best-suited model for your use-case. Here are some general recommendations:

qwen-plus is good for most general use-cases with balanced performance and cost.
qwen-max offers the highest quality for complex reasoning tasks.
qwen-turbo provides faster inference for simpler tasks.

Dashscope also supports advanced features like structured outputs and thinking processes for enhanced reasoning capabilities.

Authentication

Set your DASHSCOPE_API_KEY environment variable. You can get one from Alibaba Cloud here.

export DASHSCOPE_API_KEY=sk-***

setx DASHSCOPE_API_KEY sk-***

Base URL

Dashscope provides different base URLs depending on your region:

International users:
https://dashscope-intl.aliyuncs.com/compatible-mode/v1
China mainland users:
https://dashscope.aliyuncs.com/compatible-mode/v1

By default, Agno uses the international endpoint.
If you are located in mainland China, you may need to override base_url

Example

Use DashScope with your Agent:

from agno.agent import Agent, RunResponse
from agno.models.dashscope import DashScope

agent = Agent(
    model=DashScope(id="qwen-plus"),
    markdown=True
)

# Print the response in the terminal
agent.print_response("Share a 2 sentence horror story.")

Thinking Process

DashScope models support enabling thinking processes for enhanced reasoning:

from agno.agent import Agent
from agno.models.dashscope import DashScope

agent = Agent(
    model=DashScope(
        id="qwen-plus",
        enable_thinking=True,
        include_thoughts=True,
    ),
)

View more examples here.

Params

Parameter	Type	Default	Description
`id`	`str`	`"qwen-plus"`	The id of the Dashscope Qwen model to use
`name`	`str`	`"Qwen"`	The name of the model
`provider`	`str`	`"Dashscope"`	The provider of the model
`api_key`	`Optional[str]`	`None`	The Dashscope API key for authentication
`base_url`	`str`	`"https://dashscope-intl.aliyuncs.com/compatible-mode/v1"`	The base URL for the Dashscope API
`enable_thinking`	`Optional[bool]`	`None`	Enable thinking process for enhanced reasoning
`include_thoughts`	`Optional[bool]`	`None`	Include thinking process in the response

DashScope also supports the params of OpenAI.

Introduction

Concepts

Other

How to

Authentication

Base URL

Example

Thinking Process

Params

​Authentication

​Base URL

​Example

​Thinking Process

​Params

Authentication

Base URL

Example

Thinking Process

Params