Различия параметров и протоколов Doubao

Узнайте об отличиях параметров и использовании Doubao с совместимыми протоколами.

Для Doubao настройте параметры по этой странице. Структуры: Chat Completions, Responses, Messages.

Модели

Модель	Область применения
doubao-seed-2-1-lite-260915, doubao-seed-evolving, doubao-seed-2-1-pro-260915	Все поддерживают три протокола; общие правила мыслей/инструментов, аудио только в рамках Lite
doubao-seed-evolving	Постоянно обновляемый ID, не эквивалент датированной Pro; сохраняйте конфигурацию в Session

Отличия Chat Completions

Поле	Отличие
`thinking.type`	Поддерживается `enabled/disabled`, рассуждение включено
`reasoning_effort`	По умолчанию `high`; уровни `low/medium/high`, `minimal` выключает; `none` в `minimal`, `xhigh/max` в `high`
`max_tokens`	По умолчанию `4096`, только ответ без мыслей, не общий бюджет
`max_completion_tokens`	Включает мысли/ответ, официальный диапазон Chat `1～65536`, несовместим с `max_tokens`; не максимум из спецификации модели
`temperature`, `top_p`	Диапазоны `[0,2]`, `[0,1]`; не фиксированная температура `1` старых Seed 2.0
`frequency_penalty`, `presence_penalty`	Seed 2.0 и новее не поддерживают; ограничение возможностей, не устаревание
`stop`, `logprobs`	По умолчанию недоступно моделям глубокого рассуждения; ни одна из трёх не в исключениях
`reasoning_content`, `encrypted_content`	По умолчанию сводка и зашифрованный оригинал. Для инструментов передавайте `encrypted_content` неизменным; сводка не замена, шифротекст приоритетен при обоих
`stream_options.chunk_include_usage`	По умолчанию `false`; `true` возвращает накопительное usage в каждом блоке, не суммируйте его повторно
`stream_options.include_usage`	Контролирует итоговый блок usage; Lite возвращает по умолчанию, остальные требуют включения. Накопительное по блокам и общий итог — разные настройки
`response_format`	Поддерживается `json_object/json_schema`, сохраняется статус Beta; `strict: true` ограничивает поддерживаемое подмножество, не все ключевые слова JSON Schema

Отличия Responses

Поле	Отличие
`reasoning.effort`	Используйте `minimal/low/medium/high` и преобразования, умолчание как Chat; не верхнеуровневое поле
`max_output_tokens`	Мысли и ответ вместе; не бюджет ответа или лимиты Chat
`text.format`	JSON Schema в `text.format` с `name/schema/strict`, не вложенная структура Qwen `text.format.json_schema`
`store`, `previous_response_id`	`store` по умолчанию `true`; реальный ID продолжает историю и мысли, предыдущие `instructions` не наследуются
Ручная передача истории	Без ID передавайте все reasoning, сообщения и инструменты; не заменяйте шифротекст сводкой
`max_tool_calls`	Диапазон `1～10`, ограничивает раунды встроенных инструментов, не вызовы внутри раунда; рекомендательное ограничение, не строгий максимум функций
`service_tier`, `store`	В нативном режиме `flex`, `store` только `false`; серверное хранение одновременно недоступно

Отличия Messages

Поле	Отличие
`max_tokens`	По спецификации необязательно, не как Claude; примеры явно задают бюджет
`output_config.effort`	Управляет глубиной по умолчаниям и преобразованиям модели; не переносите корневое поле Chat
`output_format`	Верхнеуровневое расширение с `text/json_object/json_schema`; Schema в `output_format.schema`, не `output_config.format` Claude
`temperature`, `top_p`	Диапазоны `[0,2]`, `[0,1]`, включая допустимое `top_p: 0`
`stop_sequences`	Общее поле принимает строку/массив, но глубокое рассуждение по умолчанию не поддерживает; наличие поля не гарантирует остановку
История блоков thinking	Передавайте полные реальные `thinking`, `signature`, сохраняя значения/порядок; не создавайте подписи и историю из сводок

Отличия кеша

Поле	Отличие
Неявный кеш	Chat / Responses автоматически и неотключаемо; префикс минимум `1024 Token` должен совпадать, попадания не гарантированы
`prompt_cache_key`	Подсказка маршрутизации Chat / Responses, стабильная в диалоге; одинаковый ключ не гарантирует экземпляр или попадание
Responses `caching`	Нативный явный кеш включается `type: "enabled"`; `prefix: true` пишет лишь префикс без ответа, `false` генерирует и пишет
Ограничения сочетаний `caching`	Не сочетать с `instructions` или `tools` не типа Function; не TTL / Header Session другого поставщика
Использование кеша	Chat `usage.prompt_tokens_details.cached_tokens`; Responses `usage.input_tokens_details.cached_tokens`; Messages реальные `usage.cache_read_input_tokens`, `usage.cache_creation_input_tokens`

Отличия мультимедийного ввода

Ввод	Блок протокола	Отличие
Изображение	`image_url`	Chat: URL / Base64 Data URL в `image_url.url`, детализация в `image_url.detail`
Видео	`video_url`	Chat: видео в `video_url.url`; `fps` внутри `video_url`, рядом с `url`
PDF	`file`	Chat: один из `file.file_url/file_data/file_id`; пока только PDF
Аудио	`input_audio`	Только Lite, Chat: один из `input_audio.url/data/file_id`; `data` чистый Base64, также `format`
Изображение	`input_image`	Responses: строка `image_url` или нативный ID, не объект Chat
Видео	`input_video`	Responses: адрес видео строкой `video_url`, `fps` в том же блоке
PDF	`input_file`	Responses: `file_url/file_data/file_id`; URL / Base64 файлы до `50 MB`
Аудио	`input_audio`	Только Lite, Responses: URL / Base64 Data URL в `audio_url` либо нативный ID; не `input_audio.data` Chat
Изображение	`image`	Messages: URL через `source` либо `media_type`, чистый Base64 `data`
PDF	`document`	Messages: PDF через `source` в document, не блок Chat `file`

Поле	Отличие
`fps`	Диапазон `0.2～5`, по умолчанию `1`; расположение Chat / Responses различается, см. выше
Аудио Lite	Файл аудио до `25 MB`, суммарное чисто аудио за запрос до `120 минут`; ввод через Chat / Responses
Медиа Evolving	Изображения, видеоряд, документы поддерживаются; звук и аудиодорожка видео — нет
Нативный ID файла	Из Ark Files API, связан с проектом загрузки и типом; не обещание аналогичного API AGTCloud

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

Замените MODEL_ID полным ID и используйте свой API Key.

curl 'https://api.agtcloud.ai/v1/chat/completions' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Объясните в трёх пунктах, как диагностировать тайм-аут API"}],
    "reasoning_effort": "low",
    "max_completion_tokens": 4096
  }'