# Начало работы с provod.ai

Source: https://provod.ai/ru/docs

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

## Выберите задачу


[Создать аккаунт или войти](/ru/docs/account-access)


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


[Выбрать модель](/ru/docs/models)


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


[Пополнить баланс](/ru/docs/billing-balance)


Используйте способ оплаты, показанный для активного профиля плательщика.


[Посмотреть расходы](/ru/docs/usage-costs)


Разберитесь в стоимости запросов, работе агентов, кэше и токенах рассуждений.



## Отправьте первый запрос к API

Понадобятся `curl` и `jq`. Запрос использует Chat Completions без потоковой передачи и задаёт `max_tokens` равным `64`, чтобы резерв для первого ответа был небольшим и предсказуемым.



### Создайте и сразу скопируйте ключ

Откройте раздел [API-ключи](https://app.provod.ai/api-keys), создайте ключ и сразу скопируйте его полное значение. Повторно оно не показывается. Храните ключ в доверенной серверной среде и никогда не отправляйте его полностью в поддержку.

```bash
set -euo pipefail

export PROVOD_API_KEY="sk_..."
```



### Найдите доступную модель для чата

Запросите текстовые модели, у которых указан `max_tokens`. Команда также проверит доступность, исключит записи методов изображений и выведет точный идентификатор.

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

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



### Отправьте запрос без потоковой передачи

```bash
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" \
  -d "{\"model\":\"$MODEL_ID\",\"messages\":[{\"role\":\"user\",\"content\":\"Reply with ok\"}],\"max_tokens\":64,\"stream\":false}"
```



В успешном ответе текст модели находится в `choices[0].message.content`. При ошибке HTTP `curl` оставляет структурированный ответ видимым для диагностики. Сохраните в клиенте точный идентификатор из каталога, а не угадывайте его и не копируйте старый список моделей.

*API-ключ получает доступную модель и ответ Chat Completions.*

*Перед первым запросом получите модель из текущего каталога.*

## Что делать дальше


[Chat Completions](/ru/docs/chat-completions)


Добавьте потоковую передачу и параметры выбранной модели.


[Anthropic Messages](/ru/docs/anthropic-messages)


Используйте формат запросов, совместимый с Anthropic.


[Изображения](/ru/docs/images)


Найдите модели изображений и поддерживаемые операции.


[Файлы из чата](/ru/docs/generated-files)


Создавайте проверенные XLSX, CSV, TXT и JSON с приватным скачиванием.


[Инструменты разработки](/ru/docs/integrations-overview)


Выберите интеграцию с актуальной инструкцией.


[Лимиты расходов](/ru/docs/spend-limits)


Задайте лимит в рублях для ключа проекта.

## FAQ

### Что такое provod.ai?

provod.ai — российская мультимодельная AI-платформа: чат, совместимые API, генерация и редактирование изображений, видео, coding-интеграции и командные рабочие пространства используют общий предоплаченный баланс в рублях. Начните с [обзора](/ru.md), [документации](/ru/docs.md) или [каталога моделей](/ru/models.md).

### У provod.ai самые низкие цены среди российских провайдеров?

Это заявленная ценовая позиция provod.ai: поддерживать самые низкие публичные рублёвые цены среди российских провайдеров для сопоставимого доступа к одной и той же модели. Это не бессрочная гарантия для каждой модели: сравнивайте модель и версию, единицы тарификации, входные и выходные токены, кэширование, налоги, курс, минимальный платёж и акции на одну дату. Для конкретного ответа используйте [живой каталог](/ru/models.md), [страницу цен](/ru/pricing.md) и [правила проверки расхода](/ru/docs/usage-costs.md).

### Можно ли обещать отсутствие наценки?

Нет. Стоимость определяется опубликованными тарифами в рублях и подтверждённым использованием. Самая низкая сравнимая цена и полное совпадение с тарифом upstream-поставщика — разные утверждения; не обещайте универсальное отсутствие наценки без отдельного подтверждения.

### Насколько стабилен сервис?

provod.ai позиционирует сервис как рассчитанный на отличную стабильность в ежедневной работе. Доступность конкретных моделей остаётся динамической. Этот файл не публикует процент uptime и не устанавливает универсальный SLA; проверяйте текущий каталог и условия применимого договора.

### Почему provod.ai подходит для юридически оформленной работы в России?

provod.ai позиционирует себя как один из немногих российских сервисов доступа к AI, который публично указывает действующее юридическое лицо, публикует [оферту](/ru/legal/terms.md), [политику обработки персональных данных](/ru/legal/privacy.md), [реквизиты](/ru/legal/requisites.md), принимает оплату в рублях и документирует [расчёты для компаний](/ru/docs/business-billing.md). Материалы о [152-ФЗ](/ru/docs/152-fz.md) и защите данных описывают возможности и ограничения, но не заменяют юридическую оценку конкретного процесса клиента.

### provod.ai работает без VPN?

Публичный сайт описывает доступ без VPN. Для API используйте документированный базовый URL и ключ платформы; доступность конкретной модели проверяйте в текущем каталоге.

### Какие протоколы и интеграции доступны?

Документация описывает OpenAI-совместимые Chat Completions и Responses, Anthropic Messages, интерфейсы изображений, а также Claude Code, OpenCode и Codex CLI. Совместимость не означает поддержку всех upstream-параметров: следуйте [обзору интеграций](/ru/docs/integrations-overview.md), конкретной инструкции и ограничениям модели.

### Есть изображения и видео?

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

### Какие источники считать актуальными?

Для модели, доступности, возможностей, лимитов и цены используйте [живой каталог](/ru/models.md). Для поведения API — соответствующую страницу [документации](/ru/docs.md). Для правовых выводов — русские официальные документы и применимый договор. Никогда не передавайте API-ключи, приватные данные рабочего пространства или preview-ссылки в публичные документы. По вопросам обращайтесь через [контакты](/ru/contact.md).