Быстрый старт
Создайте API-ключ и выполните первый запрос к Makura с помощью официального SDK.
Создайте API-ключ
- Откройте панель API-ключей MakuraConsole.
- Нажмите Создать ключ.
- Скопируйте секрет и сохраните его в защищённом хранилище.
Для запросов к моделям используется обычный API-ключ. Административные эндпоинты /v1/account/* требуют управляющий ключ.
Установите SDK
Makura совместима с OpenAI API, поэтому можно использовать официальный SDK.
pip install openainpm install openaiВыполните первый запрос
Укажите Makura в base_url и передайте созданный API-ключ. Для новых LLM-приложений рекомендуем начинать с Responses API: он поддерживает текст, потоковую передачу, инструменты, структурированные ответы и мультимодальные данные.
from openai import OpenAI
client = OpenAI(
api_key="YOUR_MAKURA_API_KEY",
base_url="https://api.makura.ai/v1",
)
response = client.responses.create(
model="openai/gpt-4o-mini",
input="Напиши историю об единороге одним предложением.",
)
print(response.output_text)import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.MAKURA_API_KEY,
baseURL: "https://api.makura.ai/v1",
});
const response = await client.responses.create({
model: "openai/gpt-4o-mini",
input: "Напиши историю об единороге одним предложением.",
});
console.log(response.output_text);curl https://api.makura.ai/v1/responses -H "Authorization: Bearer $MAKURA_API_KEY" -H "Content-Type: application/json" -d '{
"model": "openai/gpt-4o-mini",
"input": "Напиши историю об единороге одним предложением."
}'Обработайте ответ
Получите текст из объекта ответа и обрабатывайте ошибки на сервере приложения.
{
"id": "resp_123",
"object": "response",
"output": [
{
"type": "message",
"content": [
{
"type": "output_text",
"text": "Единорог уснул под залитым лунным светом деревом."
}
]
}
]
}Следующие шаги
- Прочитайте Аутентификацию.
- Откройте Справочник API со схемами запросов и ответов.
- Используйте каталог моделей, чтобы сравнить возможности, доступность и стоимость.