← Документация для разработчиков
ИнтеграцияVercel AI SDK через aictrlx
Vercel AI SDK подключается к aictrlx через createOpenAI с baseURL: generateText, streamText и инструменты на TypeScript на моделях каталога.
Настройка
Сохраните ключ в переменной окружения
Все примеры ниже читают ключ из AICTRLX_API_KEY, поэтому он не попадает в код.
Shell
export AICTRLX_API_KEY="aictrlx_live_..."Используйте createOpenAI с baseURL и фабрику моделей .chat(): этот API реализует Chat Completions, а не Responses API.
Установка
npm install ai @ai-sdk/openaiTypeScript
import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";
const aictrlx = createOpenAI({
baseURL: "https://aictrlx.ru/v1",
apiKey: process.env.AICTRLX_API_KEY,
});
// aictrlx.chat(...) uses the Chat Completions API; plain aictrlx(...) would call the Responses API.
const { text, response } = await generateText({
model: aictrlx.chat("auto"),
prompt: "Explain vector databases in two sentences.",
});
console.log(text);
console.log(response.modelId); // the model that actually answeredКакую модель указать
- Используйте фабрику моделей
.chat(): aictrlx реализует Chat Completions, а не Responses API. - В качестве имени модели подходят
auto,fast,smartиcoding, а также любой id со страницы моделей.
Сколько это стоит
Оплачиваются токены, которые модель читает и пишет, по ценам за 1 млн токенов со страницы моделей, в рублях: сначала из того, что включено в подписку, сверх — с баланса.
Каждый запрос с моделью, токенами и стоимостью виден в журнале запросов в кабинете.
Если что-то не работает
401сinvalid_api_keyилиmissing_api_key: инструмент не передаёт ключ или это не действующий ключaictrlx_live_.... Создайте новый на странице «API-ключи».404сmodel_not_found: имя модели — не режим маршрутизации (auto,fast,smart,coding) и не id со страницы моделей.403сmodel_not_allowed: ключ ограничен частью моделей; разрешите эту модель в настройках ключа.429: слишком много запросов в минуту (rate_limit_exceeded) или закончилась квота либо бюджет (monthly_quota_exceededи другие).