Настройка API-провайдеров

AIKraft Agents поддерживает несколько API-провайдеров через встроенную систему пресетов. Вы можете подключиться к Anthropic напрямую, использовать агрегаторы вроде OpenRouter, запускать локальные модели через Ollama или указать любой API-эндпоинт, совместимый с форматом Anthropic Messages.

Эта страница охватывает совместимых с Anthropic провайдеров. Для подключений Codex/OpenAI и настройки нескольких соединений см. LLM-подключения.

Поддерживаемые провайдеры

Настройка провайдера

При первом запуске

1. В мастере настройки выберите API Key.
2. Введите ваш API-ключ.
3. Выберите пресет Base URL из выпадающего списка (Anthropic, OpenRouter, Vercel AI Gateway или Custom).
4. Опционально укажите имя Model (обязательно для не-Anthropic провайдеров).
5. Соединение проверяется автоматически перед сохранением.

В настройках

1. Откройте Settings (значок шестерёг или Cmd + ,).
2. Нажмите на секцию API Connection.
3. Измените API-ключ, базовый URL или модель по необходимости.

Имена моделей

Для Anthropic не требуется переопределение модели — AIKraft Agents автоматически использует встроенную маршрутизацию моделей (Sonnet, Opus, Haiku).

Для OpenRouter и Vercel AI Gateway модели используют формат provider/model-name:

anthropic/claude-sonnet-4
anthropic/claude-opus-4
openai/gpt-4o
google/gemini-2.5-pro
meta-llama/llama-4-maverick

Для Ollama используйте локальное имя модели напрямую:

llama3.2
qwen3-coder
deepseek-r1

Если поле Model оставлено пустым для не-Anthropic провайдеров, AIKraft Agents по умолчанию использует форматирование имён моделей Anthropic. Это работает для провайдеров, поддерживающих имена моделей Anthropic нативно, но может не работать для всех провайдеров.

Подробности о провайдерах

OpenRouter

OpenRouter предоставляет доступ к сотням AI-моделей через один API-ключ. Он обрабатывает биллинг, ограничения скорости и резервные варианты между провайдерами.

1. Получите ваш API-ключ на openrouter.ai/keys.
2. Выберите пресет OpenRouter в выпадающем списке Base URL.
3. Установите модель (например, anthropic/claude-sonnet-4).

Просмотр доступных моделей на openrouter.ai/models.

Ollama (локальные модели)

Ollama запускает открытые модели локально на вашем компьютере. API-ключ не требуется, и данные никогда не покидают ваш компьютер.

Требования:

• Ollama 0.14 или новее (для совместимого с Anthropic формата API)
• Модель, загруженная локально

# Установка и загрузка модели
ollama pull llama3.2

Для подключения:

1. Выберите пресет Custom в выпадающем списке Base URL.
2. Введите http://localhost:11434 как URL.
3. Оставьте API-ключ пустым.
4. Установите имя модели (например, llama3.2).

Ollama требует версии 0.14+ для совместимости с AIKraft Agents. Более ранние версии не поддерживают формат Anthropic Messages API. Обновите с помощью ollama update, если необходимо.

Vercel AI Gateway

Vercel AI Gateway предоставляет единый эндпоинт для маршрутизации запросов к нескольким AI-провайдерам с встроенной наблюдаемостью и кэшированием.

1. Получите ваш API-ключ из вашей панели Vercel.
2. Выберите пресет Vercel AI Gateway.
3. Установите модель, используя формат provider/model-name.

См. поддерживаемые модели в документации Vercel.

Custom Endpoint

Для любого API, реализующего формат Anthropic Messages:

1. Выберите пресет Custom.
2. Введите полный базовый URL вашего эндпоинта.
3. Введите ваш API-ключ (если требуется).
4. Укажите имя модели, которое ожидает ваш эндпоинт.

Это работает с самостоятельно размещёнными прокси, корпоративными шлюзами или любым сервисом, реализующим эндпоинт /v1/messages.

Вход изображений для Custom Endpoints

Custom endpoints по умолчанию только для текста. Если ваш эндпоинт обслуживает мультимодальную модель — например, Gemma 4 через Ollama или другой OpenAI-совместимый прокси — вы должны явно включить поддержку изображений. Нет автоматического обнаружения возможностей: модель, которая молча удаляет изображения, может давать запутанные ответы (пользователь видит изображение в своём сообщении, но модель его не получает).

