Семейство Doubao Seed

Текстовые модели Doubao Seed от ByteDance: Seed 2.1 Pro, Seed 2.1 Turbo, Seed Evolving и Seed Character. Они вызываются через OpenAI-совместимый API; все, кроме Seed Character, также поддерживают нативный API Anthropic, поэтому их можно использовать в Claude Code. Модели генерации изображений Doubao описаны в разделе Seedream (Doubao), видеомодели — в разделе Seedance.

Типичные задачи

Модели

Полный список моделей и актуальные цены см. на странице моделей . Префикс ID моделей — volcengine/, его можно опустить; префиксы bytedance/, doubao/ и названия моделей Volcano Engine Ark с датой вернут 404.

Эти модели предоставляет Volcano Engine (volcengine); все они поддерживают Chat Completions и Responses API.

Примеры вызова

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="volcengine/doubao-seed-2.1-pro",
    messages=[{"role": "user", "content": "Объясни одним предложением, что такое идемпотентность."}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

curl https://api.ofox.io/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volcengine/doubao-seed-2.1-pro",
    "messages": [{"role": "user", "content": "Объясни одним предложением, что такое идемпотентность."}],
    "thinking": {"type": "disabled"}
  }'

Глубокий thinking

• thinking.type поддерживает enabled и disabled; значение auto возвращает 400.
• Замеры на запросе «Объясни одним предложением, что такое идемпотентность»: Seed 2.1 Pro по умолчанию тратит на thinking около 1500 токенов и около 40 секунд, Seed Evolving — около 1700 токенов и около 54 секунд. С отключённым thinking ответ приходит примерно за 2 секунды.
• Токены thinking учитываются в max_tokens. Если лимит слишком мал, content может оказаться пустым, а finish_reason будет равен length.
• Токены thinking оплачиваются по цене вывода, их число указано в usage.completion_tokens_details.reasoning_tokens.

Чтение содержимого thinking: в потоковом ответе оно находится в delta.reasoning_content; в непотоковом — в message.reasoning_details, где нужно склеить поля text всех элементов по порядку.

Использование в Claude Code

Seed 2.1 Pro, Seed 2.1 Turbo и Seed Evolving поддерживают нативный API Anthropic по адресу https://api.ofox.io/anthropic:

• При вызове через Anthropic API без параметра thinking содержимое thinking не возвращается. Если thinking нужен, передайте "thinking": {"type": "enabled", "budget_tokens": 2000} или {"type": "adaptive"} — содержимое thinking вернётся блоками thinking.
• Seed Character не поддерживает Anthropic API: вызов возвращает protocol_not_supported.

Полный порядок настройки Claude Code см. в разделе Настройка Claude Code.

Ввод изображений и структурированный вывод

• Ввод изображений: все перечисленные модели поддерживают ввод изображений через стандартный блок содержимого image_url; подробнее см. в разделе Распознавание изображений. Ссылка на изображение должна быстро загружаться из публичной сети, иначе возвращается Timeout while downloading url; вместо ссылки можно передать данные в base64.
• Структурированный вывод: response_format поддерживает json_schema и json_object; подробнее см. в разделе Структурированный вывод.
• Вызов инструментов: используется стандартный параметр tools, возвращается tool_calls.

Типичные ошибки

Прочие общие ошибки: Обработка ошибок.

Официальная документация

• Volcano Engine Ark · Документация 

Часто задаваемые вопросы