Типичный путь корпоративной закупки Doubao API — сначала запустить прототип на личном аккаунте, а потом добавить договор и счета. На этапе прототипа это нормально, но после подключения к бизнесу всплывают три проблемы: субъект аккаунта — не компания, у ключей нет границ прав, условия данных никто не проверял. Doubao API работает на Volcano Ark, поэтому объект закупки — сочетание «сервис моделей + аккаунт + договор».

Примечание: Doubao, Volcano Ark и Volcano Engine — товарные знаки ByteDance и связанных с ней компаний. Статья носит технический характер и служит закупочным ориентиром; она не является юридическим заключением и не подразумевает аффилированности, агентских или партнёрских отношений с правообладателями. Цены, квоты и условия — по официальным страницам, подписанному договору и странице цены на модели.

1. Пять блоков закупочного чек-листа

Модуль Что нужно подтвердить Какие материалы подготовить
Субъект и аккаунт Субъект договора, администраторы Документы верификации, реестр аккаунтов
Права и ключи Отдельный ключ на приложение Пользователи IAM, политики, список ключей
Квоты и лимиты Бесплатная квота, пиковая нагрузка Модель расхода, настройки оповещений
Данные и безопасность контента Ответственность за обучение и модерацию Условия, соглашения, порядок реагирования
Затраты и счета Методика биллинга, документы Бюджетная таблица, договор, счёт

2. Субъект и аккаунт: компании не стоит использовать личный аккаунт

  1. Регистрируйтесь с корпоративной почтой на домене, пройдите верификацию и привяжите юридическое лицо.
  2. Основной аккаунт используйте только для финансов и управления; для бизнеса создавайте субпользователей IAM по приложениям.
  3. Субпользователям выдавайте только минимальные права; не используйте общий администраторский аккаунт.
  4. Создавайте, ротируйте и отзывайте ключи централизованно в консоли IAM; при увольнении или выводе сервиса действуйте сразу.
  5. Включите многофакторную аутентификацию и сохраняйте журнал аудита.

Документация IAM Volcano Ark различает два типа ключей: ключи, созданные в консоли IAM, принадлежат субпользователю и требуют ручного подключения политики Ark; ключи, созданные в консоли Ark, автоматически получают предустановленную политику. Первый вариант лучше подходит для управления правами. В любом случае ключи не должны попадать во фронтенд, репозиторий кода или переписку.

3. Квоты и лимиты: бесплатная квота — не закупочная

Бесплатная квота новичка подходит для проверки, но не для планирования ёмкости. При закупке нужно различать четыре категории цифр: бесплатная квота считается по моделям, делится между основным и субаккаунтами и покрывает только токены онлайн-инференса, без плагинов, базы знаний, пакетной обработки и хранения кэша; лимиты уровня модели включают RPM, TPM, TPD, IPM и одновременные запросы, устанавливаются платформой, а повышение требует заявки; лимиты уровня терминала можно менять на странице деталей; при достижении лимита расхода сервис приостанавливается и это несовместимо с частью возможностей кэша и низкой задержки.

До закупки попросите бизнес указать пиковые RPM, TPM и максимальную длину входа и выхода. После запуска следите за 429: при ServerOverloaded нужна задержка, при RequestBurstTooFast — более плавный рост, SetLimitExceeded означает исчерпание квоты. Volcano Ark поддерживает X-Ark-Max-Wait-Timeout-Ms, позволяющий ставить запросы в очередь; это подходит для нереальных по времени задач, но требует увеличения тайм-аута.

4. Данные и соответствие: переведите устные пояснения в условия

Специальные условия Volcano Ark указывают: без отдельного согласия платформа не хранит и не использует данные клиента для обучения или улучшения моделей; данные могут обрабатываться при проверке соответствия, диагностике и оповещениях об аномальных вызовах; платформа ведёт агрегированную статистику, но не сохраняет исходные данные. Компании нужно подтвердить ещё шесть пунктов:

  1. Включён ли высокозащищённый песочный режим и передаются ли данные поставщику модели.
  2. Проприетарная, открытая или дообученная модель и какие условия к ней применяются.
  3. Права на дообучающие данные, область использования, хранение и удаление.
  4. Есть ли трансграничная передача и нужна ли отдельная оценка.
  5. Можно ли подписать корпоративный договор, соглашение об обработке данных и соглашение о конфиденциальности.
  6. Срок уведомления об инцидентах безопасности, порядок реагирования и возможность предоставить аудиторский отчёт.

Два особых замечания. Во-первых, дообученная модель не означает «модель принадлежит компании»: условия обычно дают лишь исключительное использование после оплаты, модель всё равно развёрнута на платформе, исходный код и параметры не передаются. Во-вторых, в условиях нет универсального срока хранения — компания сама хранит журналы и фиксирует обязанность удаления в договоре. Чувствительные данные сначала обезличивайте.

5. Безопасность контента: возможности платформы и ответственность приложения нужно разделять

Модели Doubao имеют базовые механизмы безопасности, а Volcano Ark предоставляет защитные барьеры контента, которые можно настроить на терминале для проверки входа и выхода. По умолчанию используется стандартный механизм платформы; компаниям с более тонкими политиками можно подключить сервис управления контентом Volcano Engine. Заблокированные запросы возвращают ошибку с признаком Detection, меткой проверки и ID запроса.

