# Model API · Быстрый старт

Model API подключает приложение или AI-инструмент к моделям разных поставщиков через один ключ Felo. Используйте его для диалогов, текстов и кода или выбирайте модели изображений и видео. Оплата списывается с баланса платформы по фактическому использованию.

## Быстрый старт

1. [Получить API Key](https://openapi.felo.ai/console/api-keys) — Создайте API-ключ в консоли, скопируйте его целиком и сохраните в безопасном месте.
2. [Пополните баланс](https://openapi.felo.ai/console/billing) — Покупайте сервисные кредиты, выраженные в долларах, для фактического использования API. Подписка не требуется.
3. [Смотреть все модели](https://openapi.felo.ai/ru/models) — Выберите в каталоге модель с поддержкой Chat Completions и замените YOUR_MODEL_ID её идентификатором.

## Использовать в AI-инструменте

Настройте Codex, Claude Code, OpenClaw, Cursor, Cline и другие Agent clients.

- [Codex](https://openapi.felo.ai/ru/docs/agent-clients/codex.md) — Настройте Codex CLI с custom model provider Felo.
- [Claude Code](https://openapi.felo.ai/ru/docs/agent-clients/claude-code.md) — Настройте Claude Code, чтобы Anthropic-compatible вызовы моделей проходили через Felo API Platform.
- [OpenClaw](https://openapi.felo.ai/ru/docs/agent-clients/openclaw.md) — Подключите OpenClaw к Felo API Platform для assistant и Agent workflows.
- [Hermes Agent](https://openapi.felo.ai/ru/docs/agent-clients/hermes-agent.md) — Настройте Hermes Agent с доступом к моделям Felo API Platform.
- [OpenCode](https://openapi.felo.ai/ru/docs/agent-clients/opencode.md) — Подключите OpenCode к Felo через OpenAI-compatible endpoint.
- [DeepSeek Harness](https://openapi.felo.ai/ru/docs/agent-clients/deepseek-harness.md) — Подключите DeepSeek Harness к Felo через встроенный адаптер DeepSeek или custom OpenAI-compatible provider.
- [Cursor](https://openapi.felo.ai/ru/docs/agent-clients/cursor.md) — Используйте Felo API Platform в Cursor через custom OpenAI-compatible настройки, когда они доступны.
- [Cline](https://openapi.felo.ai/ru/docs/agent-clients/cline.md) — Настройте Cline с доступом к моделям Felo API Platform.
- [Pi](https://openapi.felo.ai/ru/docs/agent-clients/pi.md) — Install the Felo Skill for Pi and optionally add Felo as a Pi model provider.
- [TRAE](https://openapi.felo.ai/ru/docs/agent-clients/trae.md) — Используйте Felo API Platform в TRAE через совместимые настройки model provider.
- [Roo Code](https://openapi.felo.ai/ru/docs/agent-clients/roo-code.md) — Настройте Roo Code с Felo-compatible model provider.
- [Kilo Code](https://openapi.felo.ai/ru/docs/agent-clients/kilo-code.md) — Настройте Kilo Code с доступом к моделям Felo API Platform.

[Другие AI tools](https://openapi.felo.ai/ru/docs/agent-clients/other-tools.md) · [FeloAPI CLI](https://openapi.felo.ai/ru/docs/cli.md)

## Подключить своё приложение

Сохраните OpenAI или Anthropic SDK. Укажите соответствующий Base URL, ключ Felo и поддерживаемый ID модели.

### OpenAI SDK · Base URL

```text
https://openapi.felo.ai/api/v1
```

### Anthropic SDK · Base URL

```text
https://openapi.felo.ai/api
```

Anthropic SDK автоматически добавляет /v1/messages. Укажите /api в Base URL, без /v1 в конце. В качестве API Key SDK используйте ключ Felo.

### Быстрый старт · Chat Completions

Выберите в каталоге модель с поддержкой Chat Completions и замените YOUR_MODEL_ID её идентификатором.

```bash
export FELO_API_KEY="YOUR_FELO_API_KEY"

curl -sS https://openapi.felo.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Say hello"}]}'
```

HTTP 200 → `choices[0].message.content`

[Настроить вручную](https://openapi.felo.ai/ru/docs/getting-started.md) · [Протоколы и SDK](https://openapi.felo.ai/ru/docs/guides/protocols.md)

## Протоколы и авторизация

Совместимые с Felo API моделей и видео. Эндпоинты моделей включают OpenAI-совместимые API Models, Chat Completions и Responses, а также Claude-совместимый API Messages. Аутентифицируйте запросы к моделям и видео с помощью API-ключа Felo методом Bearer-аутентификации или с заголовком X-API-Key. Отправляйте задачи генерации видео асинхронно, опрашивайте статус до значения succeeded, затем скачивайте подписанный URL медиафайла из outputs[]. Эндпоинт скачивания медиафайлов анонимный: каждый URL вывода содержит краткоживущую HMAC-подпись (exp + sig), и его можно открыть напрямую в браузере без API-ключа. Chat Completions, Responses и Messages сохраняют собственные форматы запроса, ответа, потоковой передачи и ошибок. GET/HEAD /api/platform/model-catalog — анонимный, зависящий от локали каталог для поиска моделей и форм Playground. Для инференса по-прежнему требуется API-ключ. Все шесть протоколов инференса принимают X-Felo-Channel; опубликованные каналы управляют маршрутизацией. Изображения используют постоянные асинхронные задачи, а Decisions использует состояние и вопросы без потоковой передачи.