Быстрый старт

Новые аккаунты получают $0.05 пробного кредита, поэтому вы можете сделать первый вызов ниже без пополнения баланса. Легковесной модели, такой как gpt-5.4-mini, более чем достаточно, чтобы убедиться, что ваша интеграция работает.

Два пути, выберите один

Пусть ИИ сделает это

Скопируйте один prompt в Codex, Claude Code или Cursor. Он читает документацию, пишет код и запускает его. Лучше всего, если вы уже работаете с агентом для написания кода.

Сделайте это сами

Зарегистрируйтесь, создайте ключ, выполните первый запрос. Три шага, пять минут. Лучше всего, если вы хотите разобраться в каждом элементе.

Оба пути начинаются одинаково: вы сами регистрируете аккаунт и создаете ключ. То, что ИИ может взять на себя после этого, — это выбор модели, правильная настройка базового URL, написание примера и его отладка.

Пусть это сделает ИИ

Отправьте своему агенту этот промпт

Пусть агент для написания кода самостоятельно интегрирует APIYI. Скопируйте и вставьте этот текст в Codex, Claude Code, Cursor или аналогичные инструменты.

Что он будет делать

Установит навык или напрямую прочитает skill.md

https://docs.apiyi.com/skill.md — это справочник по интеграции, составленный для машин: эндпоинты, аутентификация, правило именования моделей, известные подводные камни и контрольный список проверки. Прочитав его, агент получит всё необходимое для интеграции APIYI.

Будет находить страницы по мере необходимости

llms.txt — это индекс всех страниц на этом сайте. Агент выбирает необходимые страницы и добавляет к ним .md, чтобы прочитать их как обычный текст.

Напишет код и действительно запустит его

Он напишет пример на существующем в вашем проекте языке программирования и с использованием его зависимостей, а не просто скопирует Python-код из документации. Работа не считается завершённой, пока вызов не выполнится успешно.

Пять способов передать данные ИИ

Точка входа	URL	Когда использовать
Навык	`https://docs.apiyi.com/skill.md`	Передайте агенту полный справочник по интеграции одним сообщением. Начните отсюда.
Индекс страниц	`https://docs.apiyi.com/llms.txt`	Позвольте агенту решить, какая страница ему нужна
Отдельная страница в виде текста	Добавьте `.md` к любому URL документации	Если вас интересует только одна страница — это дешевле, чем HTML
MCP-сервер	`https://docs.apiyi.com/mcp`	Подключите этот сайт документации как MCP-сервер, чтобы агент мог искать информацию в нём в реальном времени
Реестр моделей	`https://docs.apiyi.com/model-registry.json`	Машиночитаемые идентификаторы моделей, эндпоинты, группы и опубликованные цены, чтобы агент перестал делать предположения

Навык, CLI и путь с контрактом и реестром для агентов, пишущих код, описаны в наборе инструментов для разработчиков ИИ.

Например, версия этой страницы в виде обычного текста находится по адресу https://docs.apiyi.com/en/getting-started.md. Все страницы сайта поддерживают этот суффикс.

Отправляйте любую страницу напрямую ИИ

На каждой странице документации в правом верхнем углу есть кнопка Копировать страницу. При нажатии на стрелку рядом с ней открываются дополнительные параметры:

Меню копирования страницы в правом верхнем углу страницы документации с параметрами копирования страницы, просмотра в виде Markdown и открытия в ChatGPT, Claude, Perplexity или Google AI Studio

Параметр	Что он делает
Копировать страницу	Копирует текущую страницу в формате Markdown в буфер обмена, чтобы её можно было вставить в любой ИИ
Просмотреть в формате Markdown	Открывает версию в виде обычного текста в браузере — удобно для проверки или отправки ссылки
Открыть в ChatGPT	Переходит в ChatGPT и передаёт эту страницу в качестве контекста
Открыть в Claude	То же действие для Claude
Открыть в Perplexity	То же действие для Perplexity
Открыть в Google AI Studio	То же действие для Google AI Studio