Но «у платформы есть барьер» не означает «у компании нет обязанности проверять». Согласно документации на момент подготовки статьи, настраиваемые барьеры в основном покрывают генерацию изображений, видео и 3D; для текстовых задач всё равно нужны фильтрация чувствительных слов, структурная проверка и ручная проверка на уровне приложения. При закупке пропишите: кто поддерживает политику проверки, как обжаловать ложное срабатывание, сколько хранятся журналы и кто реагирует на нарушения.

6. Затраты, договор и счета

Биллинг Doubao API — это не одна ставка, умноженная на токены. Переменные включают: раздельную оплату входа и выхода, ступени по длине входа у части моделей, отдельную оплату аудиовхода, цену попадания в кэш, плату за хранение кэша, цену пакетного инференса, цену дообучения и инференса, модельные единицы и инференс с низким приоритетом. У части сторонних моделей есть разница между пиковыми и непиковыми часами.

Снижайте затраты в таком порядке:

  1. Разделяйте модели: для классификации, извлечения и переписывания — лёгкая модель, для сложных рассуждений — флагманская.
  2. Сжимайте вход и стабилизируйте префикс: поиск возвращает только релевантные фрагменты, история суммируется, промпт фиксируется.
  3. Ограничивайте выход: задайте максимальную длину и требуйте структурированный результат.
  4. Переводите офлайн-задачи в пакетный режим: разметка и суммирование обычно дешевле пакетно; для нереальных по времени задач доступен низкий приоритет.
  5. Задавайте лимиты расхода: и на уровне модели, и на уровне терминала.
  6. Собирайте счета по ключам: разбивайте по API Key ID или проекту.

Корпоративную оплату рекомендуется проводить со счёта компании, сохраняя договор, заказ, платёжку и счёт. Счёт выставляется только на успешно заказанные услуги или уже сформированные начисления; неиспользованный аванс не оплачивается счётом; возврат по уже выставленной сумме требует процедуры сторнирования; ставка налога меняется с политикой, цена до налога обычно остаётся прежней. Ориентируйтесь на центр расходов.

При использовании нескольких моделей внутренний AI-шлюз может объединить счета и документы в юанях, но нужно дополнительно проверить зависимости сервиса и условия данных. Страница цены на модели — ориентир; цены меняются.

7. Приёмка пилота: две недели до решения о масштабировании

  1. Выберите реальный, но некритичный сценарий и определите четыре метрики: доля успешных задач, P95 задержки, доля 429, стоимость задачи.
  2. На бесплатной квоте или небольшой постоплате проверьте аутентификацию, потоковый вывод и коды ошибок.
  3. Выведите 5–10% трафика в канареечный режим, проверьте пиковые RPM и TPM, убедитесь в работе лимитов и оповещений.
  4. Проверьте политику безопасности контента на чувствительных образцах, зафиксируйте долю ложных срабатываний и время реагирования.
  5. Дайте юристам и службе безопасности проверить условия, соглашение об обработке данных и схему хранения журналов, сверьте счёт.
  6. Отработайте деградацию: при недоступности основной модели переключение на резервную или резервный шлюз.

Скрипт ниже — дымовой тест перед запуском: проверяет ключ, имя модели и поля расхода.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ARK_API_KEY"],
    base_url=os.environ["ARK_BASE_URL"],  # прямой адрес или шлюз — по документации
)

resp = client.chat.completions.create(
    model=os.environ["ARK_MODEL"],
    messages=[{"role": "user", "content": "Ответь только OK"}],
    max_tokens=16,
    stream=False,
)

print(resp.model)
print(resp.choices[0].message.content)
print(resp.usage)

Дымовой тест доказывает только «вызов проходит», а не «система выдерживает нагрузку». Настоящая приёмка — это доля ошибок, распределение задержек и счёт за период канареечного запуска.

Частые вопросы

Обязателен ли верифицированный корпоративный аккаунт для закупки Doubao?

Если речь о платеже со счёта компании, договоре и счетах, рекомендуется корпоративный верифицированный аккаунт. Личный подходит для проверки, но не для ведения бизнеса компании.

Можно ли использовать бесплатную квоту для производственной приёмки?

Для проверки функций — да, но как производственную ёмкость её использовать не стоит. У бесплатной квоты есть лимиты и ограничения по охвату, при исчерпании сервис приостанавливается.

Использует ли Doubao API корпоративные данные для обучения?

Условия платформы указывают, что без отдельного согласия данные не используются для обучения или улучшения, но для разных типов моделей, режима песочницы и дообучения условия могут отличаться. Ориентируйтесь на подписанный договор и официальные условия.

Кто отвечает за модерацию контента — платформа или компания?

Платформа предоставляет базовые механизмы безопасности и опциональные барьеры, но компания отвечает за вход и выход, политику проверки и реагирование на нарушения. Для текстовых приложений особенно важно добавить проверку на уровне приложения.

Как выбрать прямое подключение или AI-шлюз?

Командам, которым нужен только Doubao, уже прошедшим верификацию и с простыми финансовыми процессами, короче прямое подключение; для нескольких моделей, счетов в юанях и документов удобнее шлюз. Стоимость — на странице цены на модели.

Что дальше

Сначала проведите двухнедельный пилот, проверьте качество задач, лимиты и счета, затем определяйте объём закупки. Если нужно сравнить Doubao с другими моделями в одном интерфейсе, создайте тестовый ключ в ZSQH AI Gateway; модели, цены и условия — на странице цены на модели и в официальной документации.

Связанные статьи:

Doubao, Volcano Ark и Volcano Engine — товарные знаки ByteDance и связанных с ней компаний. Статья носит технический характер и не является юридической рекомендацией.