Текстовые модели
CDNvideo AI Hub поддерживает три текстовых интерфейса — выбирайте тот, который ближе к вашему стеку:
| Интерфейс | Путь | Для каких моделей | Совместим с |
|---|---|---|---|
| Chat Completions | /chat/completions |
Любые текстовые модели | OpenAI SDK |
| Responses | /responses |
OpenAI-модели (gpt-5 и новее) | OpenAI SDK |
| Messages | /messages |
Claude-модели (Anthropic) | Anthropic SDK |
Во всех интерфейсах используются один и тот же base_url и один и тот же секретный ключ. Меняется только путь, SDK и название модели в поле model.
- Base URL:
https://api.cdnvideo.ru/app/aihub-router/v1 - Авторизация: заголовок
Authorization: Bearer {sk}
В примерах ниже используются модели gpt-5.5 (для OpenAI-интерфейсов) и claude-opus-4.7 (для Anthropic-интерфейса).
Chat Completions
Универсальный OpenAI-совместимый метод /chat/completions. Подходит для классического диалога с моделью через массив сообщений messages и работает со всеми текстовыми моделями платформы.
Пример cURL
curl https://api.cdnvideo.ru/app/aihub-router/v1/chat/completions \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [
{
"role": "system",
"content": "Ты полезный ассистент."
},
{
"role": "user",
"content": "Кратко объясни, что такое OpenAI-совместимое API."
}
]
}'
Пример Python
Установите официальную библиотеку OpenAI:
pip install openai
Используйте CDNvideo AI Hub как OpenAI-совместимый API:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AIHUB_API_KEY"],
base_url="https://api.cdnvideo.ru/app/aihub-router/v1",
)
response = client.chat.completions.create(
model="gpt-5.5",
messages=[
{"role": "system", "content": "Ты полезный ассистент."},
{"role": "user", "content": "Кратко объясни, что не так в этом коде?"},
],
)
print(response.choices[0].message.content)
Responses (OpenAI)
Метод /responses — современный OpenAI-интерфейс для моделей gpt-5 и новее. Поддерживает мультимодальный ввод и расширенные возможности OpenAI Agents.
Когда выбирать /responses
Используйте этот интерфейс, если работаете с OpenAI Agents SDK, инструментами Codex или хотите задействовать новые возможности gpt-5+. Для классического диалога подойдёт /chat/completions.
Пример cURL
curl https://api.cdnvideo.ru/app/aihub-router/v1/responses \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"input": "Кратко объясни, что такое OpenAI Responses API."
}'
Пример Python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AIHUB_API_KEY"],
base_url="https://api.cdnvideo.ru/app/aihub-router/v1",
)
response = client.responses.create(
model="gpt-5.5",
input="Кратко объясни, что такое OpenAI Responses API.",
)
print(response.output_text)
Messages (Anthropic)
Метод /messages — нативный Anthropic-интерфейс для моделей Claude. Используйте его, если ваш код уже написан под Anthropic SDK или вам нужны специфичные для Claude возможности (например, расширенный режим рассуждений).
Пример cURL
curl https://api.cdnvideo.ru/app/aihub-router/v1/messages \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-opus-4.7",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "Кратко объясни, что такое Anthropic Messages API."
}
]
}'
Пример Python
Установите официальную библиотеку Anthropic:
pip install anthropic
CDNvideo AI Hub принимает токен в заголовке Authorization: Bearer, поэтому передавайте ключ через параметр auth_token:
import os
from anthropic import Anthropic
client = Anthropic(
auth_token=os.environ["AIHUB_API_KEY"],
base_url="https://api.cdnvideo.ru/app/aihub-router/v1",
)
message = client.messages.create(
model="claude-opus-4.7",
max_tokens=1024,
messages=[
{"role": "user", "content": "Кратко объясни, что такое Anthropic Messages API."},
],
)
print(message.content[0].text)
Список моделей
Чтобы получить список доступных моделей, используйте OpenAI-совместимый метод /models.
curl https://api.cdnvideo.ru/app/aihub-router/v1/models \
-H "Authorization: Bearer ${AIHUB_API_KEY}"
Пользовательские инструменты (tools)
К текстовым запросам можно добавлять описания собственных инструментов (tools). CDNvideo AI Hub передаёт их модели в формате выбранного API. Встроенные инструменты для этих API не предоставляются.
Кто выполняет инструмент
Модель только возвращает запрос на вызов функции с её именем и аргументами. Ваше приложение проверяет аргументы, выполняет свою функцию и отправляет результат модели следующим сообщением. CDNvideo AI Hub не запускает код клиента.
Типовой цикл: отправьте вопрос и описание функции, получите запрос на её вызов, выполните функцию на стороне клиента, передайте результат модели и получите финальный ответ. Поддержка tools зависит от выбранной модели.
Совместимость моделей
Формат вызова tools и поддержка параметров могут меняться между версиями API и моделей. Примеры ниже показывают общий сценарий для указанных моделей и не обязательно подходят для каждой модели или версии. Проверяйте актуальные возможности и формат выбранной модели.
| Интерфейс | Описание функции | Запрос модели на вызов | Передача результата |
|---|---|---|---|
| OpenAI Chat Completions | tools[].function | message.tool_calls | role: tool и tool_call_id |
| OpenAI Responses | tools[] с type: function | function_call в output | function_call_output с call_id |
| Anthropic Messages | tools[].input_schema | блок tool_use | блок tool_result с tool_use_id |
В примерах используется функция current_time, которая возвращает дату и время для указанного часового пояса. Задайте ключ в переменной окружения AIHUB_API_KEY. Ответы ниже приведены из конкретных запусков: ID вызовов и значения времени в вашем ответе будут другими. При продолжении диалога передавайте ID из своего ответа и фактический результат функции.
OpenAI: Chat Completions
Запрос 1: вопрос и описание функции
curl --location 'https://api.cdnvideo.ru/app/aihub-router/v1/chat/completions' \
--header "Authorization: Bearer $AIHUB_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-5.3",
"messages": [
{
"role": "system",
"content": "Не выдумывай дату и время. Если часовой пояс не указан, используй Europe/Moscow."
},
{"role": "user", "content": "Который час?"}
],
"tools": [
{
"type": "function",
"function": {
"name": "current_time",
"description": "Возвращает текущие дату и время для часового пояса IANA.",
"parameters": {
"type": "object",
"properties": {
"timezone": {"type": "string", "description": "Часовой пояс, например Europe/Moscow."}
},
"required": ["timezone"],
"additionalProperties": false
}
}
}
],
"tool_choice": {
"type": "function",
"function": {"name": "current_time"}
}
}'
Ответ API с запросом на вызов функции:
{
"id": "chatcmpl-EmJRkelp22953OtQnuMLccmJ",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "",
"tool_calls": [
{
"id": "call_-7231383350479413260",
"function": {
"arguments": "{\"timezone\":\"Europe/Moscow\"}",
"name": "current_time"
},
"custom": null,
"type": "function",
"extra_content": null
}
],
"reasoning_content": "The user is asking what time it is. They didn't specify a timezone, so I should use Europe/Moscow as the default according to the instructions. Let me call the current_time function."
},
"finish_reason": "tool_calls",
"native_finish_reason": "tool_calls"
}
],
"created": 1791447159,
"model": "glm-5.3",
"object": "chat.completion",
"usage": {
"prompt_tokens": 216,
"completion_tokens": 55,
"total_tokens": 271,
"completion_tokens_details": {
"text_tokens": 0,
"accepted_prediction_tokens": 0,
"audio_tokens": 0,
"image_tokens": 0,
"reasoning_tokens": 40,
"rejected_prediction_tokens": 0
},
"prompt_tokens_details": {
"text_tokens": 0,
"cache_creation_input_tokens": 0,
"audio_tokens": 0,
"audio_cached_tokens": 0,
"cached_tokens": 0,
"cache_write_tokens": 0,
"image_tokens": 0
}
}
}
Клиент вызывает свою функцию current_time. В проверочном примере она вернула {"datetime":"2026-10-08T11:13:06.686321+03:00","timezone":"Europe/Moscow"}.
Запрос 2: передайте результат функции
Во втором запросе повторите описание tools и передайте историю сообщений, вызов assistant и результат функции. Значение tool_call_id должно совпадать с id вызова из ответа:
curl --location 'https://api.cdnvideo.ru/app/aihub-router/v1/chat/completions' \
--header "Authorization: Bearer $AIHUB_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-5.3",
"messages": [
{
"role": "system",
"content": "Не выдумывай дату и время. Если часовой пояс не указан, используй Europe/Moscow."
},
{"role": "user", "content": "Который час?"},
{
"role": "assistant",
"content": "",
"tool_calls": [
{
"id": "call_-7231383350479413260",
"type": "function",
"function": {
"name": "current_time",
"arguments": "{\"timezone\":\"Europe/Moscow\"}"
}
}
]
},
{
"role": "tool",
"tool_call_id": "call_-7231383350479413260",
"content": "{\"datetime\":\"2026-10-08T11:13:06.686321+03:00\",\"timezone\":\"Europe/Moscow\"}"
}
],
"tools": [
{
"type": "function",
"function": {
"name": "current_time",
"description": "Возвращает текущие дату и время для часового пояса IANA.",
"parameters": {
"type": "object",
"properties": {
"timezone": {"type": "string", "description": "Часовой пояс, например Europe/Moscow."}
},
"required": ["timezone"],
"additionalProperties": false
}
}
}
],
"tool_choice": "auto"
}'
После получения результата модель возвращает ответ:
{
"id": "chatcmpl-V8DjHblQzJMvZahj8sUgtqhb",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Сейчас **11:13** (московское время), 8 октября 2026 года, четверг.",
"reasoning_content": "The user asked what time it is. I got the current time for Moscow timezone: 2026-10-08T11:13:06, so it's 11:13 AM on October 8, 2026."
},
"finish_reason": "stop",
"native_finish_reason": "stop"
}
],
"created": 1791449121,
"model": "glm-5.3",
"object": "chat.completion",
"usage": {
"prompt_tokens": 267,
"completion_tokens": 73,
"total_tokens": 340,
"completion_tokens_details": {
"text_tokens": 0,
"accepted_prediction_tokens": 0,
"audio_tokens": 0,
"image_tokens": 0,
"reasoning_tokens": 48,
"rejected_prediction_tokens": 0
},
"prompt_tokens_details": {
"text_tokens": 0,
"cache_creation_input_tokens": 0,
"audio_tokens": 0,
"audio_cached_tokens": 0,
"cached_tokens": 0,
"cache_write_tokens": 0,
"image_tokens": 0
}
}
}
OpenAI: Responses
Запрос 1: вопрос и описание функции
curl --location 'https://api.cdnvideo.ru/app/aihub-router/v1/responses' \
--header "Authorization: Bearer $AIHUB_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"instructions": "Не выдумывай дату и время. Если часовой пояс не указан, используй Europe/Moscow.",
"input": "Который час?",
"tools": [
{
"type": "function",
"name": "current_time",
"description": "Возвращает текущие дату и время для часового пояса IANA.",
"parameters": {
"type": "object",
"properties": {
"timezone": {"type": "string", "description": "Часовой пояс, например Europe/Moscow."}
},
"required": ["timezone"],
"additionalProperties": false
}
}
],
"tool_choice": {
"type": "function",
"name": "current_time"
}
}'
Ответ API с запросом на вызов функции:
{
"id": "resp_08cf31ee9d0b68df016ac74f36f1088197bda73e8990c2460a",
"instructions": "Не выдумывай дату и время. Если часовой пояс не указан, используй Europe/Moscow.",
"metadata": {},
"model": "gpt-6-astra",
"output": [
{
"id": "fc_08cf31ee9d0b68df016ac74f38093081979a007df4ca0fcdec",
"type": "function_call",
"status": "completed",
"arguments": "{\"timezone\":\"Europe/Moscow\"}",
"call_id": "call_54jGlyZ6i65i7nf0ANQADECV",
"name": "current_time"
}
],
"temperature": 1.0,
"tools": [
{
"type": "function",
"description": "Возвращает текущие дату и время для часового пояса IANA.",
"name": "current_time",
"output_schema": null,
"parameters": {
"type": "object",
"properties": {
"timezone": {
"type": "string",
"description": "Часовой пояс, например Europe/Moscow."
}
},
"required": ["timezone"],
"additionalProperties": false
},
"strict": true
}
],
"background": false,
"reasoning": {
"mode": "standard",
"context": "all_turns",
"effort": "medium"
},
"status": "completed",
"text": {
"format": {"type": "text"},
"verbosity": "medium"
},
"truncation": "disabled",
"usage": {
"input_tokens": 94,
"input_tokens_details": {
"cached_tokens": 0,
"cache_write_tokens": 0
},
"output_tokens": 20,
"output_tokens_details": {"reasoning_tokens": 0},
"total_tokens": 114
},
"store": false,
"created_at": 1791446838,
"object": "response",
"parallel_tool_calls": true,
"tool_choice": {"type": "function", "name": "current_time"},
"top_p": 0.98,
"completed_at": 1791446840,
"prompt_cache_retention": "24h",
"service_tier": "default",
"top_logprobs": 0,
"presence_penalty": 0.0,
"frequency_penalty": 0.0
}
Запрос 2: передайте результат функции
Повторите исходный ввод и вызов функции, затем добавьте результат как function_call_output с тем же call_id:
curl --location 'https://api.cdnvideo.ru/app/aihub-router/v1/responses' \
--header "Authorization: Bearer $AIHUB_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"instructions": "Не выдумывай дату и время. Если часовой пояс не указан, используй Europe/Moscow.",
"input": [
{"role": "user", "content": "Который час?"},
{
"type": "function_call",
"call_id": "call_54jGlyZ6i65i7nf0ANQADECV",
"name": "current_time",
"arguments": "{\"timezone\":\"Europe/Moscow\"}"
},
{
"type": "function_call_output",
"call_id": "call_54jGlyZ6i65i7nf0ANQADECV",
"output": "{\"datetime\":\"2026-10-08T11:09:06.644179+03:00\",\"timezone\":\"Europe/Moscow\"}"
}
],
"tools": [
{
"type": "function",
"name": "current_time",
"description": "Возвращает текущие дату и время для часового пояса IANA.",
"parameters": {
"type": "object",
"properties": {
"timezone": {"type": "string", "description": "Часовой пояс, например Europe/Moscow."}
},
"required": ["timezone"],
"additionalProperties": false
}
}
],
"tool_choice": "auto"
}'
Модель вернёт финальное сообщение в output; в OpenAI SDK текст ответа также доступен через response.output_text:
{
"id": "resp_0bc060d273dc982b016ac7580fd05081969d13bf84f9f3695d",
"instructions": "Не выдумывай дату и время. Если часовой пояс не указан, используй Europe/Moscow.",
"metadata": {},
"model": "gpt-6-astra",
"output": [
{
"id": "msg_0bc060d273dc982b016ac7581120648196a539cca421529053",
"type": "message",
"status": "completed",
"content": [
{
"type": "output_text",
"annotations": [],
"logprobs": [],
"text": "Сейчас 11:09 по московскому времени."
}
],
"phase": "final_answer",
"role": "assistant"
}
],
"temperature": 1.0,
"tools": [
{
"type": "function",
"description": "Возвращает текущие дату и время для часового пояса IANA.",
"name": "current_time",
"output_schema": null,
"parameters": {
"type": "object",
"properties": {
"timezone": {
"type": "string",
"description": "Часовой пояс, например Europe/Moscow."
}
},
"required": ["timezone"],
"additionalProperties": false
},
"strict": true
}
],
"background": false,
"reasoning": {
"mode": "standard",
"context": "all_turns",
"effort": "medium"
},
"status": "completed",
"text": {
"format": {"type": "text"},
"verbosity": "medium"
},
"truncation": "disabled",
"usage": {
"input_tokens": 154,
"input_tokens_details": {
"cached_tokens": 0,
"cache_write_tokens": 0
},
"output_tokens": 15,
"output_tokens_details": {"reasoning_tokens": 0},
"total_tokens": 169
},
"store": false,
"created_at": 1791449103,
"object": "response",
"parallel_tool_calls": true,
"tool_choice": "auto",
"top_p": 0.98,
"completed_at": 1791449105,
"prompt_cache_retention": "24h",
"service_tier": "default",
"top_logprobs": 0,
"presence_penalty": 0.0,
"frequency_penalty": 0.0
}
Anthropic: Messages
Запрос 1: вопрос и описание функции
curl --location 'https://api.cdnvideo.ru/app/aihub-router/v1/messages' \
--header "Authorization: Bearer $AIHUB_API_KEY" \
--header 'Content-Type: application/json' \
--header 'anthropic-version: 2023-06-01' \
--data '{
"model": "claude-opus-5.5",
"max_tokens": 1024,
"system": "Не выдумывай дату и время. Для ответа вызови current_time с часовым поясом Europe/Moscow.",
"messages": [
{"role": "user", "content": "Который час?"}
],
"tools": [
{
"name": "current_time",
"description": "Возвращает текущие дату и время для часового пояса IANA.",
"input_schema": {
"type": "object",
"properties": {
"timezone": {"type": "string", "description": "Часовой пояс, например Europe/Moscow."}
},
"required": ["timezone"],
"additionalProperties": false
}
}
],
"tool_choice": {"type": "auto"}
}'
Вызов tools в claude-opus-5.5
Для этой модели принудительный выбор инструмента через tool_choice типа tool или any возвращает ошибку. Используйте type: auto и явно попросите модель вызвать функцию в system или сообщении пользователя.
Ответ API с запросом на вызов функции:
{
"id": "msg_bdrk_8bps0gzojw7t671zpqvvtuhukdekj2tr4ik5p1jz1dd7nken8c3u",
"type": "message",
"role": "assistant",
"content": [
{
"type": "tool_use",
"id": "toolu_bdrk_01dgr33COcNYLCDyfXEA5PQp",
"input": {"timezone": "Europe/Moscow"},
"name": "current_time"
}
],
"model": "claude-opus-5.5",
"usage": {
"cache_creation": {
"ephemeral_5m_input_tokens": 0,
"ephemeral_1h_input_tokens": 0
},
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"input_tokens": 458,
"output_tokens": 56,
"service_tier": "standard",
"output_tokens_details": {"thinking_tokens": 0}
},
"stop_reason": "tool_use",
"stop_sequence": null
}
Клиент выполняет функцию и получает, например, {"datetime":"2026-10-08T11:20:58.071113+03:00","timezone":"Europe/Moscow"}.
Запрос 2: передайте результат функции
Повторите описание tools и передайте исходный вопрос, блок tool_use из ответа модели и результат в новом сообщении user. В поле tool_use_id укажите id вызова:
curl --location 'https://api.cdnvideo.ru/app/aihub-router/v1/messages' \
--header "Authorization: Bearer $AIHUB_API_KEY" \
--header 'Content-Type: application/json' \
--header 'anthropic-version: 2023-06-01' \
--data '{
"model": "claude-opus-5.5",
"max_tokens": 1024,
"system": "Не выдумывай дату и время. Для ответа вызови current_time с часовым поясом Europe/Moscow.",
"messages": [
{"role": "user", "content": "Который час?"},
{
"role": "assistant",
"content": [
{
"type": "tool_use",
"id": "toolu_bdrk_01dgr33COcNYLCDyfXEA5PQp",
"name": "current_time",
"input": {"timezone": "Europe/Moscow"}
}
]
},
{
"role": "user",
"content": [
{
"type": "tool_result",
"tool_use_id": "toolu_bdrk_01dgr33COcNYLCDyfXEA5PQp",
"content": "{\"datetime\":\"2026-10-08T11:20:58.071113+03:00\",\"timezone\":\"Europe/Moscow\"}"
}
]
}
],
"tools": [
{
"name": "current_time",
"description": "Возвращает текущие дату и время для часового пояса IANA.",
"input_schema": {
"type": "object",
"properties": {
"timezone": {
"type": "string",
"description": "Часовой пояс, например Europe/Moscow."
}
},
"required": ["timezone"],
"additionalProperties": false
}
}
],
"tool_choice": {"type": "auto"}
}'
Модель использует результат и возвращает финальное сообщение. Длинная подпись в поле content[0].signature сокращена:
{
"id": "msg_bdrk_oag0jl8z58mx10woxzwhyjdf17afips37lms5923zrp8fsnoexg2",
"type": "message",
"role": "assistant",
"content": [
{
"type": "thinking",
"signature": "[длинная подпись сокращена]",
"thinking": ""
},
{
"type": "text",
"text": "Сейчас 11:20 (8 октября 2026 года, московское время).",
"citations": []
}
],
"model": "claude-opus-5.5",
"usage": {
"cache_creation": {
"ephemeral_5m_input_tokens": 0,
"ephemeral_1h_input_tokens": 0
},
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"input_tokens": 563,
"output_tokens": 27,
"service_tier": "standard",
"output_tokens_details": {"thinking_tokens": 0}
},
"stop_reason": "end_turn",
"stop_sequence": null
}