Документация Kiree API
Единый OpenAI-совместимый шлюз к текстовым, изображательным, видео и голосовым моделям. Одна точка входа, один ключ — формат запросов и ответов совместим с OpenAI SDK, поэтому существующий код достаточно навести на новый Base URL.
Текст
Чат, рассуждения, код и быстрые диалоги через /v1/chat/completions.
Изображения
Генерация картинок по описанию через /v1/images/generations.
Видео
Асинхронные ролики: создание задачи и опрос статуса через /v1/videos.
Голос
Синтез речи из текста через /v1/audio/speech.
Base URL
Все запросы к API начинаются с этого адреса. В SDK это параметр base_url, в переменных окружения — OPENAI_API_BASE.
https://kiree.net/v1
Эндпоинты
| Метод | Путь | Описание | Статус |
|---|---|---|---|
| POST | /v1/chat/completions | Текст, чат, потоковый ответ по SSE | Доступно |
| POST | /v1/completions | Текстовое дополнение (legacy Completions API) | Доступно |
| POST | /v1/responses | Responses API (формат OpenAI) | Доступно |
| POST | /v1/messages | Формат Messages (Anthropic) | Доступно |
| GET | /v1/models | Список моделей, доступных вашему ключу | Доступно |
| GET | /v1/models/{model_id} | Метаданные конкретной модели | Доступно |
| POST | /v1/images/generations | Синхронная генерация изображений | Доступно |
| POST | /v1/audio/speech | Синтез речи (TTS) | Доступно |
| POST | /v1/videos | Создание асинхронной видео-задачи | Доступно |
| GET | /v1/videos/{job_id} | Статус и результат видео-задачи | Доступно |
О моделях. Список ID моделей, доступных вашему ключу, и их тарифы смотрите в каталоге моделей. Один ключ работает для текстовых, изображательных, видео и голосовых моделей шлюза.
Hello, world
Минимальный запрос к чат-модели. Замените sk-your-kiree-key на ключ из консоли.
cURL
curl -X POST https://kiree.net/v1/chat/completions \
-H "Authorization: Bearer sk-your-kiree-key" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat",
"messages": [{"role": "user", "content": "Привет!"}]
}'Python
from openai import OpenAI
client = OpenAI(
api_key="sk-your-kiree-key",
base_url="https://kiree.net/v1"
)
response = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "Привет!"}]
)
print(response.choices[0].message.content)