Если у вас возникла проблема с определённой моделью, быстрее всего открыть страницу этой модели, нажать Копировать страницу и отправить её ИИ вместе с описанием ошибки.

Самостоятельная настройка

Шаг 1. Регистрация и получение ключа

Создание аккаунта

Перейдите на сайт APIYI, зарегистрируйтесь с помощью электронной почты и подтвердите её (рекомендуется использовать университетский или корпоративный адрес), затем войдите в консоль.

Сразу после регистрации привяжите 2FA или Passkey, чтобы добавить второй этап проверки: даже в случае утечки пароля никто не сможет войти без вашего устройства или одноразового кода. Это займет всего пару минут: см. Как защитить свой аккаунт.

Создание API-ключа

Откройте страницу token:

Вы можете скопировать token по умолчанию и сразу использовать его (значок копирования справа)
Или нажмите New в правом верхнем углу, чтобы создать новый, задайте ему имя (например, test-key) и подтвердите

Ключи начинаются с sk-. Подробнее см. в руководстве Как создать ключ.

Пополнение при необходимости

Когда пробный баланс в $0.05 закончится, выполните пополнение через консоль. Минимальные суммы и правила расчетов зависят от способа оплаты — см. Способы оплаты, — а бонусная политика описана в разделе Акции при пополнении.

Шаг 2. Настройка параметров подключения

Выбирайте базовый URL в зависимости от SDK, а не от модели. Это самая распространенная ошибка интеграции:

Ваш SDK	Базовый URL	Причина
OpenAI SDK (и большинство клиентов)	`https://api.apiyi.com/v1`	SDK сам добавляет `/chat/completions`, поэтому `/v1` здесь обязателен
Anthropic SDK (нативный Claude)	`https://api.apiyi.com`	SDK сам добавляет `/v1/messages` — добавление `/v1` приведет к `/v1/v1/messages` и ошибке 404
Google GenAI SDK (нативный Gemini)	`https://api.apiyi.com`	Также укажите `api_version: "v1beta"`

Не оставляйте завершающий слеш в base_url — это приведет к двойному слешу и ошибке 404. Подробная информация и выбор узла приведены в разделе Настройка базового URL.

Шаг 3. Выполните первый вызов

curl https://api.apiyi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Python
Node.js
Java

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIYI_API_KEY"],
    base_url="https://api.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

print(response.choices[0].message.content)

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: process.env.APIYI_API_KEY,
  baseURL: 'https://api.apiyi.com/v1'
});

const response = await openai.chat.completions.create({
  model: 'gpt-5.4-mini',
  messages: [{ role: 'user', content: 'Hello!' }]
});

console.log(response.choices[0].message.content);

// Using the official OpenAI Java library
OpenAiService service = new OpenAiService(
    System.getenv("APIYI_API_KEY"),
    Duration.ofSeconds(60),
    "https://api.apiyi.com/v1"
);

ChatCompletionRequest request = ChatCompletionRequest.builder()
    .model("gpt-5.4-mini")
    .messages(List.of(
        new ChatMessage(ChatMessageRole.USER, "Hello!")
    ))
    .build();

ChatCompletionResult result = service.createChatCompletion(request);
System.out.println(result.getChoices().get(0).getMessage().getContent());

Для серии gpt-5 и выше действуют три ограничения на параметры: temperature должен быть равен 1, используйте max_completion_tokens вместо max_tokens и не отправляйте top_p.

Следующие шаги

Подключите Claude Code

Настройте ANTHROPIC_BASE_URL и управляйте Claude Code через APIYI

Подключите Codex

Одна config.toml охватывает настольное приложение, плагин IDE и CLI

Изучите список моделей

Каждая поддерживаемая модель и шпаргалка по возможностям

Прочитайте руководство по API

Полный справочник по эндпоинтам, коды ошибок и отладка

FAQ

Как переключать модели?

