Перейти к содержанию

Текстовые модели

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
}