DashScope SDK

Go and Rust SDK for Aliyun DashScope (百炼 Model Studio) APIs.

Official API Documentation: api/README.md

Design Goals

Realtime Focus: Primarily implement Qwen-Omni-Realtime WebSocket API
OpenAI Compatibility: Text/chat APIs use OpenAI-compatible SDK
Native WebSocket: Direct WebSocket implementation, not polling

Scope

This SDK focuses on Qwen-Omni-Realtime API for real-time multimodal conversation. For standard text APIs, use OpenAI-compatible SDKs.

API	SDK Coverage	Alternative
Text Chat	❌	OpenAI SDK with custom base URL
App/Agent	❌	Direct HTTP calls
Realtime	✅	This SDK

API Coverage

Feature	Go	Rust	Official Doc
Realtime Session	✅	✅	api/realtime/
Audio Input/Output	✅	✅
Function Calls	✅	✅
Text Input	✅	✅
Video Input	⚠️	⚠️	Limited support

Architecture

graph TB
    subgraph client["Client"]
        subgraph realtime["RealtimeService"]
            session["RealtimeSession"]
            send["Send Events"]
            recv["Receive Events"]
        end
    end
    
    client --> ws["wss://dashscope.aliyuncs.com<br/>/api-ws/v1/realtime"]

Authentication

Authorization: Bearer <api_key>

Optional workspace isolation:

X-DashScope-WorkSpace: <workspace_id>

Base URLs

Region	WebSocket URL
China (Beijing)	`wss://dashscope.aliyuncs.com/api-ws/v1/realtime`
International (Singapore)	`wss://dashscope-intl.aliyuncs.com/api-ws/v1/realtime`

Models

Model	Input	Output	Sample Rate
`qwen-omni-turbo-realtime`	audio/text	audio/text	16kHz
`qwen3-omni-flash-realtime`	audio/text/video	audio/text	24kHz

Event Flow

sequenceDiagram
    participant C as Client
    participant S as Server
    C->>S: session.update
    C->>S: input_audio_buffer.append
    C->>S: response.create
    S-->>C: response.audio.delta
    S-->>C: response.audio.delta
    S-->>C: response.done

Examples Directory

examples/go/dashscope/ - Go SDK examples
examples/cmd/dashscope/ - CLI test scripts

For Text/Chat APIs

Use OpenAI-compatible SDK:

Go:

import "github.com/sashabaranov/go-openai"

config := openai.DefaultConfig(apiKey)
config.BaseURL = "https://dashscope.aliyuncs.com/compatible-mode/v1"
client := openai.NewClientWithConfig(config)

Rust:

#![allow(unused)]
fn main() {
// Use async-openai with custom base URL
}

CLI tool: go/cmd/dashscope/
CLI tests: examples/cmd/dashscope/

Giztoy Documentation