Использование SeedRouter из ИИ-агентов

Агент может использовать SeedRouter тремя способами. У них общие API-ключ, баланс, модели и ограничения, а тарификация одинакова.

Чтобы запустить самого агента на текстовых моделях SeedRouter, см. раздел Агенты для написания кода на SeedRouter.

Однократная настройка ключа

Создайте ключ на странице API-ключей и экспортируйте его, чтобы агент мог считать ключ, не сохраняя его в файлах проекта:

export SEEDROUTER_API_KEY=YOUR_API_KEY

На странице API-ключей также есть кнопка Подключить через MCP, которая выводит готовую конфигурацию для каждого клиента MCP.

Что агент делает в SeedRouter

1. Находит модель: через list_models по MCP или список моделей в /llms.txt. У каждой модели с отдельной страницей есть сводка в обычном тексте по адресу https://seedrouter.ai/models/<slug>/llms.txt с параметрами, ценами и примерами.
2. Читает схему входных данных: через get_model_schema по MCP или на странице документации модели.
3. Использует общедоступные URL медиафайлов: эндпоинты генерации принимают референсные изображения, видео и аудио только как общедоступные URL http(s). Входные данные в Base64 отклоняются, поэтому сначала разместите локальные файлы по доступному извне адресу.
4. Проверяет цену: get_pricing по MCP возвращает актуальные тарифы модели в USD до отправки задачи.
5. Отправляет и ждёт: вызывает submit_task, затем get_task с wait_seconds: 50, пока задача не завершится. При работе через HTTP отправляйте запрос на эндпоинт модели и опрашивайте GET /v1/tasks/{id} примерно каждые три секунды.

Неуспешные задачи не тарифицируются. Отправка не является идемпотентной: повторение запроса, ответ на который вы не получили, создаёт вторую задачу и приводит к ещё одному списанию, поэтому сначала проверьте историю задач или баланс.

Ограничения, которые нужно учитывать

Частота запросов также может быть ограничена, что тоже приводит к HTTP 429. При HTTP 429 выждите время, указанное в Retry-After, если этот заголовок есть; в противном случае увеличивайте задержку экспоненциально, добавляя случайное отклонение и ограничивая максимальное время ожидания. Принимайте решение по коду состояния, а не разбирая тела ошибок, поскольку текстовые эндпоинты возвращают ошибки в формате своего протокола. Для пакетной обработки используйте очередь и отправляйте новые задачи по мере завершения текущих, а не все сразу. Если нужен более высокий лимит, напишите на [email protected].

Машиночитаемые точки входа