{"schemaVersion":1,"items":[{"id":"2026-10-16","date":"2026-10-16","timezone":"Europe/Samara","title":"LLM API: контекст моделей, длинные ответы, reasoning и биллинг","url":"https://app.artillect.pro/docs/api-updates/2026-10-16.md","summary":"Сводка обновления 15–16 октября: сняты общие ограничения длины текста API, обновлены модели и reasoning, объединён расчёт оплаты, исправлены документация и генерации из ассистента.","changes":[{"area":"input_limits","description":"Снят предел 200 000 символов в chat/completions и новых сообщениях API-диалогов. Текст передаётся целиком; допустимый вход определяется токеновым контекстом модели с учётом ответа. В discovery max_input_chars и chat.max_total_chars теперь null; input_limit_basis=model_token_context. Provider также использует контекст модели. LLM API ограничивает размер HTTP JSON 8 MiB для защиты памяти сервера; это байты тела, а не символьный/токеновый лимит текста. У Provider также сохранён предел до 2048 сообщений."},{"area":"output_limits","description":"API больше не использует общий потолок 4096/32768 токенов: по умолчанию запрашивается собственный максимум вывода модели. Для Opus 5.5 он составляет 128 000 токенов, включая reasoning. Явные max_tokens/max_output_tokens соблюдаются; таймаут upstream-вызова API — 30 минут. Достижение лимита отражается в finish_reason, а ошибки провайдера и таймауты по-прежнему возможны."},{"area":"reasoning","description":"Opus 5.5 получает reasoning.effort=low, если клиент не передал настройки reasoning. Явные настройки, включая high, сохраняются. REST JSON/SSE, API-диалоги и MCP передают reasoning; поддержан алиас reasoning_effort. Native Messages использует output_config.effort. Неподдерживаемые настройки отклоняются до резерва и inference. Reasoning входит в оплачиваемый output; exclude не выключает его."},{"area":"models","description":"Добавлены gemini-4-argon, claude-sonnet-5.5, claude-haiku-5.5, gpt-6.1-sol, gpt-6.1-sol-pro, muse-wonder, mistral-large-4-0, step-5-preview, pareto-26.9, lfm-2.5-24b-a2b и ling-3.1-flash. Default Public chat — gpt-6-luna. Старые gpt-5.6-*, gpt-6-sol, claude-sonnet-5, claude-opus-5, deepseek-v4-flash, gemini-3.6-flash, grok-4.5 и muse-spark-1.2 сняты с новых вызовов. Неизвестный/снятый ID не заменяется другой моделью автоматически; актуальный список зависит от API-поверхности и публикуется в её каталоге."},{"area":"billing","description":"Studio, промпты, Public chat и Provider используют общий механизм резерва, settlement и recovery с сохранением тарифов каждой поверхности. Полный расчётный резерв берётся до inference; после получения фактической стоимости списывается оплата и возвращается неиспользованная часть. При неизвестной стоимости резерв остаётся до reconciliation; уже выполненные платные шаги не становятся бесплатными при последующей ошибке. Повторный settlement идемпотентен. Больший предел сам по себе не оплачивается, но увеличивает необходимый резерв."},{"area":"documentation","description":"Исправлена загрузка OpenAPI в /docs/. Markdown и OpenAPI обновлены. Появились публичный GET /api/v1/updates/, поле api_update в обоих каталогах моделей, заголовок X-Artillect-API-Update и Link с rel=changelog в ответах, использующих общие API-заголовки. Уведомление можно отслеживать без платного вызова модели."},{"area":"assistant_and_compatibility","description":"Существующие API-маршруты и формы ответа сохранены; поля обновления добавлены совместимо. У ассистента на сайте сохранены 4096 токенов вывода, 8000 символов пользовательского сообщения, 60 секунд на вызов и окно истории 40 сообщений/80 000 символов. Управляемые API-диалоги сохраняют прежнее окно истории 40/80 000; оно не ограничивает новое сообщение или stateless messages[]. Исправлена путаница ID оплаты ответа с ID медиа-задачи: работают подтверждение/отмена карточек изображений, видео, аудио, 3D и апскейла; старые карточки восстановлены через CI, защита от двойного запуска сохранена."}],"client_actions":["Обновите каталоги через GET /api/v1/models/ и GET /api/v1/provider/models/; замените снятые ID моделей. Обрабатывайте null в полях символьных лимитов как отсутствие общего char-cap.","Уберите клиентские ограничения в 200 000 символов и устаревшие output caps, если нужны длинные ответы. Не задавайте маленький max_tokens автоматически: мы соблюдаем явно переданный предел.","Для Opus можно не передавать reasoning (получится low) или явно задать reasoning: {effort: high}. Не передавайте одновременно reasoning.effort и reasoning_effort. Увеличивайте общий output budget с учётом рассуждений.","Проверяйте finish_reason: length означает исчерпание output budget. Настройте клиентские/прокси-таймауты для длинных ответов и учитывайте токеновый контекст модели, включая output. Для полного контроля истории используйте stateless messages[] или Provider.","Учитывайте полный предварительный резерв. При недостаточном балансе можно явно уменьшить output budget. Не повторяйте автоматически оплаченный или неопределённый вызов после разрыва соединения; используйте доступные idempotency/status-механизмы соответствующего API.","Сравнивайте api_update.id или X-Artillect-API-Update с сохранённой версией и перечитывайте URL уведомления при изменении. Новые поля discovery нужно игнорировать, если клиент их ещё не использует."],"href":"/knowledge/updates/2026-10-16/","publication":{"kind":"legacy_publication","observedAt":"2026-10-21T13:57:23.391Z"},"audiences":["developer","agent"],"actionRequired":null,"related":[],"markdown":"# LLM API: контекст моделей, длинные ответы, reasoning и биллинг\n\nДата: 2026-10-16 (Europe/Samara). ID: `2026-10-16`.\n\nСводка обновления 15–16 октября: сняты общие ограничения длины текста API, обновлены модели и reasoning, объединён расчёт оплаты, исправлены документация и генерации из ассистента.\n\n## Что изменилось\n\n### input_limits\n\nСнят предел 200 000 символов в chat/completions и новых сообщениях API-диалогов. Текст передаётся целиком; допустимый вход определяется токеновым контекстом модели с учётом ответа. В discovery max_input_chars и chat.max_total_chars теперь null; input_limit_basis=model_token_context. Provider также использует контекст модели. LLM API ограничивает размер HTTP JSON 8 MiB для защиты памяти сервера; это байты тела, а не символьный/токеновый лимит текста. У Provider также сохранён предел до 2048 сообщений.\n\n### output_limits\n\nAPI больше не использует общий потолок 4096/32768 токенов: по умолчанию запрашивается собственный максимум вывода модели. Для Opus 5.5 он составляет 128 000 токенов, включая reasoning. Явные max_tokens/max_output_tokens соблюдаются; таймаут upstream-вызова API — 30 минут. Достижение лимита отражается в finish_reason, а ошибки провайдера и таймауты по-прежнему возможны.\n\n### reasoning\n\nOpus 5.5 получает reasoning.effort=low, если клиент не передал настройки reasoning. Явные настройки, включая high, сохраняются. REST JSON/SSE, API-диалоги и MCP передают reasoning; поддержан алиас reasoning_effort. Native Messages использует output_config.effort. Неподдерживаемые настройки отклоняются до резерва и inference. Reasoning входит в оплачиваемый output; exclude не выключает его.\n\n### models\n\nДобавлены gemini-4-argon, claude-sonnet-5.5, claude-haiku-5.5, gpt-6.1-sol, gpt-6.1-sol-pro, muse-wonder, mistral-large-4-0, step-5-preview, pareto-26.9, lfm-2.5-24b-a2b и ling-3.1-flash. Default Public chat — gpt-6-luna. Старые gpt-5.6-*, gpt-6-sol, claude-sonnet-5, claude-opus-5, deepseek-v4-flash, gemini-3.6-flash, grok-4.5 и muse-spark-1.2 сняты с новых вызовов. Неизвестный/снятый ID не заменяется другой моделью автоматически; актуальный список зависит от API-поверхности и публикуется в её каталоге.\n\n### billing\n\nStudio, промпты, Public chat и Provider используют общий механизм резерва, settlement и recovery с сохранением тарифов каждой поверхности. Полный расчётный резерв берётся до inference; после получения фактической стоимости списывается оплата и возвращается неиспользованная часть. При неизвестной стоимости резерв остаётся до reconciliation; уже выполненные платные шаги не становятся бесплатными при последующей ошибке. Повторный settlement идемпотентен. Больший предел сам по себе не оплачивается, но увеличивает необходимый резерв.\n\n### documentation\n\nИсправлена загрузка OpenAPI в /docs/. Markdown и OpenAPI обновлены. Появились публичный GET /api/v1/updates/, поле api_update в обоих каталогах моделей, заголовок X-Artillect-API-Update и Link с rel=changelog в ответах, использующих общие API-заголовки. Уведомление можно отслеживать без платного вызова модели.\n\n### assistant_and_compatibility\n\nСуществующие API-маршруты и формы ответа сохранены; поля обновления добавлены совместимо. У ассистента на сайте сохранены 4096 токенов вывода, 8000 символов пользовательского сообщения, 60 секунд на вызов и окно истории 40 сообщений/80 000 символов. Управляемые API-диалоги сохраняют прежнее окно истории 40/80 000; оно не ограничивает новое сообщение или stateless messages[]. Исправлена путаница ID оплаты ответа с ID медиа-задачи: работают подтверждение/отмена карточек изображений, видео, аудио, 3D и апскейла; старые карточки восстановлены через CI, защита от двойного запуска сохранена.\n\n## Что изменить в интеграции\n\n1. Обновите каталоги через GET /api/v1/models/ и GET /api/v1/provider/models/; замените снятые ID моделей. Обрабатывайте null в полях символьных лимитов как отсутствие общего char-cap.\n\n2. Уберите клиентские ограничения в 200 000 символов и устаревшие output caps, если нужны длинные ответы. Не задавайте маленький max_tokens автоматически: мы соблюдаем явно переданный предел.\n\n3. Для Opus можно не передавать reasoning (получится low) или явно задать reasoning: {effort: high}. Не передавайте одновременно reasoning.effort и reasoning_effort. Увеличивайте общий output budget с учётом рассуждений.\n\n4. Проверяйте finish_reason: length означает исчерпание output budget. Настройте клиентские/прокси-таймауты для длинных ответов и учитывайте токеновый контекст модели, включая output. Для полного контроля истории используйте stateless messages[] или Provider.\n\n5. Учитывайте полный предварительный резерв. При недостаточном балансе можно явно уменьшить output budget. Не повторяйте автоматически оплаченный или неопределённый вызов после разрыва соединения; используйте доступные idempotency/status-механизмы соответствующего API.\n\n6. Сравнивайте api_update.id или X-Artillect-API-Update с сохранённой версией и перечитывайте URL уведомления при изменении. Новые поля discovery нужно игнорировать, если клиент их ещё не использует.\n\n## Пример явного high для Opus\n\n```json\n{\n  \"model\": \"claude-opus-5.5\",\n  \"reasoning\": { \"effort\": \"high\" },\n  \"messages\": [{ \"role\": \"user\", \"content\": \"Подготовь подробный промпт для видео\" }]\n}\n```\n\nКаталоги: [Public API](/api/v1/models/), [Provider](/api/v1/provider/models/) (нужен API-ключ). [Обновления JSON](/api/v1/updates/). [OpenAPI](/docs/artillect-openapi.yaml). [API reference](/docs/).\n\n"},{"id":"cli-history-2026","title":"Август 2026 · CLI и развитие клиентских контрактов","summary":"Ретроспектива: в августе появился отдельный CLI для терминала. Затем развивались общие контракты моделей, параметров и работы с проектами для программных клиентов.","audiences":["developer","agent"],"changes":[{"area":"Командная строка","description":"CLI добавил отдельный путь работы из терминала: вход в аккаунт, просмотр моделей и запуск генерации. Руководство CLI помогает установить клиент и получить готовый результат."},{"area":"Общие возможности","description":"К концу августа расширялись общие клиентские контракты: параметры моделей, проекты, элементы и получение результатов. Возможности продолжают развиваться; доступные модели и идентификаторы нужно проверять для выбранного подключения."}],"client_actions":["Откройте руководство CLI; перед запуском проверьте выбранную модель, её входы и цену."],"actionRequired":false,"related":[{"id":"docs-cli","title":"CLI","href":"/docs/cli","markdownHref":"/docs/artillect-cli.md"},{"id":"docs-features","title":"Возможности и правила","href":"/docs/features","markdownHref":"/docs/artillect-features.md"},{"id":"api-guide","title":"Public API v1","href":"/docs/api/","markdownHref":"/docs/artillect-api.md"}],"href":"/knowledge/updates/cli-history-2026/","url":"/knowledge/updates/cli-history-2026/index.md/","date":"2026-10-22","timezone":"Europe/Samara","publication":{"kind":"reviewed_release","releasedAt":"2026-10-22T11:28:31Z","publishedAt":"2026-10-22T11:47:54.278Z"},"markdown":"# Август 2026 · CLI и развитие клиентских контрактов\n\nРетроспектива: в августе появился отдельный CLI для терминала. Затем развивались общие контракты моделей, параметров и работы с проектами для программных клиентов.\n\nДля кого: Разработчикам, Для агентов.\n\n## Что изменилось\n\n- **Командная строка:** CLI добавил отдельный путь работы из терминала: вход в аккаунт, просмотр моделей и запуск генерации. Руководство CLI помогает установить клиент и получить готовый результат.\n\n- **Общие возможности:** К концу августа расширялись общие клиентские контракты: параметры моделей, проекты, элементы и получение результатов. Возможности продолжают развиваться; доступные модели и идентификаторы нужно проверять для выбранного подключения.\n\n## Что можно сделать\n\n- Откройте руководство CLI; перед запуском проверьте выбранную модель, её входы и цену.\n\n## Подробнее\n\n- [CLI](/docs/artillect-cli.md)\n\n- [Возможности и правила](/docs/artillect-features.md)\n\n- [Public API v1](/docs/artillect-api.md)\n\nОпубликовано: 22 октября 2026 г.. Выпуск: 22 октября 2026 г. (Europe/Samara).\n","retrospectivePeriod":"2026-08"},{"id":"mcp-history-2026","title":"Июль 2026 · Начало MCP-подключения","summary":"Ретроспектива: в конце июля началось развитие MCP-сервера для работы с Artillect из агентских клиентов. Сегодня подключение и доступные инструменты описаны в отдельном руководстве.","audiences":["developer","agent"],"changes":[{"area":"Первые инструменты","description":"Первый MCP-сервер использовал Public API и транспорт stdio. Агент мог обращаться к возможностям платформы через инструменты своего клиента. Это ранний этап развития, а не дата запуска нынешнего удалённого подключения."},{"area":"Как подключаться сейчас","description":"Поддерживаемый способ подключения, авторизацию и работу с файлами смотрите в текущем MCP-руководстве. Старые команды установки и настройки не нужно переносить автоматически."}],"client_actions":["Откройте руководство MCP и выберите подключение для своего агентского клиента."],"actionRequired":false,"related":[{"id":"docs-mcp","title":"Подключение MCP","href":"/docs/mcp","markdownHref":"/docs/mcp/index.md"},{"id":"knowledge-user-files-and-delivery","title":"Файлы пользователя и доставка","href":"/knowledge/guides/user-files-and-delivery/","markdownHref":"/docs/knowledge/guides/user-files-and-delivery.md"}],"href":"/knowledge/updates/mcp-history-2026/","url":"/knowledge/updates/mcp-history-2026/index.md/","date":"2026-10-22","timezone":"Europe/Samara","publication":{"kind":"reviewed_release","releasedAt":"2026-10-22T11:28:31Z","publishedAt":"2026-10-22T11:47:54.278Z"},"markdown":"# Июль 2026 · Начало MCP-подключения\n\nРетроспектива: в конце июля началось развитие MCP-сервера для работы с Artillect из агентских клиентов. Сегодня подключение и доступные инструменты описаны в отдельном руководстве.\n\nДля кого: Разработчикам, Для агентов.\n\n## Что изменилось\n\n- **Первые инструменты:** Первый MCP-сервер использовал Public API и транспорт stdio. Агент мог обращаться к возможностям платформы через инструменты своего клиента. Это ранний этап развития, а не дата запуска нынешнего удалённого подключения.\n\n- **Как подключаться сейчас:** Поддерживаемый способ подключения, авторизацию и работу с файлами смотрите в текущем MCP-руководстве. Старые команды установки и настройки не нужно переносить автоматически.\n\n## Что можно сделать\n\n- Откройте руководство MCP и выберите подключение для своего агентского клиента.\n\n## Подробнее\n\n- [Подключение MCP](/docs/mcp/index.md)\n\n- [Файлы пользователя и доставка](/docs/knowledge/guides/user-files-and-delivery.md)\n\nОпубликовано: 22 октября 2026 г.. Выпуск: 22 октября 2026 г. (Europe/Samara).\n","retrospectivePeriod":"2026-07"},{"id":"public-api-history-2026","title":"Июнь 2026 · Public API","summary":"Ретроспектива: Public API развивался уже в июне 2026. Программный запуск генерации, получение статуса и работа с результатом появились задолго до последних уведомлений в этой ленте.","audiences":["developer","agent"],"changes":[{"area":"Июнь: ключ и генерация","description":"В июньской версии API уже были получение ключа, запуск изображения и ожидание результата по идентификатору задачи. Запросы использовали аккаунт и баланс Artillect."},{"area":"Дальнейшее развитие","description":"В конце июня и июле API расширялся: добавлялись чат, новые модели изображений и видео. Текущие параметры и ограничения смотрите в актуальной документации, а не в старых примерах."}],"client_actions":["Начните с технической документации, выберите API и откройте актуальный каталог моделей."],"actionRequired":false,"related":[{"id":"api-guide","title":"Public API v1","href":"/docs/api/","markdownHref":"/docs/artillect-api.md"},{"id":"docs-features","title":"Возможности и правила","href":"/docs/features","markdownHref":"/docs/artillect-features.md"}],"href":"/knowledge/updates/public-api-history-2026/","url":"/knowledge/updates/public-api-history-2026/index.md/","date":"2026-10-22","timezone":"Europe/Samara","publication":{"kind":"reviewed_release","releasedAt":"2026-10-22T11:28:31Z","publishedAt":"2026-10-22T11:47:54.278Z"},"markdown":"# Июнь 2026 · Public API\n\nРетроспектива: Public API развивался уже в июне 2026. Программный запуск генерации, получение статуса и работа с результатом появились задолго до последних уведомлений в этой ленте.\n\nДля кого: Разработчикам, Для агентов.\n\n## Что изменилось\n\n- **Июнь: ключ и генерация:** В июньской версии API уже были получение ключа, запуск изображения и ожидание результата по идентификатору задачи. Запросы использовали аккаунт и баланс Artillect.\n\n- **Дальнейшее развитие:** В конце июня и июле API расширялся: добавлялись чат, новые модели изображений и видео. Текущие параметры и ограничения смотрите в актуальной документации, а не в старых примерах.\n\n## Что можно сделать\n\n- Начните с технической документации, выберите API и откройте актуальный каталог моделей.\n\n## Подробнее\n\n- [Public API v1](/docs/artillect-api.md)\n\n- [Возможности и правила](/docs/artillect-features.md)\n\nОпубликовано: 22 октября 2026 г.. Выпуск: 22 октября 2026 г. (Europe/Samara).\n","retrospectivePeriod":"2026-06"}]}