AIRouter

Vercel AI SDK · OpenAI Compatible

Vercel AI SDK и AIRouter: OpenAI-compatible provider

Vercel AI SDK поддерживает OpenAI-compatible providers. Для AIRouter создайте provider через createOpenAICompatible, передайте baseURL, apiKey и модель.

Прямая настройка Vercel AI SDK: OpenAI-compatible providers

Короткий ответ

Да, Vercel AI SDK можно подключить к AIRouter через createOpenAICompatible.

Передайте name, apiKey и baseURL https://api.ai-router.app/v1.

Модель вызывайте через provider("<AIROUTER_MODEL>").

Для serverless/edge окружения храните AIRouter ключ в секретах платформы.

Что понадобится

Начните с регистрации AIRouter, проверьте модели и цены, пополните баланс от 100 ₽, а базовый OpenAI‑compatible quickstart держите под рукой в документации.

  • AIRouter аккаунт, подтверждённый email и положительный баланс.
  • Vercel AI SDK в версии с поддержкой OpenAI-compatible/custom provider.
  • AIRouter API‑ключ, сохранённый как секрет.
  • Model id из публичного каталога AIRouter.

Quick test

Быстрая проверка перед рабочим сценарием

Начните с пополнения от 100 ₽ и короткого тестового запроса.

  1. Создайте аккаунт AIRouter.Создайте аккаунт и откройте кабинет.
  2. Выберите модель.Возьмите id из публичного каталога и начните с короткого текстового prompt.
  3. Пополните баланс от 100 ₽.Пополните баланс в кабинете и проверяйте итоговый статус в истории платежей.
  4. Отправьте короткий запрос.Например: «Проверь подключение и ответь коротко», затем проверяйте более сложные agent flows.

Пошаговая настройка

  1. Создайте OpenAI-compatible providerИспользуйте createOpenAICompatible и имя airouter.
  2. Передайте baseURL и ключbaseURL должен быть https://api.ai-router.app/v1, ключ храните в AIROUTER_API_KEY.
  3. Выберите model idЗамените <AIROUTER_MODEL> на модель из каталога AIRouter.

Пример конфига

В публичных примерах используйте <AIROUTER_API_KEY>, <AIROUTER_MODEL> или переменную AIROUTER_API_KEY.

provider.ts

import { createOpenAICompatible } from "@ai-sdk/openai-compatible";

export const airouter = createOpenAICompatible({
  name: "airouter",
  apiKey: process.env.AIROUTER_API_KEY,
  baseURL: "https://api.ai-router.app/v1",
});

usage

const model = airouter("<AIROUTER_MODEL>");

Проверка

  • Отправьте короткий prompt без доступа к приватным данным.
  • Проверьте, что endpoint указывает на https://api.ai-router.app/v1.
  • Если клиент сообщает об ошибке модели, auth или баланса, сначала проверьте model id, API‑ключ и состояние платежа.

Частые ошибки

  • Указать корень https://ai-router.app вместо канонического API base URL.
  • Скопировать реальный API‑ключ в публичный конфиг.
  • Использовать model id, которого нет в каталоге AIRouter.
  • Включить сложные agent tools до проверки простого ответа.

FAQ

Какой helper нужен?

createOpenAICompatible из @ai-sdk/openai-compatible.

Какой baseURL указать?

https://api.ai-router.app/v1.

Можно ли использовать streamText?

Проверяйте streaming на выбранной модели и вашем runtime перед рабочим запуском.

Ограничения

Проверяйте совместимость streaming и tool calling на выбранной модели.

Для edge/serverless окружения храните AIRouter ключ в секретах платформы.

Не смешивайте baseURL с полным path /chat/completions.

Официальные источники

Vercel AI SDK: OpenAI-compatible providers

  • Официальная документация Vercel AI SDK подтверждает createOpenAICompatible для OpenAI-compatible providers.

← Все инструкции · Модели и цены · Начать