openapi: 3.1.0
info:
  title: Qwen via Alibaba Cloud Model Studio (DashScope) Chat Embeddings 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: Embeddings
paths:
  /embeddings:
    post:
      summary: Create text embeddings
      operationId: createEmbeddings
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - model
              - input
              properties:
                model:
                  type: string
                  description: Embedding model id (e.g. text-embedding-v3)
                input:
                  oneOf:
                  - type: string
                  - type: array
                    items:
                      type: string
      responses:
        '200':
          description: Embedding response
      tags:
      - Embeddings
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Bearer API key from the DashScope key management page. Pass as `Authorization: Bearer <DASHSCOPE_API_KEY>`.'