Многие ищут «бесплатный Doubao API» в расчёте на долго работающий бесплатный вход. На деле Volcano Ark выдаёт новым пользователям разовую бесплатную квоту на инференс: у неё есть границы и механизм остановки после исчерпания, это не бесконечно доступная бесплатная версия. Главная причина последующих проблем — принимать «бесплатную квоту» за «бесплатную модель».
Примечание: Doubao, Volcano Ark и Volcano Engine — товарные знаки ByteDance и связанных с ней компаний. Статья носит технический характер и служит для сравнения вариантов; мы не аффилированы с правообладателями, не выступаем их агентом и не состоим в партнёрских отношениях. Квоты, модели и цены могут меняться; ориентируйтесь на консоль Volcano Engine, официальную документацию и страницу цены на модели.
1. Что такое «бесплатное» в Doubao API
По состоянию на октябрь 2026 года бесплатные возможности Volcano Ark делятся на два уровня.
Первый — бесплатная квота на инференс для новых пользователей. После регистрации в Volcano Engine часть моделей получает определённый объём бесплатных вызовов. Официальная документация не приводит единую цифру для всех моделей: квота считается по модели, основной и субаккаунты делят её, базовые и дообученные версии также используют одну и ту же квоту.
Второй — режим безопасного знакомства. Это переключатель на уровне аккаунта для новых аккаунтов, прошедших верификацию и никогда не активировавших сервис моделей; официально указанная квота — 500 тыс. токенов. После включения расходуется только бесплатная квота, при приближении к исчерпанию сервис автоматически приостанавливается и не переходит в платный режим; после исчерпания обычно возвращается HTTP 429 и SetLimitExceeded. По умолчанию режим выключен, после выключения включить его снова нельзя.
Оба уровня — не «постоянный бесплатный тариф», а скорее пробный набор: его хватает, чтобы замкнуть бизнес-цикл, но недостаточно для долгосрочного производственного трафика.
2. Что покрывает бесплатная квота, а что нет
Бесплатная квота компенсирует только «оплату онлайн-инференса по токенам» и включает токены попадания в кэш, промаха и выхода. Легко упустить то, что она не покрывает:
| Статья расходов | Обычно покрывается бесплатной квотой | На что смотреть при закупке |
|---|---|---|
| Токены онлайн-инференса | Да | Попадание, промах и выход считаются отдельно |
| Плагины и база знаний | Нет | Могут тарифицироваться отдельно |
| Пакетный инференс | Нет | У пакетной обработки своя методика |
| Хранение контекстного кэша | Нет | Отдельная плата по часам |
| Дообучение | Нет | Обучение и инференс считаются раздельно |
| Генерация изображений, видео, 3D | По консоли | Может считаться за изображение или запись, не за токены |
Кроме того, режим безопасного знакомства покрывает большинство моделей, но исключает мультимодальные embedding и модели синхронного перевода. При построении RAG или мультимодального приложения не предполагайте, что все вызовы входят в бесплатную квоту.
3. Лимиты: бесплатная квота не равна бесплатному параллелизму
Бесплатная квота решает вопрос «платить или нет», лимиты — «можно ли стабильно вызывать». Volcano Ark задаёт ограничения RPM, TPM, TPD, IPM и параллелизма по моделям; лимиты уровня модели устанавливает платформа, лимиты уровня терминала можно менять самостоятельно, повышение обычно требует заявки. У лёгких моделей стандартные лимиты обычно мягче; точные значения — в списке моделей и на странице активации.
Распространены три кода ошибок: ServerOverloaded — нехватка ресурсов, RequestBurstTooFast — слишком быстрый рост трафика, SetLimitExceeded — исчерпание бесплатной квоты. Все три возвращают HTTP 429, но в первых двух случаях нужна задержка или сглаживание потока, а в последнем — только ожидание восстановления квоты или переход на платный режим.
Не боритесь с 429 немедленным повтором. Неудачные запросы тоже могут расходовать квоту, и чем больше повторов, тем хуже. Надёжнее выравнивать поток очередью, применять экспоненциальную задержку со случайным разбросом и держать резервную модель. Скрипт ниже записывает токены и тип ошибки каждого вызова, чтобы через неделю понять, хватает ли квоты:
import os, time, json
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ARK_API_KEY"],
base_url=os.environ["ARK_BASE_URL"], # см. официальную документацию или документацию шлюза
)
def call(prompt: str) -> dict:
start = time.time()
try:
resp = client.chat.completions.create(
model=os.environ["ARK_MODEL"],
messages=[{"role": "user", "content": prompt}],
max_tokens=512,
)
usage = resp.usage
return {
"ok": True,
"seconds": round(time.time() - start, 3),
"prompt_tokens": usage.prompt_tokens,
"completion_tokens": usage.completion_tokens,
}
except Exception as exc:
return {
"ok": False,
"seconds": round(time.time() - start, 3),
"error": type(exc).__name__,
"detail": str(exc)[:200],
}
if __name__ == "__main__":
for i in range(5):
print(json.dumps(call("Объясни в одном предложении, что такое лимит запросов"), ensure_ascii=False))
Суммируйте результаты по дням и смотрите на три вещи: средний расход токенов в день, долю 429 и среднее число токенов на задачу. Достаточно ли бесплатной квоты, решайте по данным, а не по ощущениям.
4. Условия данных: бесплатно не значит без ограничений
Запросы по бесплатной квоте тоже проходят через платформу. Специальные условия Volcano Ark указывают: без отдельного согласия клиента платформа не хранит и не использует данные клиента для обучения или улучшения моделей; данные могут обрабатываться при проверке соответствия, по инициативе клиента при диагностике и при оповещениях об аномальных вызовах; платформа ведёт агрегированную статистику, но не сохраняет исходные данные клиента.
Однако несколько пунктов нужно уточнить: включён ли высокозащищённый песочный режим, от которого зависит, передаются ли данные поставщику модели; если он не включён, действуют условия поставщика. В условиях нет универсального срока хранения и срока удаления — журналы клиент хранит сам. Для проприетарных, открытых, дообученных моделей и пакетной обработки правила тоже различаются. Бесплатный пробный период не может быть основанием пропустить проверку соответствия.
5. Для чего подходит бесплатный режим
Бесплатная квота лучше всего подходит для «проверки» и внутренних сценариев с низким риском:
- Стыковка интерфейса: проверить аутентификацию, тайм-ауты, потоковый вывод и коды ошибок.
- Итерация промптов: прогнать реальные задачи десятки или сотни раз, наблюдая стабильность и расход токенов.
- Выбор модели: сравнить флагманскую, лёгкую, переводческую и ролевую модели на одной задаче.
- Внутренние инструменты: протоколы встреч, классификация документов, извлечение полей — низкий параллелизм и возможность проверки человеком.
Наоборот, для следующих сценариев полагаться на бесплатную квоту не стоит:
- Клиентские производственные интерфейсы, где нужны стабильность и границы ответственности.
- Высокий параллелизм, длинный контекст и пакетная обработка: квота израсходуется гораздо быстрее ожидаемого.
- Задачи с персональными данными, договорами, кодом и финансовой информацией — сначала проверка соответствия.
- Корпоративные закупки, где нужны счета, договор, SLA или оплата со счёта компании.
6. Основные риски бесплатной квоты
Первый — исчерпание без буфера: режим безопасного знакомства просто приостанавливает сервис, и бизнес может остановиться без предупреждения о расходах. Второй — снятие модели: в списке моделей появляется отметка «скоро будет снята», и доступная в бесплатном режиме модель может не быть долгосрочной основной. Третий — лимиты и всплески трафика: акции или парсеры легко вызывают 429. Четвёртый — общие ключи: у ключа неизвестного происхождения нельзя отследить ответственность, и он может нарушать условия платформы. Пятый — изменение условий и цен: квоты, набор моделей и тарификация могут меняться.
7. Шаги перехода с бесплатного на платный режим
- Неделю записывайте на реальном трафике токены, долю 429 и стоимость одной задачи.
- Пройдите верификацию компании и определите субъект договора, оплату и тип документов.
- Активируйте модель в разделе управления активацией; остаток бесплатной квоты по-прежнему будет списываться первым.
- Задайте лимиты расхода на уровне модели и терминала, чтобы эксперименты не разрушили бюджет.
- Настройте оповещения о балансе, расходе и доле ошибок.
- Выведите 5–10% производственного трафика в канареечный режим и следите за задержкой, ошибками и счётом.
- Подготовьте резервную модель или канал и отработайте одно переключение.
- После стабилизации расширяйте трафик и ежемесячно сверяйте цену, долю попаданий в кэш и версию модели.
Командам, которым нужен единый вход к нескольким моделям, счета в юанях и закрывающие документы, можно создать тестовый ключ в ZSQH AI Gateway и сравнить Doubao с другими моделями в одном интерфейсе. Цены и доступные модели — на странице цены на модели; не закладывайте в бюджет цифры из старых статей.
Частые вопросы
Есть ли у Doubao API долгосрочная бесплатная версия?
Нет бесплатной версии, на которую можно по умолчанию полагаться долго. Публичные бесплатные возможности — это квота нового пользователя и режим безопасного знакомства; у обоих есть ограничения по праву или объёму, а продление определяется официальной страницей.
500 тыс. токенов общие для всех моделей?
В официальной документации режим безопасного знакомства описан как квота уровня аккаунта, а бесплатная квота на инференс считается по моделям; эти методики не полностью совпадают. Фактический остаток смотрите на странице управления активацией и не планируйте ёмкость из расчёта «по 500 тыс. на каждую модель».
Будет ли автоматическое списание после исчерпания бесплатной квоты?
В режиме безопасного знакомства — нет: сервис приостанавливается и возвращает 429. После отключения режима или активации модели превышение начинает тарифицироваться по постоплате.
Можно ли использовать бесплатную квоту для пакетного инференса?
Обычно нет. Бесплатная квота покрывает только токены онлайн-инференса; пакетный инференс, плагины, база знаний и хранение кэша имеют отдельную тарификацию.
Бесплатный и платный режимы используют одну модель?
В большинстве случаев это одни и те же эндпоинты моделей, но набор моделей, лимиты и функции бесплатного режима могут отличаться. При тестировании смотрите фактическое имя модели в ответе и проверяйте длинный контекст, вызов инструментов и структурированный вывод.
Что дальше
Сначала прогоните на бесплатной квоте интерфейс и промпты, затем посчитайте месячную стоимость на реальном трафике и решите, подключаться напрямую или через шлюз. Если нужны единые счета и сравнение моделей, начните с регистрации в ZSQH AI Gateway; модели и цены — на странице цены на модели.
Связанные статьи:
Doubao, Volcano Ark и Volcano Engine — товарные знаки ByteDance и связанных с ней компаний. Статья носит технический характер и не является юридической или закупочной рекомендацией.
