provod.ai / docs
Интеграции

Подключение инструментов разработки

Настройка Cline, Roo Code, Kilo Code, Continue, Aider, Zed и Cursor для API provod.ai.

Обновлено

Проверьте совместимость

В этих инструментах поставщик — это сохранённое подключение с адресом API, ключом и параметрами моделей.

ИнструментИнтерфейс или путь к настройкамСтатус и важная особенность
ClineOpenAI Compatible в настройках VS CodeСовместимо; точный идентификатор из каталога вводится вручную.
Roo CodeSettings → Providers → OpenAI CompatibleСовместимо; удалите старый выбор встроенной модели.
Kilo CodeProviders → OpenAI CompatibleСовместимо; явно выберите пользовательское подключение.
ContinueЛокальный config.yaml, поставщик openaiТолько Chat Completions; оставьте useResponsesApi: false.
AiderПеременные окружения оболочкиСовместимо; передавайте идентификатор из каталога как openai/<catalog-id>.
Zedsettings.json и системное хранилище ключейСовместимо; создавайте идентификатор и лимит модели из актуального каталога.
CursorOverride OpenAI Base URLЗависит от версии; продолжайте, только если поле доступно.
Claude CodeОтдельное руководствоСовместимо через Anthropic Messages; базовый URL указывается без /v1.
OpenCodeОтдельное руководствоСовместимо через установщик или ручное подключение.
Codex CLIСтатус поддержкиНе поддерживается, пока отсутствует необходимый адрес /v1/responses.

Сначала выберите и проверьте модель

Совместимые с OpenAI инструменты на этой странице используют общие значения:

ЗначениеНастройка
Базовый URLhttps://api.provod.ai/v1
Ключ APIКлюч, созданный в кабинете
Идентификатор моделиДоступный точный id из текущего каталога

Выполните команду в оболочке с установленными curl и jq. Проверка требует доступную текстовую модель с поддержкой tools и используемого в запросе параметра max_tokens, а также исключает записи для графических адресов:

Terminal
set -euo pipefail

export PROVOD_API_KEY="sk_..."

if ! MODELS_JSON="$(
  curl --fail-with-body --silent --show-error "https://api.provod.ai/v1/models?output_modalities=text&supported_parameters=tools,max_tokens" \
    -H "Authorization: Bearer $PROVOD_API_KEY"
)"; then
  printf '%s\n' "$MODELS_JSON" >&2
  exit 1
fi

if ! PROVOD_MODEL="$(
  jq -er '
    first(
      .data[]
      | select(
          .available == true
          and ((.architecture.output_modalities // []) | index("text"))
          and ((.supported_parameters // []) | index("tools"))
          and ((.supported_parameters // []) | index("max_tokens"))
          and ((.supported_endpoint_types // []) | all(. != "image-generation" and . != "image-edit"))
        )
      | .id
    )
  ' <<<"$MODELS_JSON"
)"; then
  printf 'No available tool-capable text model found in /v1/models.\n' >&2
  exit 1
fi

export PROVOD_MODEL

jq -n --arg model "$PROVOD_MODEL" '{
  model: $model,
  messages: [{role: "user", content: "Reply with ok"}],
  max_tokens: 64
}' | curl --fail-with-body --silent --show-error https://api.provod.ai/v1/chat/completions \
  -H "Authorization: Bearer $PROVOD_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @-

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

Защищайте ключ API

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

Настройте инструменты Chat Completions

Cline, Roo Code и Kilo Code

Откройте указанный в таблице интерфейс и введите https://api.provod.ai/v1, значение переменной PROVOD_API_KEY и точный PROVOD_MODEL, выбранный выше. Выполните одну короткую задачу до включения инструментов и длинных агентских заданий. Если прямой запрос успешен, а расширение не работает, снова выберите пользовательское подключение и удалите старую встроенную модель, которая его перекрывает.

Continue

Добавьте запись модели OpenAI в защищённый локальный файл настроек Continue. Вставьте текущее значение PROVOD_API_KEY в apiKey, замените значение модели на PROVOD_MODEL и оставьте useResponsesApi: false:

YAML
name: provod.ai
version: 1.0.0
schema: v1
models:
  - name: provod.ai
    provider: openai
    model: model-id-from-PROVOD_MODEL
    apiBase: https://api.provod.ai/v1
    apiKey: paste-value-from-PROVOD_API_KEY
    useResponsesApi: false
    roles:
      - chat
      - edit
      - apply

Выберите эту запись и убедитесь, что клиент вызывает /v1/chat/completions, а не /v1/responses.

Aider

После выбора модели по инструкции выше задайте совместимые с OpenAI переменные Aider и добавьте префикс openai/ к точному идентификатору из каталога:

Terminal
export OPENAI_API_KEY="$PROVOD_API_KEY"
export OPENAI_API_BASE="https://api.provod.ai/v1"

aider --model "openai/$PROVOD_MODEL"

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

Zed

Используйте сохранённый при выборе модели объект MODELS_JSON, чтобы создать полный объект language_models по актуальной доступной текстовой модели с поддержкой инструментов и её текущему context_length. Добавленная возможность заставляет Zed отправлять опубликованный для модели параметр max_tokens вместо стандартного max_completion_tokens:

Terminal
if ! ZED_SETTINGS="$(
  jq -er '
    first(
      .data[]
      | select(
          .available == true
          and ((.architecture.output_modalities // []) | index("text"))
          and ((.supported_parameters // []) | index("tools"))
          and (.context_length | type == "number" and . > 0)
          and ((.supported_endpoint_types // []) | all(. != "image-generation" and . != "image-edit"))
        )
    ) as $model
    | {
        language_models: {
          openai_compatible: {
            "provod.ai": {
              api_url: "https://api.provod.ai/v1",
              available_models: [
                {
                  name: $model.id,
                  display_name: ($model.name // $model.id),
                  max_tokens: $model.context_length,
                  capabilities: {
                    tools: true,
                    images: false,
                    parallel_tool_calls: false,
                    prompt_cache_key: false,
                    chat_completions: true,
                    interleaved_reasoning: false,
                    max_tokens_parameter: true
                  }
                }
              ]
            }
          }
        }
      }
  ' <<<"$MODELS_JSON"
)"; then
  printf 'No available Zed-compatible model found in /v1/models.\n' >&2
  exit 1
fi

printf '%s\n' "$ZED_SETTINGS"

Объедините выведенный объект с settings.json. Введите значение PROVOD_API_KEY через настройки подключения Zed, чтобы ключ сохранился в системном хранилище; не добавляйте его в settings.json. Затем выберите пользовательскую модель и отправьте один короткий запрос.

Cursor

Продолжайте только в версии Cursor с полем Override OpenAI Base URL. Укажите https://api.provod.ai/v1, значение PROVOD_API_KEY и точный PROVOD_MODEL. По доступным диагностическим данным Cursor убедитесь, что запрос использует переопределённый адрес. Если поля нет или Cursor отправляет другой протокол, не передавайте ключ по непроверенному пути.

Подробные руководства

Создание и замена ключей описаны в авторизации API. Актуальные идентификаторы моделей, лимиты и поддерживаемые опции получайте через каталог моделей.

Публичный код ошибки — это предназначенное для клиента значение error.code, которое вернул API. Сохраните его вместе с HTTP-статусом, версией инструмента, итоговым адресом, точным идентификатором модели, временем и маскированным префиксом ключа; не прикладывайте полный ключ.

Решение проблем

На этой странице