Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Qwen via Alibaba Cloud Model Studio (DashScope) Chat API
description: OpenAI-compatible REST API for invoking Alibaba's Qwen large language model family through Alibaba Cloud Model Studio (DashScope). Supports chat completions, text embeddings, and related model interfaces. Regional API keys are not interchangeable across the Singapore, US Virginia, and Beijing endpoints.
version: v1
servers:
- url: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
description: Singapore (international)
- url: https://dashscope-us.aliyuncs.com/compatible-mode/v1
description: US (Virginia)
- url: https://dashscope.aliyuncs.com/compatible-mode/v1
description: China (Beijing)
security:
- BearerAuth: []
tags:
- name: Chat Completions
paths:
/chat/completions:
post:
summary: Create a chat completion
operationId: createChatCompletion
description: OpenAI-compatible chat completions endpoint. Send a list of messages with a Qwen model (e.g. qwen-plus, qwen-max, qwen-turbo, qwen3-max).
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- model
- messages
properties:
model:
type: string
description: Qwen model id (e.g. qwen-plus, qwen-max)
messages:
type: array
items:
type: object
required:
- role
- content
properties:
role:
type: string
enum:
- system
- user
- assistant
- tool
content:
type: string
stream:
type: boolean
default: false
temperature:
type: number
top_p:
type: number
max_tokens:
type: integer
responses:
'200':
description: Chat completion response
tags:
- Chat Completions
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: 'Bearer API key from the DashScope key management page. Pass as `Authorization: Bearer <DASHSCOPE_API_KEY>`.'