Просто измените параметр model в вашем запросе:

{
  "model": "gpt-5.6-sol",         // Use GPT-5.6 Sol
  "model": "claude-opus-5",       // Use Claude Opus 5
  "model": "gemini-3.6-flash"     // Use Gemini 3.6 Flash
}

Идентификаторы моделей используют точки, а не дефисы. Дефисы в URL документации — это замена для безопасного использования URL; настоящий идентификатор модели сохраняет точки. Страница /models/qwen3-7-max соответствует идентификатору модели qwen3.7-max. Если указать gpt-5-4-mini, вернётся 404 — правильная форма: gpt-5.4-mini.Если сомневаетесь, выведите их списком: GET https://api.apiyi.com/v1/models.

Какие языки программирования поддерживаются?

APIYI совместим со стандартами OpenAI API и поддерживает все языки, которые поддерживают SDK OpenAI:

Python
JavaScript/TypeScript
Java
C#/.NET
Go
Ruby
PHP
И другие…

Как проверить баланс?

Войдите в консоль, чтобы просмотреть:

Баланс аккаунта
Историю использования
Статистику потребления

Вы также можете выполнить запрос программно через API:

API запроса баланса: Получите баланс аккаунта, дату истечения и многое другое через API
Настройка оповещения о низком балансе: Автоматически уведомлять при низком балансе, чтобы избежать прерывания работы сервиса

Что делать, если возникла проблема?

Откройте страницу, с которой у вас возникла проблема, нажмите Copy page в правом верхнем углу и отправьте её в AI вместе с вашей ошибкой
Ознакомьтесь с руководством API
Просмотрите частые ошибки
Свяжитесь со службой поддержки: [email protected]

Совет: храните ваш API key в безопасном месте и регулярно проверяйте журналы использования в консоли. Каждый запрос содержит историю сообщений для оптимизации затрат. Приятной работы!

Основы

Базовый API

Image API (официальный)

Video API (официальный)

API мультимодального понимания

Генерация текста

Audio API (официальный)

Поиск и безопасность

Два пути, выберите один

Пусть ИИ сделает это

Сделайте это сами

Пусть это сделает ИИ

Отправьте своему агенту этот промпт

Что он будет делать

Пять способов передать данные ИИ

Отправляйте любую страницу напрямую ИИ

Самостоятельная настройка

Шаг 1. Регистрация и получение ключа

Шаг 2. Настройка параметров подключения

Шаг 3. Выполните первый вызов

Следующие шаги

Подключите Claude Code

Подключите Codex

Изучите список моделей

Прочитайте руководство по API

FAQ

Как переключать модели?

Какие языки программирования поддерживаются?

Как проверить баланс?

Что делать, если возникла проблема?

​Два пути, выберите один

Пусть ИИ сделает это

Сделайте это сами

​Пусть это сделает ИИ

​Отправьте своему агенту этот промпт

​Что он будет делать

​Пять способов передать данные ИИ

​Отправляйте любую страницу напрямую ИИ

​Самостоятельная настройка

​Шаг 1. Регистрация и получение ключа

​Шаг 2. Настройка параметров подключения

​Шаг 3. Выполните первый вызов

​Следующие шаги

Подключите Claude Code

Подключите Codex

Изучите список моделей

Прочитайте руководство по API

​FAQ

​Как переключать модели?

​Какие языки программирования поддерживаются?

​Как проверить баланс?

​Что делать, если возникла проблема?

Два пути, выберите один

Пусть это сделает ИИ

Отправьте своему агенту этот промпт

Что он будет делать

Пять способов передать данные ИИ

Отправляйте любую страницу напрямую ИИ

Самостоятельная настройка

Шаг 1. Регистрация и получение ключа

Шаг 2. Настройка параметров подключения

Шаг 3. Выполните первый вызов

Следующие шаги

FAQ

Как переключать модели?

Какие языки программирования поддерживаются?

Как проверить баланс?

Что делать, если возникла проблема?