API v1

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

OpenAI-совместимый HTTP API для генерации текста. Базовый адрес: https://api.ic-app.ru/v1.

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

Выпустите ключ в личном кабинете и отправьте первый запрос. Полный ключ начинается с ic_live_ и показывается только один раз.

cURL

curl https://api.ic-app.ru/v1/chat/completions \
  -H "Authorization: Bearer $IC_NEURAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ic-neural-flash",
    "messages": [
      {"role": "user", "content": "Напиши приветствие"}
    ],
    "max_tokens": 300
  }'

Python · OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="ic_live_...",
    base_url="https://api.ic-app.ru/v1",
)

response = client.chat.completions.create(
    model="ic-neural-flash",
    messages=[{"role": "user", "content": "Привет"}],
)
print(response.choices[0].message.content)

Авторизация

Передавайте ключ в каждом запросе через HTTP-заголовок:

HTTP

Authorization: Bearer ic_live_...

Не встраивайте ключ в клиентский JavaScript или мобильное приложение.

Храните его на своём сервере или в менеджере секретов. При утечке сразу отзовите ключ в кабинете.

Модели

ID	Назначение	Контекст
`ic-neural-flash`	Текст, классификация, извлечение данных, код	Определяется провайдером

Список доступных моделей можно получить запросом GET /v1/models с тем же Bearer-ключом.

POST /chat/completions

Поле	Тип	Описание
`model`	string	Обязательно: `ic-neural-flash`.
`messages`	array	От 1 до 100 сообщений с ролями system, user или assistant.
`temperature`	number	От 0 до 2. По умолчанию 0.7.
`max_tokens`	integer	От 1 до 4096. По умолчанию 1024.
`stream`	boolean	Пока поддерживается только `false`.

Формат ответа

JSON

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "ic-neural-flash",
  "choices": [{
    "message": {"role": "assistant", "content": "..."},
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 38,
    "total_tokens": 50
  }
}

Ошибки

Код	Причина
`400`	Некорректные поля запроса или неподдерживаемая модель.
`401`	Ключ отсутствует, неверен или отозван.
`402`	Доступ не активирован или на балансе недостаточно средств.
`429`	Превышено 60 запросов в минуту на ключ.
`502`	Внешний провайдер не обработал запрос. Зарезервированные средства возвращаются.

Тарификация

Перед вызовом API система временно резервирует сумму по max_tokens. После ответа резерв пересчитывается по фактическому расходу, а остаток сразу возвращается на баланс.

Операция	Цена
Входные токены	1 коп. за 1 000 токенов
Выходные токены	5 коп. за 1 000 токенов
Минимальная стоимость запроса	1 коп.

Содержимое запросов не попадает в журнал IC Neural.

Для расчёта и кабинета сохраняются только количество токенов, модель, стоимость, статус и технический идентификатор.