Перейти к основному содержимому

Инструкция по подключению к AIaaS (ИИ как сервис) через AInergy

1. Общие сведения​

AIaaS (ИИ как сервис) — сервис ITGLOBAL.COM, предоставляющий доступ к множеству LLM и специализированным AI-сервисам через единый API-шлюз. API совместим с OpenAI, что позволяет использовать существующие библиотеки и инструменты без изменений интеграции.

1.1 Базовый эндпоинт​

https://<адрес, выданный при подключении>/v1

Конкретный адрес шлюза выдаётся при подключении вместе с API-ключом. Сервис работает на нескольких площадках, и адрес зависит от того, какая из них обслуживает ваш тенант.

warning

Ключ действует только на той площадке, для которой он выдан. Обращение с ним на адрес другой площадки вернёт 401. Используйте именно тот адрес, который указан в вашем письме о подключении.

Обратите внимание на суффикс /v1 — он входит в базовый URL, и все пути в примерах отсчитываются от него.

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

Для всех запросов используется Bearer-токен, выдаваемый после заключения SLA:

Authorization: Bearer <ваш_API_ключ>

1.3 Дополнительные заголовки​

Для идентификации источника запросов и корректной аналитики потребления:

X-AIN-USERNAME: <имя_пользователя>
X-AIN-SOURCEID: <идентификатор_системы>

2. Стандартные OpenAI-совместимые эндпоинты​

2.1 Список доступных моделей​

Для получения перечня подключенных моделей и сервисов используйте стандартный эндпоинт GET /v1/models.

Пример (curl):

curl -sS \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "X-AIN-USERNAME: ваше_имя" \
  -H "X-AIN-SOURCEID: название_системы" \
  "$BASE_URL/models"

Ответ (упрощённо):

{
  "object": "list",
  "data": [
    {"id": "opr.qwen-3.7-max.chat_completions", "object": "model", "owned_by": "opr"},
    {"id": "itg.gemma-4-26b-a4b.chat_completions", "object": "model", "owned_by": "itg"},
    {"id": "itg.whisperx-prod.audio_transcriptions", "object": "model", "owned_by": "itg"},
    {"id": "itg.ocr.v2.doc-to-text", "object": "model", "owned_by": "itg"}
  ]
}

Пример (Python / httpx):

import httpx

BASE_URL = "https://<адрес, выданный при подключении>/v1"

API_KEY = "ваш_API_ключ"

resp = httpx.get(
    f"{BASE_URL}/models",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "X-AIN-USERNAME": "ваш_логин",
        "X-AIN-SOURCEID": "название_системы",
    },
)
resp.raise_for_status()

for m in resp.json()["data"]:
    print(f"{m['id']} (owner: {m['owned_by']})")

Пример (Python / openai SDK):

from openai import OpenAI

client = OpenAI(
    base_url="https://<адрес, выданный при подключении>/v1",
    api_key="ваш_API_ключ",
    default_headers={
        "X-AIN-USERNAME": "ваш_логин",
        "X-AIN-SOURCEID": "название_системы",
    },
)

for m in client.models.list().data:
    print(f"{m.id} (owner: {m.owned_by})")
примечание

GET /v1/models возвращает только те маршруты, которые разрешены вашим API-ключом. Полный реестр всех зарегистрированных маршрутов с коэффициентами приведён в разделе Доступные модели (Nexuses).

3. Рекомендации​

Токены и расход. Потребление считается в A-токенах: входные и выходные токены умножаются на коэффициенты модели. Методика расчёта описана в разделе Расчёт A-токенов, а точные коэффициенты по каждому маршруту — в разделе Доступные модели (Nexuses).

Квоты. При необходимости ограничения по пользователям, отделам или моделям обратитесь в техподдержку.

Изоляция. Для production-развёртываний с повышенными требованиями к изоляции данных рекомендуется рассмотреть Private AI Cloud — проектное решение на выделенном контуре ITGLOBAL.COM.

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

4. Контакт​

Для вопросов по подключению, квотам, изоляции и коммерческим условиям обращайтесь к менеджеру ITGLOBAL.COM.