Переключение из чата (рекомендуется)

Для повседневного использования включите вход изображений прямо из выбора модели в чате:

1. Откройте выпадающий список моделей над полем ввода чата.
2. Каждая строка модели на подключении custom-endpoint (pi_compat) отображает маленькую иконку изображения справа. Иконка бледная, когда вход изображений отключён, яркая, когда включён.
3. Нажмите на иконку, чтобы переключить переопределение supportsImages для конкретной модели. Изменение сохраняется автоматически в вашей конфигурации.

Если вы прикрепите изображение, пока активная модель всё ещё текстовая, появится встроенный баннер проверки перед отправкой над полем ввода чата с однокликовым действием Включить поддержку изображений. Нажатие на него переключает то же самое переопределение и удаляет баннер — не нужно повторно прикреплять изображение.

Переключатель в выборе и баннер проверки записывают только на уровне моделей переопределения (models[i].supportsImages). Широкозадействующее значение по умолчанию (customEndpoint.supportsImages) устанавливается через JSON-конфигурацию — см. ниже.

JSON-конфигурация (автоматизация / продвинутая)

Для бесголовых настроек, скриптов автоматизации или когда вы хотите, чтобы все модели на эндпоинте были мультимодальными одновременно, запишите конфигурацию соединения напрямую. Эти примеры используют низкоуровневую схему LLM-подключения из LLM Connections, где customEndpoint.api выбирает формат проводового интерфейса эндпоинта.

Опция на уровне модели

{
  "customEndpoint": { "api": "openai-completions" },
  "models": [
    { "id": "gemma4", "supportsImages": true }
  ]
}

Опция на уровне всего эндпоинта

{
  "customEndpoint": {
    "api": "openai-completions",
    "supportsImages": true
  }
}

Переопределения на уровне моделей имеют приоритет над широкозадействующим значением по умолчанию, поэтому вы можете отключить конкретную модель от vision (supportsImages: false), даже если значение по умолчанию эндпоинта равно true.

Для полной схемы конфигурации см. LLM Connections.

Как это работает

Когда вы настраиваете нестандартного провайдера, AIKraft Agents сохраняет:

• API-ключ в зашифрованном файле учётных данных (~/.craft-agent/credentials.enc)
• Базовый URL и модель по умолчанию в конфигурации LLM-подключения

При запуске сессии базовый URL передаётся через переменную окружения ANTHROPIC_BASE_URL в базовый SDK Claude Code.

Устранение неполадок

Тест соединения не проходит

Проверьте:

• Базовый URL правильный и доступный с вашего компьютера
• Ваш API-ключ действителен и имеет достаточные разрешения
• Эндпоинт поддерживает формат Anthropic Messages API (/v1/messages)

Ошибки «модель не найдена»

Убедитесь, что имя модели точно соответствует тому, что ожидает ваш провайдер:

• OpenRouter/Vercel: Используйте формат provider/model-name (например, anthropic/claude-sonnet-4)
• Ollama: Используйте локальное имя модели (например, llama3.2)
• Custom: Проверьте документацию вашего провайдера для допустимых идентификаторов моделей

Ошибки аутентификации

• Убедитесь, что ваш API-ключ правильный и не истёк
• Для Ollama: не должно быть установлено API-ключа (оставьте пустым)
• Проверьте, есть ли у вашего ключа доступные кредиты/квоты

Ollama не подключается

• Проверьте, запущен ли Ollama: ollama list
• Проверьте версию 0.14+: ollama --version
• Убедитесь, что модель загружена: ollama pull llama3.2
• Проверьте, что URL равен http://localhost:11434 (обратите внимание: HTTP, а не HTTPS)

Ограничение скорости

Если вы столкнулись с ограничениями скорости, проверьте лимиты использования вашего провайдера и рассмотрите возможность обновления тарифного плана или использования другого провайдера.

Безопасность

Ваш API-ключ хранится безопасно в зашифрованном файле учётных данных. Подробности о том, как защищаются учётные данные, см. в разделе Credentials.

Базовый URL и имя модели хранятся в конфигурации LLM-подключения (не зашифрованы, так как не являются конфиденциальными).