INFERECODOC

Доступ к API
и примеры запросов

Как подключить API-ключ к себе в проект

Для работы с API нужен ключ доступа. Он связывает запросы с вашим аккаунтом, позволяет выполнять обращения к моделям и учитывать расход токенов.

Адрес API

API совместим с форматом OpenAI API, что упрощает переключение между провайдерами.

URLhttps://api.infereco.ru/v1

Прайс-лист моделей

Актуальные цены всех моделей отдаёт публичный эндпоинт GET https://api.infereco.ru/v1/pricing — API-ключ не нужен.

curl https://api.infereco.ru/v1/pricing

Цены указаны в рублях за 1 млн токенов: prompt — входящие, completion — исходящие, input_cache_read — входящие из кэша (null — считайте по prompt). Для распознавания и перевода речи ставка audio — в рублях за секунду, для синтеза речи ставка characters — в рублях за 1 млн символов текста из поля input. Ставка, которая к модели не относится, равна null. Все ставки — строки, чтобы не терять точность.

Поле mode — тип модели: chat, embedding, audio_transcription, image_generation (генерация изображений), audio_speech (синтез речи). В supported_endpoints перечислены пути API, которые принимают модель; их может быть несколько — например, у модели перевода речи /v1/audio/transcriptions и /v1/audio/translations.

Для моделей на нашем оборудовании (hosting: internal) в pricing.overrides указана ночная цена с 22:00 до 08:00 по московскому времени (utc_start 1900, utc_end 500): ставка в окне заменяет базовую. Поле access: all — модель доступна любому ключу, on_request — доступ выдаётся по запросу. Ответ можно кэшировать 5 минут; он несёт заголовок ETag, повторный запрос с If-None-Match вернёт 304.

Пример ответа (сокращён)
{
  "object": "list",
  "currency": "RUB",
  "price_unit": { "tokens": "per_1m_tokens", "audio": "per_second", "characters": "per_1m_characters" },
  "timezone": "Europe/Moscow",
  "generated_at": "2026-10-12T14:05:11Z",
  "data": [
    {
      "id": "glm/glm-5.3-flash",
      "name": "Z.ai: GLM 5.3 Flash",
      "mode": "chat",
      "supported_endpoints": ["/v1/chat/completions"],
      "hosting": "internal",
      "access": "all",
      "context_length": 262144,
      "max_completion_tokens": null,
      "pricing": {
        "prompt": "22.5",
        "completion": "75",
        "input_cache_read": "2.25",
        "audio": null,
        "characters": null,
        "overrides": [
          {
            "reason": "night_discount",
            "discount_percent": 30,
            "local_start": "22:00",
            "local_end": "08:00",
            "utc_start": 1900,
            "utc_end": 500,
            "prompt": "15.75",
            "completion": "52.5",
            "input_cache_read": "1.575",
            "audio": null,
            "characters": null
          }
        ]
      }
    },
    {
      "id": "x-ai/grok-voice-tts-1.0",
      "name": "xAI: Grok Voice TTS 1.0",
      "mode": "audio_speech",
      "supported_endpoints": ["/v1/audio/speech"],
      "hosting": "external",
      "access": "on_request",
      "context_length": 10000,
      "max_completion_tokens": null,
      "pricing": {
        "prompt": null,
        "completion": null,
        "input_cache_read": null,
        "audio": null,
        "characters": "2201.52",
        "overrides": []
      }
    }
  ]
}

Ключ доступа

Ключ используется в запросах к API и передаётся в заголовке Authorization.

cURL
curl https://api.infereco.ru/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -d '{"model":"qwen/qwen3-coder-next","messages":[{"role":"user","content":"Привет"}]}'

Как получить ключ

  • Перейдите в раздел Ключи API.
  • Нажмите Создать ключ.
  • Укажите название ключа, например: Backend, VS Code или Тестовый стенд.
  • Скопируйте созданный ключ.
Перейти в раздел «Ключи»

Первый запрос

После создания ключа можно отправить первый запрос к модели. Замените ВАШ_API_КЛЮЧ на созданный ключ. В примерах используется модель qwen/qwen3-coder-next — при необходимости замените её на другую из списка доступных моделей в личном кабинете.

curl https://api.infereco.ru/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -d '{"model":"qwen/qwen3-coder-next","messages":[{"role":"user","content":"Привет"}]}'