Доступ к API

22 сентября 2026 · AIAdapter · https://www.aiadapter.com

AIAdapter предоставляет API, совместимый с OpenAI. Учётная запись выдаёт один API-ключ. Тем же ключом аутентифицируются все запросы — и настольные клиенты, и код приложения. Не создавайте второй ключ на модель, поставщика или клиент.

Заменяйте origin ниже только для непроизводственного узла. Путь /v1 обязателен.

1. Учётные данные

Войдите, откройте Консоль → API Keys и создайте ключ один раз. Секрет показывается при создании; сразу сохраните его и используйте везде.

Официальные клиенты OpenAI добавляют к базовому URL пути вроде /chat/completions. Указывайте …/v1, а не корень сайта.

Ключ — секрет. Не коммитьте его, не вставляйте в тикеты и не встраивайте в браузерный JavaScript, мобильные приложения или иные клиенты, которые может просмотреть конечный пользователь. Загружайте из переменной окружения или менеджера секретов. При утечке удалите ключ и создайте одну замену.

2. Прямой доступ из клиента

Этот путь — когда нужно вызывать модели из уже существующего OpenAI-совместимого приложения и не писать код интеграции. Типичные клиенты: Cursor, Claude Desktop, Cherry Studio, Continue, LibreChat.

Настраиваются только три поля. Ключ — тот же, что выдан в консоли.

Cursor

1. Откройте Settings → Models.
2. Вставьте ключ в поле OpenAI API Key.
3. Включите Override OpenAI Base URL и укажите https://www.aiadapter.com/v1 (строчные v1).
4. Добавьте идентификатор модели с витрины в Custom Models. Предпочитайте ID, который не совпадает со встроенной моделью Cursor.

Cursor Tab и часть встроенных моделей Cursor не используют пользовательский OpenAI base URL. После переопределения общайтесь с ID модели с витрины. Если поле не принимает фокус, обновите Cursor до 3.15.20 или новее.

Другие OpenAI-совместимые клиенты

В Claude Desktop, Cherry Studio, Continue, LibreChat или любом клиенте с провайдером, совместимым с OpenAI:

• Провайдер / тип API: OpenAI compatible
• Base URL: https://www.aiadapter.com/v1
• API key: единственный ключ AIAdapter
• Модель: идентификатор с витрины

Не выпускайте второй ключ для второго клиента. Два клиента с одним ключом — штатная схема.

3. Интеграция в приложение

Этот путь — когда вы пишете программу. Контракт тот же: один ключ, один base URL, Bearer. Примеры ниже используют официальные библиотеки OpenAI как подменяемый клиент.

Задайте AIADAPTER_API_KEY в окружении процесса. Не вшивайте секрет в код. Замените MODEL_ID точным идентификатором с /models, включая префикс продавца.

HTTP

curl https://www.aiadapter.com/v1/chat/completions \
  -H "Authorization: Bearer $AIADAPTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Reply with one word: ok"}]
  }'

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIADAPTER_API_KEY"],
    base_url="https://www.aiadapter.com/v1",
)
response = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "Reply with one word: ok"}],
)
print(response.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AIADAPTER_API_KEY,
  baseURL: "https://www.aiadapter.com/v1",
});
const response = await client.chat.completions.create({
  model: "MODEL_ID",
  messages: [{ role: "user", content: "Reply with one word: ok" }],
});
console.log(response.choices[0].message.content);

4. Модели и конечные точки

Список моделей: GET /v1/models с тем же Bearer-ключом или страница /models. В model передавайте указанный идентификатор. В идентификаторе есть префикс продавца. Копируйте его целиком. Примеры: pixverse/c1, byteplus-intl/dreamina-seedance-2-5-260628. Не отправляйте короткое имя вроде c1 или seedance-2.5.

Типичные маршруты, совместимые с OpenAI:

• POST /v1/chat/completions — чат и языковые модели
• POST /v1/images/generations — модели изображений
• POST /v1/video/generations, затем GET /v1/video/generations/{id} — видеомодели

Изображения

Генерация изображений синхронная. Идентификатор с витрины передавайте в model.

curl https://www.aiadapter.com/v1/images/generations \
  -H "Authorization: Bearer $AIADAPTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus-intl/dola-seedream-5-0-flash-260915",
    "prompt": "A red paper lantern in rain"
  }'

Видео

Отправка сразу возвращает задание. Опрашивайте тот же путь с этим id, пока задача не завершится успехом или ошибкой. Не ждите готовый файл на запросе отправки.

curl https://www.aiadapter.com/v1/video/generations \
  -H "Authorization: Bearer $AIADAPTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse/c1",
    "prompt": "A cat walking across a sunlit kitchen",
    "seconds": "5"
  }'

curl https://www.aiadapter.com/v1/video/generations/JOB_ID \
  -H "Authorization: Bearer $AIADAPTER_API_KEY"

Аудио и прочие модальности — по карточке модели на витрине.

401 — ключ отсутствует или неверен. 429 — ограничение частоты. Недостаток баланса или квоты возвращается как ошибка API; пополните счёт в консоли перед повтором.

5. Обращение с ключом

Одного ключа достаточно для всех интеграций учётки. Дополнительные ключи дробят журнал аудита и увеличивают риск утечки; они не открывают дополнительные модели.

Вопросы: help@aiadapter.com