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

Сервера HydraAI API

Для обеспечения максимальной производительности, стабильности и совместимости с различными инструментами HydraAI API доступен через несколько конечных точек (endpoints). Этот раздел поможет выбрать базовый URL для интеграции.

Актуальность информации и статус серверов

Информация на этой странице поддерживается в актуальном состоянии. Состояние API серверов, плановые работы и сбои можно проверить на странице статуса: status.hydraai.ru

Адреса серверов (Base URL)

Выберите одну из следующих конечных точек. Все указанные адреса используют версию API /v1.

Основной сервер

Базовый URL: 

https://api.gidra.ai/v1

Основной сервер поддерживает работу с ZennoPoster.

Резервный сервер (Германия)

Базовый URL: 

https://de.api.gidra.ai/v1

Сервер в России (Санкт-Петербург)

Базовый URL: 

https://spb.api.gidra.ai/v1

Как правильно сформировать Базовый URL (Base URL)

Укажите выбранный адрес в качестве базового URL в вашем коде или приложении. На примере https://api.gidra.ai доступны следующие форматы:

Вариант 1: URL до версии API (рекомендуемый)

https://api.gidra.ai/v1

При использовании этого формата к базовому URL добавляется относительный путь метода, например /chat/completions.

Вариант 2: URL до версии API с закрывающим слешем

https://api.gidra.ai/v1/

В этом случае обращение к методу выполняется как chat/completions.

Вариант 3: Полный URL до метода

https://api.gidra.ai/v1/chat/completions

Этот вариант подходит для простых скриптов и cURL.

Практические примеры

Python (библиотека requests)

import requests

base_url = "https://api.gidra.ai/v1"
path = "/chat/completions"
full_url = f"{base_url}{path}"

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "model": "hydra-gpt",
    "messages": [{"role": "user", "content": "Привет! Как дела?"}]
}

response = requests.post(full_url, headers=headers, json=data)
print(response.json())

cURL (командная строка)

curl -X POST https://api.gidra.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "model": "hydra-gpt",
        "messages": [{"role": "user", "content": "Привет! Как дела?"}]
      }'