← Документация для разработчиков

Интеграция

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/openai
TypeScript
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 и другие).

Все ошибки и лимиты →

Другие интеграции