Aliyun Bailian API: модели, цены и настройка OpenAI-совместимого доступа
Полное руководство по Aliyun Bailian (DashScope) — получение API key, OpenAI-совместимые эндпоинты, семейство моделей Qwen, тарифы, rate limits и типичные ошибки интеграции.
Aliyun Bailian — управляемая AI-платформа от Alibaba, также известная как Alibaba Cloud Model Studio. Она предоставляет всё семейство Qwen через DashScope — API-слой с поддержкой нативного протокола и OpenAI-совместимого эндпоинта. Вы меняете три значения в существующем коде на OpenAI SDK (API key, base URL, имя модели) — и ваше приложение работает с моделями Qwen без единой строки переписывания бизнес-логики.
Мы написали это руководство по Aliyun Bailian API, потому что документация DashScope разбросана по десяткам страниц на китайском и английском, а соотношение «Bailian — DashScope — Model Studio» сбивает с толку большинство разработчиков при первом знакомстве. Это единственная справка, которая нам нужна была, когда мы впервые добавили Aliyun Bailian в конфигурацию маршрутизации.
Что такое Bailian и DashScope
Иерархия именований:
- Alibaba Cloud Model Studio (阿里云百炼) — консоль управления: рабочие пространства, API ключи, задачи файн-тюнинга, биллинг.
- DashScope — API-сервис, через который проходят все запросы на инференс.
- Bailian (百炼) — бренд для китайского рынка. Международные пользователи видят «Model Studio»; в материковом Китае — «百炼».
На практике «Bailian» и «Model Studio» — один и тот же продукт. DashScope — программный интерфейс к нему.
Быстрый старт: первый вызов за 3 минуты
Шаг 1: Создайте аккаунт Alibaba Cloud. Перейдите на alibabacloud.com (международный) или aliyun.com (материковый Китай). Активируйте Model Studio в консоли.
Шаг 2: Получите API key. Откройте страницу API Keys и создайте новый ключ. DashScope позволяет ограничить ключ конкретным рабочим пространством — используйте это для изоляции в мультикомандных сценариях.
Шаг 3: Первый вызов. Установите OpenAI Python SDK:
pip install --upgrade openai
Направьте его на DashScope:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("DASHSCOPE_API_KEY"),
base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1", # Сингапур
)
response = client.chat.completions.create(
model="qwen-plus",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Что такое Alibaba Cloud Model Studio?"},
],
)
print(response.choices[0].message.content)
Всё. Специальный SDK DashScope не нужен — если только вам не требуются нативные функции вроде асинхронной генерации видео.
OpenAI-совместимые эндпоинты по регионам
DashScope предоставляет региональные эндпоинты. Выбирайте ближайший к вашему развёртыванию:
| Регион | Base URL |
|---|---|
| Китай (Пекин) | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| Сингапур | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| США (Виргиния) | https://dashscope-us.aliyuncs.com/compatible-mode/v1 |
| Гонконг | https://cn-hongkong.dashscope.aliyuncs.com/compatible-mode/v1 |
Важно: API ключи привязаны к региону. Ключ из пекинской консоли не работает с сингапурским эндпоинтом и наоборот. При ошибке InvalidApiKey после смены региона — создайте новый ключ в консоли целевого региона.
OpenAI-совместимый endpoint поддерживает chat completions, streaming, tool calling (function calling), embeddings и Responses API. Асинхронные операции (генерация видео, TTS) используют нативный DashScope API.
Модели Qwen и сторонние модели на Bailian
Bailian в основном обслуживает семейство Qwen. По состоянию на июнь 2026 года основные уровни моделей через OpenAI-совместимый endpoint:
Коммерческие модели (управляемые Alibaba):
- Qwen-Max —
qwen3.7-max,qwen3-max,qwen-max: флагманские модели рассуждения и генерации. Thinking и non-thinking режимы. Контекст до 1M токенов уqwen3.7-max. - Qwen-Plus —
qwen3.7-plus,qwen3.5-plus,qwen-plus: производительные модели общего назначения по более низкой цене. - Qwen-Flash —
qwen3.5-flash,qwen-flash: оптимизированы под низкую латентность. - Qwen-Turbo —
qwen-turbo: самый дешёвый вариант для простых задач с высокой пропускной способностью. - Qwen-Coder —
qwen3-coder-plus,qwen3-coder-flash: модели для кода. - QwQ —
qwq-plus: модель, специализированная на рассуждениях.
Open-source модели (хостятся на Bailian):
qwen3.5-397b-a17b,qwen3.5-120b-a10b,qwen3.5-27b,qwen3-235b-a22b,qwen3-32b,qwen3-14b,qwen3-8bи меньшие варианты.- Qwen 2.5 серия, включая 1M-контекстные версии:
qwen2.5-14b-instruct-1m,qwen2.5-7b-instruct-1m.
Доступность моделей зависит от региона. Пекинский endpoint предлагает самый широкий выбор; сингапурский покрывает большинство международных моделей; американский — ограниченное подмножество. Всегда проверяйте официальный список поддерживаемых моделей для вашего региона.
Цены, квоты и rate limits
Bailian использует потокенную тарификацию с ступенчатыми ценами в зависимости от объёма входных токенов в одном запросе. Цены в юанях за миллион токенов.
Qwen-Max (материковый Китай, июнь 2026):
| Модель | Входные токены | Вход | Выход |
|---|---|---|---|
qwen3.7-max | 0–1M | ¥12 | ¥36 |
qwen3-max | 0–32K | ¥2.5 | ¥10 |
qwen3-max | 32K–128K | ¥4 | ¥16 |
qwen3-max | 128K–256K | ¥7 | ¥28 |
Qwen-Plus (материковый Китай):
| Модель | Входные токены | Вход | Выход |
|---|---|---|---|
qwen3.7-plus | 0–256K | ¥2 | ¥8 |
qwen3.5-plus | 0–128K | ¥0.8 | ¥4.8 |
qwen-plus | 0–128K | ¥0.8 | ¥2 (non-thinking) / ¥8 (thinking) |
Международные цены (Сингапур) примерно в 3–4 раза выше материковых для Qwen-Max.
Бесплатный уровень: новые аккаунты Bailian получают по 1 миллиону бесплатных токенов на отдельные модели (вход и выход), действительных 90 дней после активации. Кредитная карта не требуется.
Batch API: модели с поддержкой пакетного инференса тарифицируются по 50% от цены real-time.
Rate limits действуют на уровне аккаунта и модели. Для qwen3-max в глобальном развёртывании документированный лимит начинается с 600 RPM. Лимиты также применяются посекундно (RPM/60). Ответ 429 сбрасывается в течение минуты. Официальная рекомендация: при rate limit переключайтесь на альтернативный snapshot модели.
Актуальные цены и лимиты см. на странице тарифов и в документации по rate limits.
Bailian vs SiliconFlow vs Volcengine: сравнение для маршрутизации
Если вы выбираете среди китайских LLM-провайдеров, Bailian — один из трёх ключевых вариантов наряду с SiliconFlow и Volcengine Ark. Сравнение с точки зрения маршрутизации:
| Критерий | Bailian (DashScope) | SiliconFlow | Volcengine Ark |
|---|---|---|---|
| Основные модели | Qwen (Alibaba) | 200+ моделей (мультивендор) | Doubao (ByteDance) |
| OpenAI-совместимость | Да | Да | Да |
| Региональные эндпоинты | Пекин, Сингапур, США, Гонконг, ЕС | Материковый Китай | Материковый Китай |
| Бесплатный уровень | 1M токенов / 90 дней | 3 бесплатные модели без срока | Зависит от модели |
| Ключевое преимущество | Официальный источник Qwen, Coding Plan, изоляция workspace | Самый широкий выбор моделей | Экосистема ByteDance |
Для команд, работающих в основном с Qwen, Bailian — каноничный источник: новейшие снапшоты моделей появляются первыми, лимиты официальные, поддержка прямая. Для маршрутизации между несколькими семействами китайских моделей ширина SiliconFlow может быть удобнее. Подробное сравнение — в нашем материале SiliconFlow vs DashScope.
Типичные ошибки интеграции
InvalidApiKey после смены региона. API ключи DashScope привязаны к региону. Ключ из пекинской консоли не авторизует запросы к сингапурскому эндпоинту. Создайте новый ключ в нужном регионе.
Model not found / Model does not exist. Доступность моделей зависит от региона. Проверьте список поддерживаемых моделей для вашего региона. Некоторые модели (например, qwen-math-plus) доступны только в deployment Китая.
429 Rate limit exceeded. Bailian ограничивает RPM и TPM на уровне аккаунта плюс burst-лимиты в секунду. Решения: сглаживание запросов с exponential backoff, переключение на альтернативный snapshot модели, batch inference для не-real-time задач.
Allocated quota exceeded. Обычно означает превышение TPM (токенов в минуту). Сократите промпт, уменьшите max_tokens или разбейте длинные документы на меньшие запросы.
Путаница Coding Plan endpoint и стандартного Bailian. Coding Plan использует выделенный endpoint (https://coding.dashscope.aliyuncs.com/v1) и отдельные API ключи. Ключи Coding Plan и стандартные sk-* не взаимозаменяемы.
Миграция сингапурского домена. Alibaba выводит https://dashscope-intl.aliyuncs.com для Сингапура, заменяя на workspace-scoped URL-адреса (https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com). При появлении предупреждений об устаревании — обновите base_url.
Маршрутизация с несколькими провайдерами через Bailian
Когда мы маршрутизируем OpenAI-совместимые запросы через настроенных провайдеров, Bailian естественно встраивается как backend. OpenAI-совместимый endpoint означает отсутствие трансляции протоколов — тот же формат запроса, что работает с OpenAI или SiliconFlow, работает и с DashScope.
Практичный паттерн: используйте Bailian как primary для моделей Qwen (он официальный источник с самыми свежими снапшотами), а SiliconFlow или другого провайдера — как fallback. Если Bailian отвечает 429, router прозрачно повторяет запрос к fallback-провайдеру. Подробнее о проектировании fallback-цепочек — в нашем руководстве по fallback-маршрутизации LLM API.
# Пример: OpenAI SDK с Bailian как primary
from openai import OpenAI
# Primary: Bailian
bailian_client = OpenAI(
api_key="sk-bailian-xxx",
base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)
# Fallback: SiliconFlow
siliconflow_client = OpenAI(
api_key="sk-siliconflow-xxx",
base_url="https://api.siliconflow.cn/v1",
)
try:
response = bailian_client.chat.completions.create(
model="qwen3-max",
messages=[{"role": "user", "content": "Объясни квантовые вычисления"}],
)
except Exception:
# Fallback к SiliconFlow
response = siliconflow_client.chat.completions.create(
model="Qwen/Qwen3-235B-A22B",
messages=[{"role": "user", "content": "Объясни квантовые вычисления"}],
)
FAQ
Bailian и DashScope — это одно и то же? Bailian (百炼) — бренд продукта/консоли; DashScope — нижележащий API-сервис. На практике это одна платформа. Вызовы идут через DashScope эндпоинты; управление — через консоль Bailian.
Можно ли использовать OpenAI SDK напрямую с Bailian?
Да. Укажите base_url соответствующего DashScope эндпоинта и используйте API key Bailian. Дополнительный SDK не нужен для chat completions, streaming, tool calling и embeddings.
Какие модели бесплатны на Bailian?
Новые аккаунты получают по 1 миллиону токенов на отдельные модели (qwen3.7-max, qwen3.7-plus и др.), действительных 90 дней. Часть open-source моделей имеет отдельные бесплатные квоты. Детали — на странице тарифов.
Как Bailian по цене сравнивается с OpenAI?
Модели Qwen на Bailian значительно дешевле аналогичных моделей OpenAI. Например, qwen3-max стартует от ¥2.5/М входных токенов (~$0.35 USD) на пекинском эндпоинте — примерно в 10 раз дешевле GPT-4o. Международные эндпоинты дороже, но всё равно конкурентоспособны.
Можно ли использовать Bailian за пределами Китая?
Да. Используйте сингапурский (dashscope-intl.aliyuncs.com), американский (dashscope-us.aliyuncs.com) или гонконгский endpoint. Нужен международный аккаунт Alibaba Cloud и API key для соответствующего региона.
Поддерживает ли Bailian function calling / tool use? Да. OpenAI-совместимый endpoint поддерживает tool calling в том же формате, что и OpenAI API. Более новые версии моделей также поддерживают structured output и Responses API.
Источники: Alibaba Cloud Model Studio — OpenAI Compatibility, Bailian Model Pricing, Rate Limits, DashScope API Reference. Получено: июнь 2026.