# Изменения API

Изменения, которые видит клиент API, новые сверху. У каждого пункта сказано, что сделать в
вашем коде.

| Дата | Что изменилось | Что сделать |
|---|---|---|
| 16.10.2026 | У картинок-результатов появилось поле `preview_url`: сжатая копия до 1600 точек для показа | Показывайте `preview_url`, если оно есть, скачивайте по `url` |
| 12.10.2026 | У задачи `completed` поле `price` бывает `null`, пока уточняется списание. Цена появится в той же задаче | Проверяйте готовность по `status`, а не по `price` |
| 11.10.2026 | Чат принимает `Idempotency-Key`: повтор с тем же телом получает ответ первого вызова, с другим — `409 idempotency_key_conflict` | Передавайте ключ и в чате, особенно через SDK, который повторяет запрос после таймаута |
| 11.10.2026 | Синхронный ответ картинок, музыки, речи и транскрибации ждёт 9 минут вместо 120 секунд | Таймаут HTTP-клиента не меньше 10 минут или `Prefer: respond-async` |
| 11.10.2026 | Потоков на аккаунт 1000 вместо 50, `POST /v1/files` до 3000 в минуту вместо 300, чтение ключом управления до 1200 в минуту отдельно от изменений | Ничего |
| 11.10.2026 | Запросы с ключом не ограничены частотой по адресу. Каталог с ключом принимает 6000 запросов в минуту на ключ | Ничего |
| 11.10.2026 | Квота файлов считает только загрузки `POST /v1/files`: 10 ГБ, после первого пополнения 50 ГБ | Ничего |
| 11.10.2026 | Тело не того типа получает `415` с `{"path": "body", "reason": "unsupported_format"}` | Передавайте `Content-Type: application/json`, у загрузок `multipart/form-data` |
| 09.10.2026 | Цвета каналов один раз переназначены: рабочие каналы модели идут с красного в порядке пресета `balanced`. Каналы прежние, история хранит цвет на момент запроса, дальше цвета не меняются | Сверьте `routing_options` аккаунта и кода с `GET /v1/models/{id}/channels` |
| 08.10.2026 | Новый код `502 unknown_error` вместо части `503 model_unavailable` | Повторяйте `unknown_error` так же, как `model_unavailable` |
| 08.10.2026 | Если каналы отказали по-разному, код называет главную причину: отказ фильтра или входных данных | Ничего |
| 08.10.2026 | Тело картинок и видео до 70 МиБ вместо 25 МиБ | Ничего |
| 07.10.2026 | Метрики канала дают число и окно замеров отдельно для задержки (`latency_samples`, `latency_window_seconds`) и скорости (`throughput_samples`, `throughput_window_seconds`). `window_seconds` равно большему окну | Читайте новые поля |
| 04.10.2026 | Повтор с `Idempotency-Key` сравнивает поля роутинга как в запросе, правка настроек между отправкой и повтором не даёт `409` | Ничего |
| 04.10.2026 | На плановых работах новые запросы получают `503 maintenance` со сроком `ends_at` вместо `502 generation_failed`. Появился `GET /v1/status` | Повторяйте после `ends_at` |
| 04.10.2026 | Пресет по умолчанию `balanced` вместо `cheap`. Аккаунты, выбравшие пресет сами, его сохранили | Для прежнего порядка передайте `routing: "cheap"` или выберите его в настройках |

**Дальше**

- [Ошибки](https://souz.ai/docs/errors.md): коды и что с ними делать.
- [Лимиты](https://souz.ai/docs/limits.md): действующие пределы.
- [Повторы](https://souz.ai/docs/idempotency.md): правила `Idempotency-Key`.

---

Оглавление документации: https://souz.ai/llms.txt. Всё руководство одним файлом: https://souz.ai/llms-full.txt. Справочник методов: https://souz.ai/docs/api-reference.md.