РАЗРАБОТЧИКАМ
Пять минут от API-ключа до первого ответа.
AREVIA API использует формат OpenAI Chat Completions, поэтому ваши SDK, фреймворки и инструменты работают с ним после замены двух строк: базового URL и названия модели.
Три шага
-
01
Создайте ключ
Войдите в AREVIA Studio, откройте раздел «API-ключи» и создайте ключ для своего проекта. Ключ можно ограничить одним окружением.
-
02
Укажите базовый URL
Настройте клиент на адрес https://api.areviaai.net/v1 и передавайте ключ как Bearer-токен.
-
03
Отправьте запрос
Вызовите chat completions, указав модель, например sevan-2. Чтобы получать ответ по токенам, передайте параметр «stream» со значением true.
curl https://api.areviaai.net/v1/chat/completions \
-H "Authorization: Bearer $AREVIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sevan-2",
"messages": [{"role": "user", "content": "Кратко изложи этот договор в трёх пунктах."}]
}'
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.areviaai.net/v1" ,
api_key=os.environ["AREVIA_API_KEY"],
)
response = client.chat.completions.create(
model="sevan-2",
messages=[{"role": "user", "content": "Кратко изложи этот договор в трёх пунктах."}],
)
print(response.choices[0].message.content)
$ch = curl_init('https://api.areviaai.net/v1/chat/completions' );
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('AREVIA_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'sevan-2',
'messages' => [['role' => 'user', 'content' => 'Кратко изложи этот договор в трёх пунктах.']],
]),
]);
$response = json_decode(curl_exec($ch), true);
echo $response['choices'][0]['message']['content'];
const res = await fetch("https://api.areviaai.net/v1/chat/completions" , {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.AREVIA_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "sevan-2",
messages: [{ role: "user", content: "Кратко изложи этот договор в трёх пунктах." }],
}),
});
const data = await res.json();
console.log(data.choices[0].message.content);
200 OKОтвет
{
"id": "chatcmpl-7f3a9c2e",
"model": "sevan-2",
"choices": [{
"index": 0,
"message": {
"role": "assistant",
"content": "1. Срок: 36 месяцев с даты подписания.\n2. Ставка: 11,5% годовых, фиксированная.\n3. Досрочное погашение допускается без штрафа."
},
"finish_reason": "stop"
}],
"usage": { "prompt_tokens": 1843, "completion_tokens": 96 }
}
Что поддерживает API
-
01
Генерация ответов
Многоходовые диалоги с системными инструкциями на тех языках, на которых говорят ваши пользователи.
-
02
Потоковая передача
Вывод по токенам через server-sent events для отзывчивых интерфейсов.
-
03
Вызов функций
Модель вызывает ваши внутренние API с проверенными типизированными аргументами.
-
04
Структурированный вывод
Каждый ответ содержит валидный JSON строго по заданной вами схеме.
-
05
Эмбеддинги
Межъязыковые векторы для поиска и извлечения информации на базе модели Garni.
-
06
Пакетная обработка
Крупные асинхронные задания за половину цены запросов в реальном времени.
Эндпоинты
BASE URLhttps://api.areviaai.net/v1
| МЕТОД | ПУТЬ | ОПИСАНИЕ |
|---|---|---|
| POST | /v1/chat/completions |
Сгенерировать ответ языковой модели |
| POST | /v1/embeddings |
Создать векторные представления текста |
| POST | /v1/audio/transcriptions |
Преобразовать аудио в текст |
| POST | /v1/audio/speech |
Синтезировать речь из текста |
| POST | /v1/moderations |
Проверить контент и замаскировать персональные данные |
| POST | /v1/batches |
Отправить асинхронное пакетное задание |
| GET | /v1/models |
Получить список моделей, доступных вашему ключу |
Лимиты по умолчанию
| ТАРИФ | ЗАПРОСОВ В МИНУТУ | ТОКЕНОВ В МИНУТУ | ТОКЕНОВ В ПАКЕТНОЙ ОЧЕРЕДИ |
|---|---|---|---|
| Developer | 60 | 200 000 | 1 000 000 |
| Business | 600 | 2 000 000 | 50 000 000 |
| Enterprise | Индивидуально | Индивидуально | Индивидуально |
Лимиты повышаются по запросу, обычно в течение одного рабочего дня.
ИНСТРУМЕНТЫ
Работает с тем, чем вы уже пользуетесь
Официальные SDK OpenAI для Python и JavaScript, LangChain, LlamaIndex и любой HTTP-клиент. Проприетарный SDK не нужен: приведённый на этой странице пример на PHP использует только cURL.