II-CHO
Ранний доступ

Документация API

REST API для запуска AI-моделей на распределённой GPU-сети: inference, асинхронные задачи, каталог моделей и биллинг.

Base URLhttps://app.ii-cho.org/api

Как работает сервис

Вы отправляете запрос — платформа находит подходящий GPU в распределённой сети, выполняет работу и возвращает результат. Инфраструктура, очереди и мониторинг — на нашей стороне.

Шаг 1

Аккаунт

Регистрируетесь по email и получаете JWT-токены.

Шаг 2

API-ключ

Создаёте ключ для серверных интеграций — заголовок x-api-key.

Шаг 3

Запуск

Вызываете inference напрямую или ставите задачу в очередь — платформа сама подберёт GPU.

Шаг 4

Оплата

Списание по факту использования GPU-времени с баланса кошелька.

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

Три запроса — от регистрации до первого ответа модели.

01

Получите токен

Зарегистрируйтесь и войдите — в ответе придут accessToken, refreshToken и данные пользователя.

curl -X POST https://app.ii-cho.org/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your-password"}'
02

Создайте API-ключ

Ключ показывается один раз — сохраните его. Для серверных интеграций используйте его вместо JWT.

curl -X POST https://app.ii-cho.org/api/me/api-keys \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-integration"}'
03

Запустите inference

Передайте ключ в заголовке x-api-key. Для стриминга укажите "stream": true — ответ придёт в формате SSE.

curl -X POST https://app.ii-cho.org/api/inference/chat \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama3.2",
    "messages": [{"role": "user", "content": "Привет!"}],
    "stream": false
  }'

Аутентификация

Два способа авторизации — выбирайте по сценарию.

JWT

Bearer-токен

Для веб-приложений и коротких сессий. Access-токен обновляется через /auth/refresh.

Authorization: Bearer <accessToken>
API-ключ

Заголовок x-api-key

Для серверных интеграций и продакшена. Ключ создаётся в личном кабинете или через API и отзывается в любой момент.

x-api-key: <ваш ключ>

Справочник API

Все пути указаны относительно https://app.ii-cho.org/api.

Аутентификация

Открытые

Регистрация, вход и управление JWT-токенами.

POST/auth/registerРегистрация по email и паролю
POST/auth/loginВход — возвращает access и refresh токены
POST/auth/refreshОбновление access-токена
POST/auth/logoutВыход и отзыв refresh-токена
GET/auth/meДанные текущего пользователя

API-ключи

JWT

Ключи для серверной интеграции — передаются в заголовке x-api-key.

POST/me/api-keysСоздать ключ (значение показывается один раз)
GET/me/api-keysСписок ваших ключей
DELETE/me/api-keys/:idОтозвать ключ

Inference

JWT или API-ключ

Синхронный запуск моделей: чат, изображения, прогрев. Лимиты запросов — на пользователя или ключ.

GET/inference/modelsМодели, доступные для inference
POST/inference/warmupПрогрев модели перед запросами
POST/inference/chatЧат-запрос к LLM (поддерживает SSE-стриминг)
POST/inference/imagesГенерация изображений

Задачи

JWT

Асинхронные GPU-задачи: очередь, статусы, логи и результаты.

POST/tasksСоздать задачу
GET/tasksСписок ваших задач
GET/tasks/:idСтатус задачи
GET/tasks/:id/logsЛоги выполнения
GET/tasks/:id/resultРезультат задачи
GET/tasks/:id/timelineТаймлайн событий задачи
POST/tasks/:id/cancelОтменить задачу
POST/tasks/:id/retryПовторить неудавшуюся задачу

Каталог моделей

Открытые

Готовые AI-модели: список, карточки и запуск в один вызов.

GET/modelsСписок моделей каталога
GET/models/:idOrSlugКарточка модели
POST/models/:idOrSlug/runЗапустить модель как задачу (JWT)

Сессии

JWT

Интерактивные GPU-сессии с потоковым выводом.

POST/sessions/startЗапустить сессию
POST/sessions/:id/stopОстановить сессию
GET/sessionsСписок сессий
GET/sessions/:idДетали сессии
GET/sessions/:id/streamПоток событий сессии (SSE)

Кошелёк

JWT

Баланс и история списаний — оплата по факту использования.

GET/walletТекущий баланс
GET/wallet/transactionsИстория транзакций

Профессии

Открытые

Подбор моделей под сферу деятельности.

GET/professionsСписок профессий
GET/professions/:idКарточка профессии
GET/professions/:id/modelsРекомендованные модели профессии

Статус API

Платформа в режиме раннего доступа: состав эндпоинтов может меняться, для всех запросов действуют лимиты на пользователя или API-ключ. О breaking changes мы предупреждаем в email-рассылке ранних пользователей.

Получите ранний доступ

Оставьте заявку — мы пришлём приглашение, как только откроем доступ.

Мы не передаём данные третьим сторонам.