> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Документация LaoZhang API: как подключить модели ИИ

> Базовый URL LaoZhang API, первый запрос в три шага, руководства по API для текста, изображений и видео, цены на модели и порядок оплаты.

LaoZhang API — шлюз к ИИ-моделям, которым с 2025 года управляет сингапурская компания YingTu Technology Pte. Ltd. Один API-ключ и один базовый URL открывают доступ к моделям изображений Google Nano Banana, OpenAI GPT Image и xAI Grok Imagine, а также к текстовым и видеомоделям других провайдеров.

> [!NOTE]
>
> **Регистрация и доступность сервиса зависят от проверки по белому списку.**
>
> * [Регистрация](https://api.laozhang.ai/register) возможна только с адресом Gmail.
> * Компании могут запросить добавление в белый список: напишите на [hi@laozhang.ai](mailto:hi@laozhang.ai) или в Telegram [@laozhang\_cn](https://t.me/laozhang_cn).

| Параметр | Значение |
| - | - |
| Хост API | `https://api.laozhang.ai` |
| Базовый URL для OpenAI SDK | `https://api.laozhang.ai/v1` |
| Google Gen AI SDK и Anthropic SDK | Корень хоста: `https://api.laozhang.ai` |
| Основные модели изображений | Nano Banana 2.1 — \$0.045 за вызов, GPT Image 2.5 VIP — \$0.03 за вызов, Grok Imagine 2.0 — \$0.055 за изображение (публичные цены на октябрь 2026 года); подробнее в разделе [API генерации изображений](https://docs.laozhang.ai/ru/api-capabilities/image-generation-guide.md) |
| Основные видеомодели | MiniMax H3 — \$0.05 за секунду в 768P (на 37.5% ниже официальной цены MiniMax), Muse — \$0.30 за видео длительностью 5–10 секунд (\$0.03 за секунду при 10 секундах); обе со звуком и доступны токену группы `default`; сравнение в разделе [API генерации видео](https://docs.laozhang.ai/ru/api-capabilities/video-generation-guide.md) |
| Параллельные запросы и лимиты | Платформа не ограничивает число параллельных запросов и не замедляет их; см. [Параллельность и ошибка 429](https://docs.laozhang.ai/ru/faq/api-concurrency.md) |

## Первый запрос к API

Сначала нужен аккаунт: условия регистрации указаны в примечании выше.

**1. Создайте API-ключ**

Войдите в консоль и создайте токен в разделе [Управление токенами](https://api.laozhang.ai/token) (в консоли API-ключ называется «токеном»). Для этого примера выберите группу `default`; группы и режимы оплаты описаны в [руководстве по тарификации](https://docs.laozhang.ai/ru/pricing.md). Затем сохраните ключ в переменной окружения:

```bash theme={null}
export LAOZHANG_API_KEY="YOUR_LAOZHANG_API_KEY"
```

**2. Выберите модель**

Скопируйте точный ID модели из раздела [Модели и цены](https://docs.laozhang.ai/ru/models.md): там же указаны цены, группы токенов и эндпоинты. В примере используется `gpt-5.4-mini` — текстовая модель с оплатой по использованию из группы `default`.

**3. Отправьте запрос**

```bash theme={null}
curl https://api.laozhang.ai/v1/chat/completions \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [{"role": "user", "content": "Ответь только одним словом: connected"}]
  }'
```

Ответ находится в поле `choices[0].message.content`. Дальше читайте [руководство по подключению API](https://docs.laozhang.ai/ru/api-manual.md): в нём разобраны настройка SDK, запросы к моделям изображений, нативные API Gemini и Anthropic и обработка ошибок.

## Разделы документации

> [card] [Nano Banana API](https://docs.laozhang.ai/ru/api-capabilities/nano-banana-image.md)
>
> Модели изображений Google Gemini: пять моделей, фиксированная цена за вызов, запросы в нативном формате Gemini или в формате OpenAI.

> [card] [GPT Image 2.5 API](https://docs.laozhang.ai/ru/api-capabilities/gpt-image-2-5.md)
>
> Модель изображений OpenAI: маршрут с официальной пересылкой или с оплатой за вызов, генерация, редактирование и прозрачный фон.

> [card] [Grok Imagine API](https://docs.laozhang.ai/ru/api-capabilities/grok-imagine-image.md)
>
> Модель изображений xAI: \$0.055 за изображение, вывод 1K или 2K, редактирование по трём референсам.

> [card] [Сравнение API изображений](https://docs.laozhang.ai/ru/api-capabilities/image-generation-guide.md)
>
> Сравните модели, эндпоинты и тарификацию, затем откройте руководство по нужной модели.

> [card] [Видео MiniMax H3](https://docs.laozhang.ai/ru/api-capabilities/minimax-h3-video-generation.md)
>
> \$0.05 за секунду в 768P, на 37.5% ниже официальной цены; разрешение 2K, референсные материалы и встроенный звук.

> [card] [Видео Muse](https://docs.laozhang.ai/ru/api-capabilities/muse-video-generation.md)
>
> Видеомодель Meta: \$0.30 за ролик в 10 секунд (\$0.03 за секунду), формат `/v1/videos` как в OpenAI, один непрерывный ролик до 60 секунд.

> [card] [Сравнение API видео](https://docs.laozhang.ai/ru/api-capabilities/video-generation-guide.md)
>
> Стоимость ролика на H3, Muse, Seedance и Wan, а также эндпоинты и группы токенов.

> [card] [Протокол OpenAI](https://docs.laozhang.ai/ru/api-reference/chat-completions.md)
>
> Запросы Chat Completions через OpenAI SDK и совместимые клиенты.

> [card] [Протокол Gemini](https://docs.laozhang.ai/ru/api-reference/gemini.md)
>
> Вызов `generateContent` через cURL или Google Gen AI SDK.

> [card] [Модели и цены](https://docs.laozhang.ai/ru/models.md)
>
> Поиск по ID моделей, ценам, группам токенов и эндпоинтам.

> [card] [Анонсы](https://docs.laozhang.ai/en/changelog.md)
>
> Новые модели, изменения цен и статус сервиса.

> [card] [Интеграции](https://docs.laozhang.ai/en/scenarios.md)
>
> Работа с LaoZhang API в Codex CLI, Gemini CLI, Cline, Cherry Studio и других инструментах.

## Документация для ИИ-инструментов

Ассистенты для программирования могут читать эту документацию напрямую:

* [skill.md](https://docs.laozhang.ai/skill.md) — файл навыка для агента. Он задаёт ассистенту правила подключения к LaoZhang API: базовый URL для каждого SDK, чтение API-ключа из окружения, минимальные текстовые и графические запросы, диагностику ошибок и ссылку на нужный справочник.
* [llms-full.txt](https://docs.laozhang.ai/llms-full.txt) — вся документация одним текстовым файлом для инструментов, которые загружают её в контекст. Сейчас в нём китайская версия документации.

Если ассистент запускает код за вас, передавайте API-ключ через переменную окружения и не вставляйте его в промпт.

## О LaoZhang API

LaoZhang API ([www.laozhang.ai](https://www.laozhang.ai)) принадлежит сингапурской компании YingTu Technology Pte. Ltd. Сервис даёт технический доступ к сторонним моделям и маршрутизацию запросов к ним. Он не является официальным оператором этих моделей, не связан с OpenAI, Google и xAI и не предлагает широкой публике собственный сервис генерации контента.

| Параметр | Значение |
| - | - |
| Оператор | YingTu Technology Pte. Ltd., Сингапур, работает с 2025 года |
| Оплата | Предоплаченный баланс; банковские карты через Stripe, банковский перевод для компаний |
| Статус сервиса | [Страница статуса](https://api.laozhang.ai/uptimeStatus); изменения публикуются в разделе [Анонсы](https://docs.laozhang.ai/en/changelog.md) |
| Обработка данных | [Политика данных](https://www.laozhang.ai/data-policy): промпты и ответы по умолчанию не хранятся |
| Условия, оплата, возвраты | [Условия использования](https://www.laozhang.ai/terms) |

Страница [О LaoZhang API](https://docs.laozhang.ai/en/about.md) собирает в одном месте сведения об операторе, источниках моделей, доступных маршрутах, оплате и возвратах. Проверять ответы моделей и отвечать за их использование должны вы.

Поддержка: [hi@laozhang.ai](mailto:hi@laozhang.ai) и Telegram [@laozhang\_cn](https://t.me/laozhang_cn). Новости сервиса публикуются в канале [@laozhang\_ai](https://t.me/laozhang_ai), а развёрнутые материалы — в [блоге LaoZhang AI](https://blog.laozhang.ai).

## Частые вопросы

### Нужен ли отдельный аккаунт у каждого провайдера моделей?

Нет. Один аккаунт LaoZhang API и один API-ключ открывают все модели, которые доступны группе вашего ключа. Группы каждой модели перечислены в разделе [Модели и цены](https://docs.laozhang.ai/ru/models.md), а в консоли видны модели и цены, действующие для вашего аккаунта.

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

Запросы оплачиваются с предоплаченного баланса. В зависимости от модели списание идёт по использованию (токенам) или за каждый вызов, а в некоторых группах токенов действует ценовой множитель. Режимы оплаты, пополнение и счета описаны в разделе [Тарификация, группы токенов и счета](https://docs.laozhang.ai/ru/pricing.md), а стоимость каждого запроса видна в [журнале вызовов](https://api.laozhang.ai/log).

### Какой домен API использовать?

По умолчанию используйте `https://api.laozhang.ai`. Все три хоста принимают один и тот же API-ключ и одинаковые пути, поэтому при переключении меняется только имя хоста; подробности в [руководстве по подключению API](https://docs.laozhang.ai/ru/api-manual.md).

* По умолчанию: `https://api.laozhang.ai`; базовый URL для OpenAI SDK — `https://api.laozhang.ai/v1`.
* Серверы в Европе или Северной Америке, которым нужно прямое соединение: `api-vip.laozhang.ai`.
* Если `api.laozhang.ai` не открывается из вашей сети: `api2.laozhang.ai`.

### Как узнать баланс из кода?

Отправьте запрос `GET https://api.laozhang.ai/api/user/self` с системным AccessToken — это отдельные учётные данные, не API-ключ. Как получить AccessToken и перевести квоту в доллары США, показано в разделе [API запроса баланса](https://docs.laozhang.ai/ru/api-capabilities/balance-query.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.