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

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

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

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

https://ainergy01-api-am2.itglobal.com/v1/

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

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

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

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

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

X-AIN-USERNAME: <имя_пользователя>

X-AIN-SOURCEID: <идентификатор_системы>

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

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

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

GET https://ainergy01-api-am2.itglobal.com/v1/models
Пример (curl):
curl -sS \
-H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
-H "X-AIN-USERNAME: ваше_имя" \
-H "X-AIN-SOURCEID: название_системы" \
"https://ainergy01-api-am2.itglobal.com/v1/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
resp = httpx.get(
"https://ainergy01-api-am2.itglobal.com/v1/models",
headers={
"Authorization": f"Bearer {API_KEY}",
"X-AIN-USERNAME": "ваш_логин",
"X-AIN-SOURCEID": "название_системы",
},
)
models = resp.json()["data"]
for m in models:
print(f"{m['id']} (owner: {m['owned_by']})")
Пример (Python / openai SDK):
from openai import OpenAI
client = OpenAI(
base_url="https://ainergy01-api-am2.itglobal.com/v1",
api_key=***
default_headers={
"X-AIN-USERNAME": "ваш_логин",
"X-AIN-SOURCEID": "название_системы",
}
)
models = client.models.list()
for m in models.data:
print(f"{m.id} (owner: {m.owned_by})")
Примечание: GET /v1/models возвращает модели, доступные для текущего API-ключа. Полный реестр всех зарегистрированных маршрутов приведён в разделе 3.

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

Токены и расход: Потребление считается в A-токенах (входные + выходные токены × коэффициент модели). Точные коэффициенты указаны в SLA.

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

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

4. Контакт

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