# 1ZheAI · Полная документация
# Документация 1Zhe AI V2
Source: https://1zheai.com/ru/docs/
Markdown: https://1zheai.com/ru/docs/index.md
---
title: "Документация 1Zhe AI V2"
description: "API моделей, готовые аккаунты, подписки, заказы и правила поддержки на русском языке."
---
V2 объединяет API моделей, продажу готовых аккаунтов и активацию подписок. Это разные услуги: подписка платформы не включает баланс API, а ключ API не позволяет войти в ChatGPT, Claude или Grok.
## Выберите задачу
- [Подключить API](/ru/docs/quickstart/): регистрация, ключ и первый запрос.
- [Купить аккаунт](/ru/docs/account-guide/): тариф, регион и получение данных.
- [Активировать подписку](/ru/docs/subscription-guide/): требования к своему аккаунту и порядок обработки.
- [Использовать подарочную карту](/ru/docs/gift-card-guide/): регион, срок и обмен кода.
- [Проверить заказ и правила поддержки](/ru/docs/store-rules/).
Доступность товаров и способов оплаты проверяйте в магазине и кошельке. Наличие страницы инструкции не означает, что все варианты уже продаются.
## Для разработчиков
[Инструменты](/ru/docs/integrations/) · [Примеры кода](/ru/docs/code-examples/) · [API](/ru/docs/api-reference/) · [Цены](/ru/docs/pricing-explained/) · [Устранение ошибок](/ru/docs/troubleshooting/).
Скидка Claude действует на входные и выходные токены; чтение и запись кеша оплачиваются по стандартным тарифам. Актуальные цены и единицы оплаты указаны в [каталоге](https://1zheai.com/ru/pricing/).
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```text
Anthropic Base URL https://1zheai.com
OpenAI Base URL https://1zheai.com/v1
API Key sk-... (создайте в консоли)
```
---
# Первый запрос API
Source: https://1zheai.com/ru/docs/quickstart/
Markdown: https://1zheai.com/ru/docs/quickstart.md
---
title: "Первый запрос API"
description: "Создайте ключ 1Zhe AI, настройте адрес и проверьте первый вызов Claude или GPT."
---
## Подготовка
Зарегистрируйтесь в [кабинете](https://1zheai.com/register?lng=ru), откройте [кошелёк](https://1zheai.com/wallet?lng=ru) и проверьте доступные способы пополнения. Баланс ведётся в USD; способы и ограничения суммы определяются формой оплаты. Условия возврата остатка и невозвратной комиссии описаны в [оплате](/ru/docs/billing/).
Создайте ключ в разделе «Ключи API», задайте понятное имя и сохраните значение в переменной окружения. Не помещайте полный ключ в чат, снимок экрана или репозиторий.
## Подключение
Для Anthropic SDK и Claude Code используйте корневой адрес `https://1zheai.com`. Для OpenAI SDK — `https://1zheai.com/v1`. В прямом HTTP-запросе нужен полный путь конечной точки; не добавляйте `/v1` дважды. Идентификатор модели копируйте из [каталога](https://1zheai.com/model-catalog?lng=ru).
В примерах ниже замените ключ и при необходимости модель. Выберите команды для своей системы. После ответа проверьте запись в [журнале использования](https://1zheai.com/usage-logs/common?lng=ru): модель, токены, стоимость и состояние. Затем переходите к [инструкции своего инструмента](/ru/docs/integrations/).
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
export ONEZHE_API_KEY="sk-YOUR_API_KEY"
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"messages": [{"role": "user", "content": "Объясните HTTP одним предложением"}]
}'
```
```powershell
$env:ONEZHE_API_KEY = "sk-YOUR_API_KEY"
$body = @{
model = "claude-sonnet-5-5"
max_tokens = 128
messages = @(@{ role = "user"; content = "Объясните HTTP одним предложением" })
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Uri "https://1zheai.com/v1/messages" -Method Post `
-Headers @{ "x-api-key" = $env:ONEZHE_API_KEY; "anthropic-version" = "2023-06-01" } `
-ContentType "application/json; charset=utf-8" `
-Body ([System.Text.Encoding]::UTF8.GetBytes($body))
```
```json
{
"model": "claude-sonnet-5-5",
"id": "msg_011Cg3G8HQmyTrnqSBX6o6Pw",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "HTTP — протокол прикладного уровня для обмена запросами и ответами между клиентом и сервером, включая страницы, изображения и данные API."
}
],
"container": null,
"stop_reason": "end_turn",
"stop_sequence": null,
"stop_details": null,
"usage": {
"input_tokens": 530,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"cache_creation": {
"ephemeral_5m_input_tokens": 0,
"ephemeral_1h_input_tokens": 0
},
"output_tokens": 69,
"output_tokens_details": {"thinking_tokens": 0},
"service_tier": "standard",
"inference_geo": "global"
},
"input_transformations": [],
"diagnostics": null,
"context_management": {"applied_edits": []}
}
```
```bash
curl --fail-with-body https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Объясните HTTP одним предложением."}]}'
```
---
# Создание и защита ключей API
Source: https://1zheai.com/ru/docs/api-keys/
Markdown: https://1zheai.com/ru/docs/api-keys.md
---
title: "Создание и защита ключей API"
description: "Где создать ключ, как ограничить доступ и что делать при утечке."
---
Создайте ключ в разделе [ключей API](https://1zheai.com/keys?lng=ru) кабинета. Укажите понятное имя и доступные ограничения модели и расхода. Для каждого приложения лучше использовать отдельный ключ, чтобы его можно было отозвать независимо.
## Хранение и использование
Копируйте полный ключ в секретное поле приложения или переменную окружения. Не встраивайте ключ в браузерный JavaScript, мобильный клиент, общедоступный workflow или репозиторий. Для сайта вызывайте API со своего сервера; пользовательский браузер должен обращаться к вашему серверу.
Кнопки импорта и копирования настроек могут содержать полный ключ, даже если предварительный просмотр маскирует его. Проверяйте целевой клиент и не пересылайте такие ссылки.
## Если доступ не работает
При 401 проверьте наличие ключа в новом процессе, отсутствие лишних пробелов и правильный заголовок. При 403 или недоступной модели проверьте права, ограничения и баланс. Успешный вход в кабинет не доказывает, что ключ разрешает любую модель.
При утечке отзовите ключ в кабинете, создайте новый и обновите все использующие его приложения. Удаление из последнего коммита не удаляет секрет из истории. Поддержке передавайте только обезличенные ошибки, время и идентификатор запроса.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
# Добавьте в ~/.zshrc или ~/.bashrc; действует только на этом компьютере
export ONEZHE_API_KEY="sk-YOUR_API_KEY"
```
```powershell
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-YOUR_API_KEY", "User")
# Действует после открытия нового терминала
```
```bash
# Добавьте .env в .gitignore
ONEZHE_API_KEY=sk-YOUR_API_KEY
```
---
# Доступные модели
Source: https://1zheai.com/ru/docs/models/
Markdown: https://1zheai.com/ru/docs/models.md
---
title: "Доступные модели"
description: "Где получить точный идентификатор модели, её API, тариф и единицу оплаты."
---
Актуальные модели, поддерживаемые API и цены находятся в [каталоге кабинета](https://1zheai.com/model-catalog?lng=ru) и на [странице цен](https://1zheai.com/ru/pricing/). Используйте точный идентификатор, включая префикс и версию; отображаемое имя не всегда подходит в поле `model`.
## Выбор
Claude, GPT, MiMo и модели изображений имеют разные форматы и единицы оплаты. Для Claude скидка относится к вводу и выводу; чтение и запись кеша оплачиваются без скидки. Для других семейств смотрите их строки, а не переносите правило одного семейства на другое.
Список, доступный ключу, можно получить через [модельный API](/ru/docs/api-models/). Наличие модели в списке не означает гарантированный успех генерации: учитывайте права ключа, баланс, формат запроса и текущее состояние поставщика.
Перед длительной задачей проверьте короткий текстовый вызов, потоковый режим и нужные дополнительные функции отдельно. Поддержка текста не доказывает поддержку изображений, инструментов, принудительного выбора инструмента или любого размера контекста.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
curl https://1zheai.com/v1/models \
-H "Authorization: Bearer sk-YOUR_API_KEY"
```
```bash
curl -s https://1zheai.com/api/pricing | jq -r '.data[].model_name'
```
## Внешние источники
- [Источник 1](https://platform.claude.com/docs/en/about-claude/models/overview)
---
# Переход с другого API
Source: https://1zheai.com/ru/docs/migration/
Markdown: https://1zheai.com/ru/docs/migration.md
---
title: "Переход с другого API"
description: "Меняйте адрес, ключ и модель поэтапно и проверяйте нужные возможности."
---
Сохраните прежнюю конфигурацию без раскрытия секретов. Сначала создайте ограниченный ключ 1Zhe AI и выберите точный model ID в каталоге.
## План перехода
1. Определите формат текущего клиента: Anthropic Messages, OpenAI Chat Completions или Responses.
2. Укажите наш [базовый URL](/ru/docs/base-url/) и ключ; не копируйте идентификатор чужого поставщика без проверки.
3. Проверьте короткий обычный ответ и запись в журнале.
4. Отдельно проверьте поток, инструменты, кеш и изображения, если они нужны приложению.
5. Постепенно переключайте нагрузку, сохраняя возможность возврата.
Алиасы модели, скрытые расширения, сохранённое состояние и лимиты другого API не переносятся автоматически. SDK может повторять запросы самостоятельно; проверьте тайм-ауты и предел числа попыток.
Перед возвратом к прежнему API удалите или измените новые переменные и откройте новый процесс. [Инструменты](/ru/docs/integrations/) · [Проверка модели и использования](/ru/docs/verify-model/).
---
# Частые вопросы об API
Source: https://1zheai.com/ru/docs/faq/
Markdown: https://1zheai.com/ru/docs/faq.md
---
title: "Частые вопросы об API"
description: "Ответы об адресах, ключах, моделях, памяти, потоках и статусе сервиса."
---
## Какой базовый URL использовать?
Для OpenAI SDK — `https://1zheai.com/v1`, для Anthropic SDK и Claude Code — `https://1zheai.com`. Некоторые приложения сами дописывают путь. [Подробности](/ru/docs/base-url/).
## Заменяет ли подписка ChatGPT или Claude ключ сайта?
Нет. Подписка платформы и наш API — разные услуги. Создайте ключ в нашем кабинете и выберите инструмент с поддержкой собственного провайдера.
## Почему модель есть в списке, но вызов не работает?
Список показывает доступные ключу идентификаторы, а не успешность живой генерации. Проверьте API, параметры, права, баланс и поставщика.
## Почему нет текста или памяти диалога?
Читайте поля своего протокола: `choices`, `content` либо `output`. При инструментах обычного текста может не быть. Историю многошагового диалога обычно передаёт само приложение; одинаковый ключ не создаёт серверную память.
## Текст уже идёт — запрос успешен?
Нужно дождаться финального события или состояния. Возможны обрыв, ошибка и остановка по лимиту. Не выполняйте скрытый бесконечный повтор.
## Можно положить ключ в сайт?
Не в браузерный код. Пусть ваш сервер хранит ключ и вызывает API.
## Мониторинг зелёный, но модель не отвечает?
HTTP-мониторинг сайта, кабинета и входа API не является тестом генерации каждой модели. Он работает на той же машине; при сбое всей машины мониторинг тоже может остановиться.
Заказам магазина посвящены [отдельные правила](/ru/docs/store-rules/).
---
# Покупка в магазине
Source: https://1zheai.com/ru/docs/store-guide/
Markdown: https://1zheai.com/ru/docs/store-guide.md
---
title: "Покупка в магазине"
description: "Чем отличаются аккаунты, активация подписок и подарочные карты и как оформить заказ."
---
## Какой товар выбрать
| Задача | Услуга |
| --- | --- |
| Вызывать модели из приложения | [API](/ru/docs/quickstart/) |
| Получить готовый аккаунт платформы | [Аккаунт](/ru/docs/account-guide/) |
| Добавить подписку к своему аккаунту | [Активация подписки](/ru/docs/subscription-guide/) |
| Получить код или ссылку для обмена | [Подарочная карта](/ru/docs/gift-card-guide/) |
Перед покупкой проверьте платформу, тариф, регион, срок, наличие, способ получения и условия товара. Если не указаны смена почты, продление или совместное использование, не считайте их включёнными; сначала спросите поддержку.
## Порядок покупки
1. Выберите товар и вариант в [магазине](https://1zheai.com/ru/store/).
2. Войдите в кабинет и проверьте цену, количество и условия. Для подписки заполните требуемые поля.
3. Ознакомьтесь с рисками, самостоятельно подтвердите согласие и оформите заказ с оплатой из кошелька.
4. Откройте [мои заказы](https://1zheai.com/store-orders?lng=ru), чтобы проверить состояние и получить результат.
Пополнение кошелька не является покупкой товара. Автоматическая передача, ручная обработка и активация после заказа имеют разный порядок; единого обещания мгновенного выполнения нет.
## Риск блокировки
После надлежащей передачи аккаунта или успешной активации блокировка сторонней платформой не является основанием для возврата. Мы можем помочь с обжалованием, но не гарантируем разблокировку. Непоставка, неуспешная активация и наша ответственность по закону рассматриваются по [правилам поддержки](/ru/docs/store-rules/).
[Проблемы с заказом](/ru/docs/store-orders/) · [Партнёрские вознаграждения](/ru/docs/affiliate-guide/).
---
# Покупка и использование аккаунта
Source: https://1zheai.com/ru/docs/account-guide/
Markdown: https://1zheai.com/ru/docs/account-guide.md
---
title: "Покупка и использование аккаунта"
description: "Проверьте тариф, регион, данные для входа и риски до покупки аккаунта ChatGPT, Claude или Grok."
---
## Перед покупкой
Уточните наличие подписки, её тариф и срок. Название платформы само по себе не означает наличие Pro или Max. Проверьте регион, способ входа, состав передаваемых данных, доступ к почте и возможность смены адреса. Однократная передача не включает автоматически пересылку писем, напоминания и автоматическое продление.
Условия команды, совместного использования и передачи другим лицам определяются товаром и правилами платформы.
## После получения
1. Откройте [заказ](https://1zheai.com/store-orders?lng=ru) и сверьте товар, тариф и переданные данные.
2. Войдите по инструкции товара и проверьте доступ, подписку и дату окончания.
3. Меняйте пароль, восстановление и настройки безопасности только поддерживаемым для этого товара способом. Если изменить данные нельзя, сначала уточните условия у поддержки.
4. Если данные не работают или тариф не соответствует заказу, сохраните номер заказа и обезличенный снимок ошибки.
Не публикуйте пароль, код подтверждения или восстановления. При продлении сначала уточните совместимость: активация для собственного аккаунта не обязательно подходит купленному аккаунту.
## Ограничения и поддержка
Соблюдайте правила платформы. Возможны ограничения региона, использования, проверка личности и блокировка. Покупка не гарантирует отсутствие проверки или успешное обжалование. Проверку личности проходит сам пользователь по официальной процедуре; не отправляйте документы и коды в обычный чат поддержки.
После надлежащей передачи аккаунта блокировка сторонней платформой не является основанием для возврата. Мы можем помочь с обжалованием без гарантии разблокировки. Непоставка, неверная передача и случаи нашей ответственности по закону рассматриваются отдельно.
[Правила покупки](/ru/docs/store-rules/) · [Проблемы с заказом](/ru/docs/store-orders/).
---
# Активация подписки на своём аккаунте
Source: https://1zheai.com/ru/docs/subscription-guide/
Markdown: https://1zheai.com/ru/docs/subscription-guide.md
---
title: "Активация подписки на своём аккаунте"
description: "Условия аккаунта, нужные данные, безопасность и проверка результата активации."
---
Активация подписки предназначена для вашего существующего аккаунта; новый аккаунт не передаётся. Платформы и тарифы, доступные для покупки, указаны в [магазине](https://1zheai.com/ru/store/).
## Проверьте требования
Регион, тип аккаунта, активная подписка, задолженность и история возвратов проверяются по конкретному товару. Нельзя считать, что все варианты требуют Free, допускают наложение подписок или обновление тарифа. При сомнении уточните условия до оплаты; не проверяйте совместимость повторными покупками.
## Оформление и получение
1. Выберите вариант и прочитайте цену, срок, требования и способ активации.
2. В форме заказа укажите только запрошенные данные: например, идентификатор аккаунта или Organization ID.
3. Проверьте целевой аккаунт, условия и риски, затем подтвердите заказ.
4. Следите за [исходным заказом](https://1zheai.com/store-orders?lng=ru). Исправляйте данные только при наличии соответствующего действия.
5. После завершения проверьте тариф и срок на самой платформе. Обновите страницу или войдите заново; если результат всё ещё не соответствует заказу, обратитесь в поддержку.
## Безопасность данных
Некоторые варианты требуют Session JSON. Эти сведения могут давать доступ к аккаунту и по чувствительности близки к паролю. Отправляйте их только в специальной форме соответствующего заказа на нашем сайте, понимая объём доступа. Не отправляйте их в чат, почту, публичные снимки или сторонние сервисы проверки. Если условия передачи неприемлемы, не покупайте такой вариант. После обработки проверьте устройства и сеансы средствами платформы.
## Обработка и возвраты
После начала обработки прямая отмена недоступна. Ошибка или тайм-аут не означают ни возврат денег, ни отсутствие активации. Сохраните исходный заказ и дождитесь проверки. Не оплачивайте повторно для исправления ошибки. Результат и направление возврата подтверждаются заказом и операциями кошелька, а не предположением об автоматическом возврате на карту.
После успешной активации блокировка платформой не является основанием для возврата. Помощь с обжалованием не гарантирует разблокировку. Неуспешная активация, непоставка и наша ответственность по закону рассматриваются по [правилам поддержки](/ru/docs/store-rules/).
---
# Активация подарочных карт
Source: https://1zheai.com/ru/docs/gift-card-guide/
Markdown: https://1zheai.com/ru/docs/gift-card-guide.md
---
title: "Активация подарочных карт"
description: "Проверьте регион, номинал, срок действия и требования к аккаунту до использования кода."
---
Подарочная карта передаётся кодом или ссылкой. Активация подписки может выполняться прямо в заказе; не каждый такой заказ требует перейти на сторонний сайт с кодом.
## Перед покупкой
Проверьте платформу, регион, валюту или номинал, тариф, срок действия и ограничения аккаунта. Совместимость с действующей или мобильной подпиской, возможность суммирования и передачи другому человеку определяются товаром. Сроки и условия других продавцов не являются нашими обещаниями. Если доступных карт в магазине нет, продажи сейчас не открыты.
## Использование
1. Получите данные в [заказе](https://1zheai.com/store-orders?lng=ru). Не публикуйте код и снимки с ним.
2. Проверьте, что вошли в нужный аккаунт, и используйте указанный в товаре адрес обмена. Не переводите дополнительные деньги незнакомым лицам.
3. До обмена ещё раз проверьте регион и состояние аккаунта; после обмена проверьте полученные права или баланс.
4. При ошибке «уже использован», неверном регионе или отсутствии результата сохраните обезличенную ошибку и номер заказа. Не покупайте другой код для проверки.
## Отмена и поддержка
Для заказа, обработка которого не началась, используйте предусмотренный запрос отмены. Переданный код не подлежит прямому возврату. Недействительная передача, непоставка и наша ответственность по закону подлежат проверке поддержки. Специальные правила блокировки и обмена указаны в товаре; правило возврата API-баланса на карты не распространяется.
[Общие правила](/ru/docs/store-rules/) · [Проблемы с заказом](/ru/docs/store-orders/).
---
# Состояние заказа и устранение проблем
Source: https://1zheai.com/ru/docs/store-orders/
Markdown: https://1zheai.com/ru/docs/store-orders.md
---
title: "Состояние заказа и устранение проблем"
description: "Где получить товар, исправить данные и проверить результат или возврат."
---
Откройте [мои заказы](https://1zheai.com/store-orders?lng=ru). Запись пополнения кошелька не является товарным заказом.
| Состояние | Значение и действие |
| --- | --- |
| Ожидает передачи | Заказ создан, но не передан; проверьте способ получения и наличие отмены |
| Обрабатывается | Идёт ручная обработка или активация; не покупайте повторно, исправьте данные только по указанию заказа |
| Передан | Получены данные товара или результат активации; проверьте аккаунт, тариф или код |
| Отменён | Заказ завершён отменой; проверьте причину и операции кошелька |
Подробный этап активации может показывать ожидание поставщика, исправление данных или возврат в обработке. Это не равнозначно окончательному успеху или возврату.
## Деньги списаны, результата нет
Проверьте заказ и переданное содержимое. Ручная передача и активация могут занимать время. Если превышен срок товара или состояние не меняется, свяжитесь с поддержкой без повторной оплаты.
## Ошибочные данные
Меняйте их только через предложенное действие исходного заказа. Если действия нет или заказ уже завершён, обратитесь в поддержку. Перенос активированной подписки не гарантируется.
## Заказ завершён, подписка не видна
Проверьте целевой аккаунт, обновите страницу или войдите заново. Если результат не появился, сохраните обезличенный снимок и номер заказа.
## Блокировка или проверка личности
Используйте официальную процедуру платформы. После нормальной передачи или успешной активации блокировка не является основанием возврата; помощь с обжалованием не гарантирует восстановление. Непоставка рассматривается отдельно по [правилам](/ru/docs/store-rules/).
## Где возврат
Смотрите причину отмены и операции кошелька. Возврат в баланс не равен возврату платежа. Состояние «обрабатывается» ещё не подтверждает получение денег.
---
# Правила покупки и поддержки
Source: https://1zheai.com/ru/docs/store-rules/
Markdown: https://1zheai.com/ru/docs/store-rules.md
---
title: "Правила покупки и поддержки"
description: "Отмена, возвраты, неверная передача, неуспешная активация и блокировка аккаунтов."
---
## Подтверждение заказа
Перед подтверждением прочитайте цену, вариант, количество, регион, срок, способ получения и риски. Заказ сохраняет подтверждённые условия; последующее изменение страницы не переписывает историю согласия.
Мы остаёмся вашим продавцом и точкой обращения по заказу, в том числе при участии поставщика. Не регистрируйтесь у незнакомых дистрибьюторов и не переводите им дополнительные деньги для завершения нашего заказа.
## Отмена и возвраты
| Ситуация | Что делать |
| --- | --- |
| Заказ ожидает передачи и предлагает отмену | Запросите отмену в исходном заказе; после успеха проверьте операции кошелька |
| Обработка идёт или результат активации не определён | Прямая отмена недоступна; дождитесь проверки без повторной покупки |
| Неверные данные, тариф или недействительная передача | Передайте поддержке номер заказа и обезличенное подтверждение |
| Ошибка активации или данных | Исправьте данные по указанию исходного заказа или обратитесь в поддержку; ошибка не означает завершённый возврат |
| Нормальная передача или активация завершилась, затем платформа заблокировала аккаунт | Возврат по причине блокировки не производится; возможна помощь с обжалованием |
| Подарочная карта уже передана | Прямой возврат не предусмотрен; недействительную передачу всё равно можно оспорить через поддержку |
## Блокировка платформой
После надлежащей передачи аккаунта или успешной активации подписки блокировка сторонней платформой не является основанием для возврата. Мы можем помочь с обжалованием, но не гарантируем разблокировку. Непоставка, неуспешная активация и случаи нашей ответственности по закону рассматриваются по применимым правилам.
Платформа может менять условия, ограничивать доступ или требовать проверку личности. Мы не гарантируем отсутствие блокировки или успешное обжалование. Это не исключает ответственность, предусмотренную законом.
## Отличие от API-баланса
[Правило возврата API-баланса](/ru/docs/billing/) не применяется автоматически к товарным заказам. Отмена заказа с возвратом в кошелёк и возврат платежа на исходный способ оплаты — разные операции.
Подготовьте номер заказа, товар и вариант, время и состояние, обезличенную ошибку и снимок статуса платформы. Не присылайте пароль, коды, полный сеанс входа, обменный код или изображение документа. [Как проверить заказ](/ru/docs/store-orders/).
---
# Приглашения и комиссии магазина
Source: https://1zheai.com/ru/docs/affiliate-guide/
Markdown: https://1zheai.com/ru/docs/affiliate-guide.md
---
title: "Приглашения и комиссии магазина"
description: "Какие заказы дают вознаграждение, как фиксируется приглашение и когда начисляется комиссия."
---
V2 добавляет товарные заказы к механизму приглашений. Администратор может включить комиссию для аккаунтов, подписок и карт; не каждый товар участвует автоматически.
## Как пригласить
Скопируйте регистрационную ссылку в разделе приглашений [кошелька](https://1zheai.com/wallet?lng=ru). После регистрации друга используется сохранённая связь приглашения. Клик по другой ссылке позднее не меняет её, и покупатель не задаёт пригласившего в форме заказа.
Новые подходящие заказы ранее приглашённых друзей тоже могут участвовать. Исторические заказы не получают комиссию задним числом; собственные покупки не являются самоприглашением.
## Условия и сумма
В текущем варианте администратор задаёт фиксированную комиссию за единицу конкретного товара. Ноль отключает её. До настройки реальных сумм вознаграждение не начисляется. При заказе фиксируются пригласивший, вариант, количество и сумма; последующее изменение тарифа их не переписывает.
Регистрационное вознаграждение и комиссия магазина — разные основания. Пополнение кошелька друга само по себе не создаёт товарную комиссию. Регистрационная награда зависит от действующих настроек администратора.
## Состояния комиссии
- **Ожидает расчёта**: сумма предварительная, заказ ещё не завершён или начисление отложено.
- **Начислена**: включена в доступные вознаграждения; не прибавляйте её к этому остатку второй раз.
- **Аннулирована**: вознаграждение не будет начислено, например при отмене заказа.
Комиссия начисляется только после передачи аккаунта или карты либо успешной активации. Обработка, ошибка и неопределённый результат не оплачиваются. Повторная обработка одного заказа не создаёт повторного вознаграждения. При остановке функций платежей и наград расчёт приостанавливается. Отключённый получатель или достигнутый лимит суммы оставляют запись для повтора после восстановления условий, не мешая передаче покупателю.
## Получение и приватность
Последние записи доступны в кошельке. Доступное вознаграждение переводится в баланс по существующим правилам и минимальной сумме для API-расходов. Это не вывод наличных и не автоматически подходящее для магазина пополнение: магазин отдельно проверяет происхождение средств.
Виден только ваш список комиссий, без личности покупателя, его номера заказа, пароля или кода. Для вопроса поддержке достаточно номера записи комиссии, товара и времени.
---
# Подключение инструментов
Source: https://1zheai.com/ru/docs/integrations/
Markdown: https://1zheai.com/ru/docs/integrations.md
---
title: "Подключение инструментов"
description: "Выберите инструкцию клиента и проверьте его адрес, ключ, модель и ограничения."
---
## Инструменты разработки
[Claude Code](/ru/docs/quickstart-claude-code/) · [Codex](/ru/docs/quickstart-codex/) · [Cursor](/ru/docs/quickstart-cursor/) · [Cline](/ru/docs/quickstart-cline/) · [CC Switch](/ru/docs/quickstart-cc-switch/) · [CC Provider](/ru/docs/quickstart-cc-provider/).
## Чаты и рабочие процессы
[Cherry Studio](/ru/docs/quickstart-cherry-studio/) · [Chatbox](/ru/docs/quickstart-chatbox/) · [ChatWise](/ru/docs/quickstart-chatwise/) · [LibreChat](/ru/docs/quickstart-librechat/) · [RikkaHub](/ru/docs/quickstart-rikkahub/) · [Dify](/ru/docs/quickstart-dify/).
## Агенты
[OpenCode](/ru/docs/quickstart-opencode/) · [OpenClaw](/ru/docs/quickstart-openclaw/) · [WorkBuddy](/ru/docs/quickstart-workbuddy/) · [Hermes Agent](/ru/docs/quickstart-hermes/).
Для OpenCode, OpenClaw, WorkBuddy и Hermes настройки сверены с официальными материалами, но полный сквозной тест нашего API не завершён. Проверьте версию, короткий диалог и инструменты до длительного использования. Настройка собственного провайдера не означает официального партнёрства или встроенной рекомендации.
Для программирования с нуля откройте [SDK и примеры](/ru/docs/guides/). Совместимость проверяйте по клиенту и модели, а не только по знакомому названию API.
---
# Claude Code
Source: https://1zheai.com/ru/docs/quickstart-claude-code/
Markdown: https://1zheai.com/ru/docs/quickstart-claude-code.md
---
title: "Claude Code"
description: "Настройка Claude Code с ключом и адресом API 1ZheAI."
---
В [консоли ключей](https://1zheai.com/keys?lng=ru) откройте подключение инструментов и выберите Claude Code. Можно использовать `settings.json` или переменные окружения. Корневой адрес `ANTHROPIC_BASE_URL` — `https://1zheai.com`, без `/v1`.
Если файл настроек уже существует, объедините блок `env` с текущими настройками. Не заменяйте файл целиком. Проверьте конфликт между `ANTHROPIC_AUTH_TOKEN` и `ANTHROPIC_API_KEY`: оставьте способ авторизации, используемый выбранной конфигурацией. Переменные оболочки начинают действовать в новом терминале; настройки в файле могут иметь приоритет.
Запустите `claude`, выполните `/status` и проверьте адрес. Отправьте короткое сообщение и найдите запрос в журнале 1ZheAI. Этот способ расходует баланс API, а не подписку Claude Pro или Max. Скопированные настройки содержат полный ключ — не отправляйте их в чат поддержки.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```json
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-YOUR_API_KEY"
}
}
```
```bash
curl -fsSL https://claude.ai/install.sh | bash
```
```powershell
irm https://claude.ai/install.ps1 | iex
```
```bash
brew install --cask claude-code
```
```bash
npm install -g @anthropic-ai/claude-code
```
```json
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-YOUR_API_KEY"
}
}
```
```bash
# Добавьте в ~/.zshrc или ~/.bashrc и откройте новый терминал
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_API_KEY"
```
```powershell
# Сохраняется для текущего пользователя; откройте новый терминал
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://1zheai.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-YOUR_API_KEY", "User")
# Действует только в текущем окне
$env:ANTHROPIC_BASE_URL = "https://1zheai.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_API_KEY"
```
```bat
setx ANTHROPIC_BASE_URL "https://1zheai.com"
setx ANTHROPIC_AUTH_TOKEN "sk-YOUR_API_KEY"
```
```bash
claude -p "say ok" --model claude-sonnet-4-6
```
```json
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-YOUR_API_KEY",
"ANTHROPIC_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
}
}
```
```json
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-YOUR_API_KEY" }
]
}
```
## Внешние источники
- [Источник 1](https://code.claude.com/docs/en/setup)
- [Источник 2](https://code.claude.com/docs/en/authentication)
---
# Codex
Source: https://1zheai.com/ru/docs/quickstart-codex/
Markdown: https://1zheai.com/ru/docs/quickstart-codex.md
---
title: "Codex"
description: "Пользовательская конфигурация Codex с Responses API 1ZheAI."
---
Codex читает пользовательские настройки из `~/.codex/config.toml`. Добавьте провайдер 1ZheAI с адресом `https://1zheai.com/v1`, переменной окружения для ключа и `wire_api = "responses"`. Используйте доступную модель, которая поддерживает Responses.
Если в файле уже есть `model_provider` и `model`, замените соответствующие значения, сохранив остальные настройки. Не записывайте ключ непосредственно в репозиторий. Откройте новый терминал, выполните `codex exec "say ok"` и проверьте запрос в журнале. Доступность модели и функций зависит от выбранного маршрута; подписка ChatGPT отдельно не оплачивает этот API.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```toml
model_provider = "onezhe"
model = "gpt-6-astra"
[model_providers.onezhe]
name = "1折AI"
base_url = "https://1zheai.com/v1"
env_key = "ONEZHE_API_KEY"
wire_api = "responses"
```
```bash
export ONEZHE_API_KEY="sk-YOUR_API_KEY"
```
```powershell
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-YOUR_API_KEY", "User")
```
```bash
npm install -g @openai/codex
```
```bash
brew install --cask codex
```
```bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
```powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```
## Внешние источники
- [Источник 1](https://developers.openai.com/codex/config-reference)
---
# OpenCode
Source: https://1zheai.com/ru/docs/quickstart-opencode/
Markdown: https://1zheai.com/ru/docs/quickstart-opencode.md
---
title: "OpenCode"
description: "Провайдер OpenAI Compatible для OpenCode и особенности версий конфигурации."
---
Для этого варианта подключения OpenCode обращается к `/v1/chat/completions`. Укажите `https://1zheai.com/v1`, доступную модель и переменную окружения для ключа. Настройки можно сохранить в проектном `opencode.json` или пользовательском `~/.config/opencode/opencode.json`.
Объедините блок провайдера с существующим файлом. Запись `{env:…}` читает секрет из окружения, поэтому ключ не нужно хранить в JSON. Схема провайдеров различается по версиям. Для альтернативного Anthropic-провайдера v1 требует проверки Base URL с `/v1`, а v2 использует `@opencode/ai/providers/anthropic-compatible`; не переносите настройки между версиями без проверки.
Официальные форматы сверялись 15 октября 2026 года; полный сквозной тест всех режимов не завершён. Выполните короткий диалог и вызов инструмента, прежде чем запускать длительную работу.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"onezhe": {
"npm": "@ai-sdk/openai-compatible",
"name": "1折AI",
"options": { "baseURL": "https://1zheai.com/v1" },
"models": {
"claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
}
}
}
}
```
```json
{
"$schema": "https://opencode.ai/config.json",
"providers": {
"onezhe": {
"name": "1折AI",
"env": ["ONEZHE_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": { "baseURL": "https://1zheai.com/v1" },
"models": {
"claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
}
}
}
}
```
## Внешние источники
- [Источник 1](https://opencode.ai/docs/providers/)
- [Источник 2](https://opencode.ai/v2/docs/providers)
---
# Cursor
Source: https://1zheai.com/ru/docs/quickstart-cursor/
Markdown: https://1zheai.com/ru/docs/quickstart-cursor.md
---
title: "Cursor"
description: "Подключение пользовательского ключа API к чату Cursor и ограничения этого режима."
---
В Cursor откройте настройки моделей, укажите OpenAI API Key, включите Override OpenAI Base URL и задайте `https://1zheai.com/v1`. Добавьте точный идентификатор модели и включите её. Расположение настройки зависит от версии: Override OpenAI Base URL не закреплён в официальной документации Cursor.
Пользовательский ключ применяется к чат-моделям. Tab Completion продолжает использовать собственные модели Cursor. Запросы сначала проходят через серверы Cursor, поэтому адрес API должен быть доступен из интернета. Если модель с префиксом `claude-` не работает, проверьте конфликт с сохранённым Anthropic API Key.
Отправьте сообщение в Chat и проверьте журнал 1ZheAI. Настройка ключа не подтверждает работу всех функций Cursor с любой моделью.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```text
OpenAI API Key sk-YOUR_API_KEY (ключ 1ZheAI)
Override OpenAI Base URL https://1zheai.com/v1
```
## Внешние источники
- [Источник 1](https://forum.cursor.com/t/anthropic-models-break-when-override-openai-baseurl-is-set/144899)
- [Источник 2](https://forum.cursor.com/t/override-anthropic-base-url-automatically-switches-on-when-using-anthropic-byok/146998)
---
# Cline и Roo Code
Source: https://1zheai.com/ru/docs/quickstart-cline/
Markdown: https://1zheai.com/ru/docs/quickstart-cline.md
---
title: "Cline и Roo Code"
description: "Адреса Anthropic и OpenAI Compatible для Cline и Roo Code."
---
Откройте настройки провайдера в Cline или Roo Code. Для Claude рекомендуется Anthropic: укажите `https://1zheai.com` без `/v1`, ключ и доступную модель. Поддержка кэширования и extended thinking зависит от модели и маршрута.
Для OpenAI Compatible укажите `https://1zheai.com/v1`. Не смешивайте эти адреса: это приводит к неверному пути запроса. Если модель отсутствует в списке Anthropic, можно попробовать OpenAI Compatible с явным идентификатором, предварительно проверив поддержку нужных функций.
Сначала проверьте короткий диалог и вызов инструмента. Убедитесь, что расход появился в журнале, прежде чем запускать длительную задачу.
## Внешние источники
- [Источник 1](https://platform.claude.com/docs/en/about-claude/models/overview)
---
# Cherry Studio
Source: https://1zheai.com/ru/docs/quickstart-cherry-studio/
Markdown: https://1zheai.com/ru/docs/quickstart-cherry-studio.md
---
title: "Cherry Studio"
description: "Подключение Cherry Studio по Anthropic или OpenAI Compatible."
---
В консоли ключей откройте подключение Cherry Studio. Импорт добавляет провайдера Anthropic с адресом и ключом. После подтверждения откройте провайдера, нажмите Get model list, добавьте нужные модели и включите провайдера. Повторное нажатие импорта создаёт дубликат.
При ручной настройке Anthropic укажите только `https://1zheai.com`. Cherry Studio сам добавит `/v1/...`: полный путь или завершающий `#` могут вызвать `404`. Для OpenAI Compatible используется `https://1zheai.com/v1`. Если нужной модели нет в списке Anthropic, проверьте её доступность через OpenAI Compatible.
Отправьте короткое сообщение и проверьте расход. Импорт настроек сам по себе не подтверждает работу всех возможностей модели.
---
# Dify
Source: https://1zheai.com/ru/docs/quickstart-dify/
Markdown: https://1zheai.com/ru/docs/quickstart-dify.md
---
title: "Dify"
description: "Подключение Dify через официальный плагин OpenAI-API-compatible и тестовый Chatflow."
---
Установите официальный плагин **OpenAI-API-compatible** от **langgenius**. Укажите адрес `https://1zheai.com/v1`, собственный API-ключ и точный идентификатор модели. Выберите режим Chat Completion. Не выбирайте протокол только по названию модели.
Можно импортировать [пример Chatflow](/ru/docs/downloads/1zheai-dify-chatflow.yml): User Input → LLM → Answer. Шаблон подготовлен для DSL 0.7.0 и плагина 0.0.68. Если пример модели `claude-haiku-4-5-20251001` недоступен вашему ключу, замените его на доступную модель. После импорта привяжите свои учётные данные и выполните один короткий запрос.
Проверен ограниченный внутренний сценарий. Новые рабочие пространства, старые версии Dify, tool calling, изображения и RAG отдельно не подтверждены. Плагин и сервер Dify обрабатывают ваш ключ; используйте доверенную установку. Наличие шаблона не означает официального партнёрства.
## Внешние источники
- [Источник 1](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible)
- [Источник 2](https://marketplace.dify.ai/)
---
# WorkBuddy
Source: https://1zheai.com/ru/docs/quickstart-workbuddy/
Markdown: https://1zheai.com/ru/docs/quickstart-workbuddy.md
---
title: "WorkBuddy"
description: "Добавление пользовательской модели в models.json WorkBuddy."
---
В консоли ключей выберите WorkBuddy и скопируйте конфигурацию. Файл `~/.workbuddy/models.json` содержит JSON-массив. Если модели уже настроены, добавьте новый объект внутрь существующих `[]`, сохранив остальные записи.
WorkBuddy перечитывает файл автоматически. Проверьте точный идентификатор модели, протокол и адрес. Скопированная конфигурация содержит ключ: не отправляйте файл в общий чат и не сохраняйте его в репозитории.
Официальный формат проверялся 15 октября 2026 года; полный сквозной тест через 1ZheAI не завершён. Сначала отправьте короткое сообщение и проверьте журнал, затем отдельно проверьте необходимые инструменты.
## Внешние источники
- [Источник 1](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model)
---
# Chatbox
Source: https://1zheai.com/ru/docs/quickstart-chatbox/
Markdown: https://1zheai.com/ru/docs/quickstart-chatbox.md
---
title: "Chatbox"
description: "Настройка Chatbox с пользовательским провайдером API 1ZheAI."
---
В настройках Chatbox добавьте пользовательский провайдер. Выберите протокол, задайте ключ и точный идентификатор доступной модели. Для Anthropic используйте `https://1zheai.com`, для OpenAI Compatible — `https://1zheai.com/v1`. Названия полей зависят от версии клиента.
Сохраните настройки, выберите модель в новом диалоге и отправьте короткое сообщение. Проверьте запрос в журнале 1ZheAI. Ошибка адреса обычно связана со смешением корневого Anthropic URL и OpenAI URL с `/v1`.
Формат подключения проверен 19 октября 2026 года; работа всех версий, платформ и моделей не подтверждена. Не публикуйте экспорт настроек с ключом.
## Внешние источники
- [Источник 1](https://docs.chatboxai.app/guides/providers/import-config)
- [Источник 2](https://github.com/chatboxai/chatbox/blob/main/src/renderer/utils/provider-config.ts)
---
# RikkaHub
Source: https://1zheai.com/ru/docs/quickstart-rikkahub/
Markdown: https://1zheai.com/ru/docs/quickstart-rikkahub.md
---
title: "RikkaHub"
description: "Подключение RikkaHub и безопасное использование QR-конфигурации."
---
Создайте провайдера в RikkaHub и выберите Anthropic или OpenAI Compatible. Используйте соответственно `https://1zheai.com` или `https://1zheai.com/v1`, ключ и точное имя модели. Проверьте доступность модели в консоли.
QR-код конфигурации может содержать полный ключ. Не публикуйте скриншоты и не отправляйте код посторонним. Если секрет раскрыт, отзовите ключ и создайте новый.
После настройки проверьте короткий диалог и журнал расхода. Формат подключения проверен 19 октября 2026 года; все версии Android, функции и модели отдельно не тестировались.
## Внешние источники
- [Источник 1](https://github.com/rikkahub/docs/blob/main/quickstart.mdx)
- [Источник 2](https://github.com/rikkahub/rikkahub/blob/master/app/src/main/java/me/rerere/rikkahub/ui/components/ui/ShareSheet.kt)
---
# ChatWise
Source: https://1zheai.com/ru/docs/quickstart-chatwise/
Markdown: https://1zheai.com/ru/docs/quickstart-chatwise.md
---
title: "ChatWise"
description: "Пользовательский провайдер в ChatWise и проверка первого запроса."
---
Добавьте пользовательский провайдер в настройках ChatWise. Перенесите ключ, модель и адрес из консоли 1ZheAI. Сопоставьте выбранный протокол с адресом: Anthropic — корневой `https://1zheai.com`, OpenAI Compatible — `https://1zheai.com/v1`.
Подтверждённого однокнопочного импорта нет: проверьте поля вручную. Выберите провайдера и модель в диалоге, отправьте сообщение и откройте журнал запросов. Не делитесь конфигурацией с полным ключом.
Формат подключения проверен 19 октября 2026 года. Это не гарантия работы всех функций ChatWise, систем и моделей; отдельно проверьте нужные вам инструменты и вложения.
## Внешние источники
- [Источник 1](https://docs.chatwise.app/custom-provider)
- [Источник 2](https://docs.chatwise.app/open-from-other-apps)
---
# LibreChat
Source: https://1zheai.com/ru/docs/quickstart-librechat/
Markdown: https://1zheai.com/ru/docs/quickstart-librechat.md
---
title: "LibreChat"
description: "Серверная настройка пользовательского API-провайдера в LibreChat."
---
Настройте пользовательский endpoint на сервере LibreChat, используя конфигурацию установленной версии. Для OpenAI Compatible укажите `https://1zheai.com/v1` и доступные идентификаторы моделей. Храните API-ключ в серверной переменной окружения, а не в клиентском коде.
Если конфигурация уже существует, объедините раздел провайдера с ней. После изменения примените обычный для вашей установки перезапуск. Выберите endpoint и модель, отправьте тестовое сообщение и проверьте журнал 1ZheAI.
Формат проверен 19 октября 2026 года. Работа всех версий LibreChat, плагинов, инструментов и моделей не подтверждена. Администратор стороннего сервера получает доступ к переданному ключу; учитывайте это при выборе хостинга.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```yaml
endpoints:
custom:
- name: '1折AI'
apiKey: user_provided
baseURL: 'https://1zheai.com/v1'
models:
default: []
fetch: true
```
## Внешние источники
- [Источник 1](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint)
---
# OpenClaw
Source: https://1zheai.com/ru/docs/quickstart-openclaw/
Markdown: https://1zheai.com/ru/docs/quickstart-openclaw.md
---
title: "OpenClaw"
description: "Настройка провайдера OpenClaw с проверкой протокола и вызовов инструментов."
---
Добавьте пользовательского провайдера в конфигурацию OpenClaw по схеме установленной версии. Возьмите адрес, ключ и модель из консоли. Для OpenAI Compatible используется `https://1zheai.com/v1`; для Anthropic сверьте требуемый формат Base URL с документацией клиента.
Объедините настройки с существующим файлом, сохранив остальных провайдеров. Не публикуйте ключ и не передавайте агенту права, которые не нужны задаче. Начните с короткого диалога, затем проверьте один вызов инструмента и журнал расхода.
Официальный формат конфигурации проверялся 15 октября 2026 года. Полная проверка работы OpenClaw через 1ZheAI не завершена. Не запускайте длительные автономные задачи до собственной проверки нужных функций.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```json
{
"agents": {
"defaults": {
"model": { "primary": "onezhe/claude-sonnet-4-6" },
"models": { "onezhe/claude-sonnet-4-6": { "alias": "1折AI Claude" } }
}
},
"models": {
"mode": "merge",
"providers": {
"onezhe": {
"baseUrl": "https://1zheai.com",
"apiKey": "${ONEZHE_API_KEY}",
"api": "anthropic-messages",
"models": [
{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
]
}
}
}
}
```
## Внешние источники
- [Источник 1](https://docs.openclaw.ai/gateway/config-tools/custom-providers)
- [Источник 2](https://docs.openclaw.ai/gateway/configuration-examples)
- [Источник 3](https://docs.openclaw.ai/providers/synthetic)
---
# Hermes Agent
Source: https://1zheai.com/ru/docs/quickstart-hermes/
Markdown: https://1zheai.com/ru/docs/quickstart-hermes.md
---
title: "Hermes Agent"
description: "Проверка пользовательского API-провайдера в Hermes Agent."
---
Настройте пользовательский провайдер Hermes Agent по документации установленной версии. Выберите протокол и точное имя модели, а затем соответствующий адрес 1ZheAI. Ключ передавайте через поддерживаемый клиентом безопасный способ хранения.
Сохраните существующие настройки. Сначала проверьте короткий ответ без инструментов, затем один контролируемый вызов инструмента. Сопоставьте результат с журналом запросов и расходом. Доступность модели в каталоге не гарантирует поддержку всех возможностей агента.
Официальные настройки сверялись 15 октября 2026 года. Полный сквозной тест через 1ZheAI не завершён. Примеры ниже служат для настройки, а не подтверждают совместимость всех версий и сценариев.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```yaml
providers:
onezhe:
api: https://1zheai.com/v1
key_env: ONEZHE_API_KEY
transport: chat_completions
default_model: claude-sonnet-4-6
model:
provider: custom:onezhe
default: claude-sonnet-4-6
```
```dotenv
ONEZHE_API_KEY=sk-YOUR_API_KEY
```
## Внешние источники
- [Источник 1](https://hermes-agent.nousresearch.com/docs/integrations/providers)
---
# CC Switch
Source: https://1zheai.com/ru/docs/quickstart-cc-switch/
Markdown: https://1zheai.com/ru/docs/quickstart-cc-switch.md
---
title: "CC Switch"
description: "Импорт провайдера 1ZheAI в менеджер настроек CC Switch."
---
CC Switch управляет провайдерами для Claude Code, Codex и OpenCode. В [консоли ключей](https://1zheai.com/keys?lng=ru) выберите инструмент и импорт в CC Switch. Ссылка содержит полный ключ: не пересылайте её.
Проверьте адрес, протокол и модель в CC Switch, нажмите Import, затем Enable у провайдера. Перезапустите целевой инструмент или откройте новый терминал. Не считайте открытие окна импорта подтверждением успешного API-запроса: отправьте сообщение и проверьте журнал.
Для ручной настройки используйте отдельную инструкцию выбранного инструмента. CC Switch не меняет доступность моделей и не предоставляет подписку на них.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```json
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-YOUR_API_KEY"
}
}
```
## Внешние источники
- [Источник 1](https://github.com/farion1231/cc-switch)
- [Источник 2](https://github.com/farion1231/cc-switch/releases)
---
# CC Provider
Source: https://1zheai.com/ru/docs/quickstart-cc-provider/
Markdown: https://1zheai.com/ru/docs/quickstart-cc-provider.md
---
title: "CC Provider"
description: "Ручной перенос полей провайдера в CC Provider и проверка подключения."
---
CC Provider помогает управлять настройками инструментов. Выберите целевой инструмент, затем перенесите адрес, ключ и точный идентификатор модели из консоли 1ZheAI. Для Anthropic используйте корневой адрес без `/v1`, для OpenAI Compatible — с `/v1`.
Однокнопочный импорт в CC Provider не подтверждён. Используйте копирование полей и проверяйте результат в самом инструменте. Скопированный ключ даёт доступ к балансу: не размещайте конфигурацию в публичном репозитории.
Форматы проверялись 19 октября 2026 года. Это не означает проверку всех версий клиента, операционных систем и моделей. После настройки отправьте короткое сообщение и найдите его в журнале.
## Внешние источники
- [Источник 1](https://github.com/onetooken/cc-provider)
---
# Руководство разработчика
Source: https://1zheai.com/ru/docs/guides/
Markdown: https://1zheai.com/ru/docs/guides.md
---
title: "Руководство разработчика"
description: "SDK, HTTP-примеры, потоки, кеш и обработка ошибок."
---
Если стек уже выбран, начните с соответствующего SDK. В противном случае сначала проверьте [curl](/ru/docs/quickstart-curl/), затем подключайте приложение.
- [Anthropic Python / TypeScript](/ru/docs/quickstart-anthropic-sdk/).
- [OpenAI Python / Node.js](/ru/docs/quickstart-openai-sdk/).
- [Готовые примеры](/ru/docs/code-examples/).
- [Потоки](/ru/docs/streaming/).
- [Кеширование](/ru/docs/prompt-caching/).
- [Тайм-ауты и повторы](/ru/docs/retries/).
Используйте переменные окружения и серверное хранение ключа. Проверяйте обычный ответ и журнал до сложной интеграции. Поддержка одного протокола не означает поддержку всех параметров исходного API.
---
# Anthropic SDK
Source: https://1zheai.com/ru/docs/quickstart-anthropic-sdk/
Markdown: https://1zheai.com/ru/docs/quickstart-anthropic-sdk.md
---
title: "Anthropic SDK"
description: "Подключение Anthropic SDK к API 1ZheAI: адрес, ключ, модель и проверка расхода."
---
Установите официальный Anthropic SDK. Передайте ключ 1ZheAI и корневой адрес `https://1zheai.com` в клиент. SDK сам добавляет путь `/v1/messages`: не добавляйте его в Base URL.
Выберите доступный вашему ключу идентификатор Claude в [каталоге моделей](https://1zheai.com/model-catalog?lng=ru). Отправьте короткий запрос и проверьте `usage` и [журнал запросов](/ru/docs/usage-logs/). Подписка Claude Pro или Max не оплачивает эти вызовы API. Пример ниже показывает формат запроса; доступность конкретной модели проверяйте в каталоге.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
pip install anthropic
```
```bash
npm install @anthropic-ai/sdk
```
```python
import os
import anthropic
client = anthropic.Anthropic(
base_url="https://1zheai.com",
api_key=os.environ["ONEZHE_API_KEY"],
)
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Представьтесь одним предложением"}],
)
print(message.model)
print(message.content[0].text)
print(message.usage)
```
```typescript
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
baseURL: "https://1zheai.com",
apiKey: process.env.ONEZHE_API_KEY,
});
const message = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Представьтесь одним предложением" }],
});
console.log(message.model);
console.log(message.content);
console.log(message.usage);
```
```python
with client.messages.stream(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Напишите стихотворение из четырёх строк"}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
```
```typescript
const stream = client.messages.stream({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Напишите стихотворение из четырёх строк" }],
});
stream.on("text", (text) => process.stdout.write(text));
await stream.finalMessage();
```
```python
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
system=[
{
"type": "text",
"text": LONG_PROJECT_CONTEXT, # одинаковый длинный текст для каждого запроса
"cache_control": {"type": "ephemeral"},
}
],
messages=[{"role": "user", "content": "Ответьте с учётом приведённого выше описания: ..."}],
)
print(message.usage.cache_creation_input_tokens, message.usage.cache_read_input_tokens)
```
```bash
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_API_KEY="sk-YOUR_API_KEY"
```
```python
client = anthropic.Anthropic() # автоматически читает две переменные выше
```
---
# OpenAI SDK
Source: https://1zheai.com/ru/docs/quickstart-openai-sdk/
Markdown: https://1zheai.com/ru/docs/quickstart-openai-sdk.md
---
title: "OpenAI SDK"
description: "Настройка OpenAI SDK для Chat Completions и Responses через 1ZheAI."
---
Установите официальный OpenAI SDK. Укажите `https://1zheai.com/v1` как `base_url`, ключ 1ZheAI как `api_key` и точный идентификатор модели из каталога. Ключ храните в переменной окружения на сервере.
Для Chat Completions используйте соответствующий метод SDK. Responses требует отдельной поддержки моделью и маршрутом; наличие модели в списке само по себе её не подтверждает. Начните с одного короткого запроса, затем проверьте расход и ошибку в журнале. Покупка аккаунта ChatGPT и баланс API — разные услуги.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
pip install openai
```
```bash
npm install openai
```
```python
import os
from openai import OpenAI
client = OpenAI(
base_url="https://1zheai.com/v1",
api_key=os.environ["ONEZHE_API_KEY"],
)
resp = client.chat.completions.create(
model="gpt-5.6-sol",
messages=[{"role": "user", "content": "Объясните кэширование промптов одним предложением"}],
)
print(resp.model)
print(resp.choices[0].message.content)
print(resp.usage)
```
```javascript
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://1zheai.com/v1",
apiKey: process.env.ONEZHE_API_KEY,
});
const resp = await client.chat.completions.create({
model: "gpt-5.6-sol",
messages: [{ role: "user", content: "Объясните кэширование промптов одним предложением" }],
});
console.log(resp.model);
console.log(resp.choices[0].message.content);
console.log(resp.usage);
```
```python
stream = client.chat.completions.create(
model="gpt-5.6-sol",
messages=[{"role": "user", "content": "Напишите стихотворение из четырёх строк"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
```
```javascript
const stream = await client.chat.completions.create({
model: "gpt-5.6-sol",
messages: [{ role: "user", content: "Напишите стихотворение из четырёх строк" }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
```
```bash
export OPENAI_BASE_URL="https://1zheai.com/v1"
export OPENAI_API_KEY="sk-YOUR_API_KEY"
```
---
# Запрос через curl
Source: https://1zheai.com/ru/docs/quickstart-curl/
Markdown: https://1zheai.com/ru/docs/quickstart-curl.md
---
title: "Запрос через curl"
description: "Минимальные запросы curl для проверки авторизации, моделей и протокола API."
---
Создайте ключ в [консоли](https://1zheai.com/keys?lng=ru), сохраните его в переменной окружения и получите список моделей. Затем выберите один из примеров: Anthropic Messages, OpenAI Chat Completions или Responses. Адрес и формат тела должны соответствовать выбранному протоколу.
Не публикуйте вывод с заголовком авторизации. Ответ `401` обычно требует проверки ключа; `404` — адреса и идентификатора модели; `429` — лимитов и доступности. Подробности смотрите в [руководстве по ошибкам](/ru/docs/troubleshooting/). Не повторяйте бесконечно запрос, который уже начал отдавать поток.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
export ONEZHE_API_KEY="sk-YOUR_API_KEY"
```
```bash
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"messages": [{"role": "user", "content": "ping"}]
}'
```
```bash
curl https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"messages": [{"role": "user", "content": "ping"}]
}'
```
```bash
curl https://1zheai.com/v1/models \
-H "Authorization: Bearer $ONEZHE_API_KEY"
```
```bash
curl -N https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"stream": true,
"messages": [{"role": "user", "content": "Сосчитайте от одного до пяти"}]
}'
```
```bash
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 32,
"system": [{
"type": "text",
"text": "Разместите здесь одинаковый текст длиной не менее 512 токенов",
"cache_control": {"type": "ephemeral"}
}],
"messages": [{"role": "user", "content": "ping"}]
}'
```
```bash
curl -i https://1zheai.com/v1/models -H "Authorization: Bearer $ONEZHE_API_KEY"
```
---
# Готовые примеры запросов
Source: https://1zheai.com/ru/docs/code-examples/
Markdown: https://1zheai.com/ru/docs/code-examples.md
---
title: "Готовые примеры запросов"
description: "Минимальные примеры Anthropic, OpenAI, Node.js и Python с ключом из окружения."
---
Сначала создайте ключ и выберите точную модель. Установите SDK в своё окружение, задайте `ONEZHE_API_KEY` и выполните один пример ниже. Команды для разных языков и систем — альтернативы, а не обязательная последовательность.
Для Anthropic SDK базовый адрес — `https://1zheai.com`; для OpenAI SDK — `https://1zheai.com/v1`. Прямому curl нужен полный путь.
После ответа проверьте правильное поле текста и итоговое состояние, затем найдите запись в журнале. Пример с потоком не освобождает от проверки завершения. При ошибке начинайте с минимального запроса, не добавляя сразу инструменты и экспериментальные поля.
Используйте [справочник API](/ru/docs/api-reference/) для структуры ответа и [диагностику](/ru/docs/troubleshooting/) для ошибок. В примерах приведены технические идентификаторы и поля протокола; их нельзя переводить или подменять отображаемым названием.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
export ONEZHE_API_KEY="sk-YOUR_API_KEY"
export ONEZHE_MODEL="gpt-5.6-sol"
```
```powershell
$env:ONEZHE_API_KEY = "sk-YOUR_API_KEY"
$env:ONEZHE_MODEL = "gpt-5.6-sol"
```
```python
import os
import sys
import openai
api_key = os.environ.get("ONEZHE_API_KEY")
if not api_key:
sys.exit("Сначала задайте переменную ONEZHE_API_KEY.")
client = openai.OpenAI(
api_key=api_key,
base_url="https://1zheai.com/v1",
timeout=120.0,
max_retries=0,
)
try:
response = client.chat.completions.create(
model=os.environ.get("ONEZHE_MODEL", "gpt-5.6-sol"),
messages=[{"role": "user", "content": "Объясните DNS одним предложением на русском."}],
)
if not response.choices:
sys.exit("В ответе нет choices. Проверьте протокол.")
choice = response.choices[0]
print(choice.message.content or "В этом ответе нет обычного текста.")
print("finish_reason:", choice.finish_reason)
print("response_id:", response.id)
except openai.APIStatusError as exc:
print("HTTP:", exc.status_code, "request_id:", exc.request_id, file=sys.stderr)
print("См. журнал консоли и справочник ошибок. Не публикуйте ключ.", file=sys.stderr)
sys.exit(1)
except openai.APIConnectionError:
sys.exit("Ошибка подключения или тайм-аут. Проверьте сеть, прокси и журнал запросов.")
```
```javascript
import OpenAI from "openai";
if (!process.env.ONEZHE_API_KEY) {
console.error("Сначала задайте переменную ONEZHE_API_KEY.");
process.exit(1);
}
const client = new OpenAI({
apiKey: process.env.ONEZHE_API_KEY,
baseURL: "https://1zheai.com/v1",
timeout: 120_000,
maxRetries: 0,
});
try {
const response = await client.chat.completions.create({
model: process.env.ONEZHE_MODEL || "gpt-5.6-sol",
messages: [{ role: "user", content: "Объясните DNS одним предложением на русском." }],
});
const choice = response.choices[0];
if (!choice) throw new Error("В ответе нет choices. Проверьте протокол.");
console.log(choice.message.content || "В этом ответе нет обычного текста.");
console.log("finish_reason:", choice.finish_reason);
console.log("response_id:", response.id);
} catch (error) {
if (error instanceof OpenAI.APIError) {
console.error("HTTP:", error.status, "request_id:", error.request_id);
console.error("Проверьте сеть, журнал консоли и справочник ошибок.");
} else {
console.error(error instanceof Error ? error.message : "Неизвестная ошибка");
}
process.exitCode = 1;
}
```
---
# Потоковые ответы
Source: https://1zheai.com/ru/docs/streaming/
Markdown: https://1zheai.com/ru/docs/streaming.md
---
title: "Потоковые ответы"
description: "Как читать SSE и отличать полученный текст от полностью завершённого ответа."
---
При `stream: true` сервер отправляет события, а не один готовый JSON. Используйте SSE-парсер или потоковый интерфейс SDK: сетевой фрагмент не обязательно совпадает с событием или UTF-8-символом.
## Протоколы различаются
| Формат | Что читать |
| --- | --- |
| Chat Completions | `choices[].delta`, причины завершения и завершающий маркер протокола |
| Anthropic Messages | события сообщения, текстовых блоков и окончательное завершение сообщения |
| Responses | типизированные дельты и итоговый статус, включая неуспех и незавершённость |
Учитывайте инструментальные блоки отдельно от обычного текста. Если выдача остановилась по лимиту, результат может быть неполным даже при корректном HTTP-коде.
## Ошибки и отмена
Ошибка может прийти после начала текста. Если соединение оборвалось до нужного финального события, сохраните признак незавершённости. Не объявляйте запрос успешным только по первым символам или HTTP 200.
После обрыва проверьте журнал: обработка могла уже произойти. Не запускайте бесконечный повтор, не объединяйте повторную генерацию с прежним текстом без явного действия пользователя. При отмене клиентом нельзя предполагать нулевую стоимость. [Тайм-ауты и повторы](/ru/docs/retries/).
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
curl -N https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":128,"stream":true,
"messages":[{"role":"user","content":"Сосчитайте от одного до пяти"}]}'
```
```text
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[{"index":0,"delta":{"content":"ok"},"finish_reason":null}]}
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[{"index":0,"delta":{"content":""},"finish_reason":"stop"}]}
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[],"usage":{"prompt_tokens":370,"completion_tokens":4,"total_tokens":374}}
data: [DONE]
```
## Внешние источники
- [Источник 1](https://platform.claude.com/docs/en/build-with-claude/streaming)
---
# Prompt Caching и его оплата
Source: https://1zheai.com/ru/docs/prompt-caching/
Markdown: https://1zheai.com/ru/docs/prompt-caching.md
---
title: "Prompt Caching и его оплата"
description: "Как задать кеширование и проверить чтение, запись и стоимость без двойного учёта."
---
Кеширование зависит от выбранной модели и протокола. Повторяющийся совместимый префикс может быть записан в кеш, затем считан в следующих запросах. Наличие одинакового текста само по себе не гарантирует попадания: важны порядок, поддержка модели, минимальный объём и срок кеша.
## Как использовать
В нативном Messages задавайте поддерживаемый `cache_control` на нужной границе содержимого. Сначала проверьте минимальный пример ниже. Для OpenAI-совместимых клиентов не предполагайте, что произвольное поле Anthropic будет передано без изменений.
Сохраняйте стабильный префикс, а переменную часть размещайте после него. Изменение раннего содержимого может мешать повторному использованию. Увеличение промпта ради кеша не гарантирует экономию.
## Как проверить
В ответе и журнале отдельно смотрите создание и чтение кеша. Первый запрос может создавать кеш, последующий — читать, но результат нужно подтвердить полями использования, а не субъективной скоростью.
В 1Zhe AI чтение и запись кеша оплачиваются по стандартной цене без скидки модели. Ввод и вывод получают свою скидку. Не распространяйте её на всю сумму: высокая доля кеша меняет фактический коэффициент стоимости.
При расхождении сравните модель, протокол, категории токенов и временной интервал. [Расчёт](/ru/docs/pricing-explained/) · [Журнал](/ru/docs/usage-logs/).
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 256,
"system": [
{
"type": "text",
"text": "Разместите здесь одинаковый длинный контекст: описание проекта, правила кода, справочные материалы.",
"cache_control": {"type": "ephemeral"}
}
],
"messages": [{"role": "user", "content": "Проверьте этот код по приведённым выше правилам: ..."}]
}'
```
```json
{
"input_tokens": 23,
"cache_creation_input_tokens": 17920,
"cache_read_input_tokens": 0,
"cache_creation": {"ephemeral_5m_input_tokens": 17920, "ephemeral_1h_input_tokens": 0},
"output_tokens": 4
}
```
```json
{
"input_tokens": 23,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 17920,
"cache_creation": {"ephemeral_5m_input_tokens": 0, "ephemeral_1h_input_tokens": 0},
"output_tokens": 4
}
```
```json
"cache_control": {"type": "ephemeral", "ttl": "1h"}
```
```json
{"prompt_tokens": 3167, "completion_tokens": 4, "total_tokens": 3171}
```
## Внешние источники
- [Источник 1](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
- [Источник 2](https://code.claude.com/docs/zh-CN/prompt-caching)
---
# Тайм-ауты, ограничения и повтор запросов
Source: https://1zheai.com/ru/docs/retries/
Markdown: https://1zheai.com/ru/docs/retries.md
---
title: "Тайм-ауты, ограничения и повтор запросов"
description: "Ограниченные повторы, неопределённый результат и защита от повторных расходов."
---
Задайте тайм-аут соединения и общий предел ожидания согласно задаче. Одновременный автоматический повтор в SDK и приложении может умножить число запросов.
## Перед повтором
- 400: исправьте запрос или несовместимый параметр.
- 401: исправьте ключ и авторизацию; повтор неизменённого запроса не поможет.
- 404: проверьте модель и конечный путь, особенно дублирование `/v1`.
- 429: проверьте причину и подсказку сервера, выдержите паузу.
- 5xx или временная сетевая ошибка: возможен ограниченный повтор с увеличением задержки.
- Тайм-аут после отправки или обрыв потока: результат неопределён; сначала сверьте журнал, нельзя считать, что поставщик ничего не обработал.
Ограничьте число попыток и суммарное время; добавьте случайное небольшое отклонение задержки при массовых запросах. Повтор генерации может дать другой результат и повлечь дополнительные расходы.
Если часть текста уже показана, не перезапускайте генерацию незаметно с присоединением к старому тексту. Сохраните статус и дайте пользователю выбрать повтор или продолжение. [Потоки](/ru/docs/streaming/) · [Диагностика](/ru/docs/troubleshooting/).
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONEZHE_API_KEY"],
base_url="https://1zheai.com/v1",
timeout=120.0,
max_retries=2,
)
```
```javascript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.ONEZHE_API_KEY,
baseURL: "https://1zheai.com/v1",
timeout: 120_000,
maxRetries: 2,
});
```
## Внешние источники
- [Источник 1](https://github.com/openai/openai-python#retries)
- [Источник 2](https://github.com/openai/openai-node#retries)
---
# Справочник API
Source: https://1zheai.com/ru/docs/api-reference/
Markdown: https://1zheai.com/ru/docs/api-reference.md
---
title: "Справочник API"
description: "Конечные точки, протоколы, минимальные запросы и границы совместимости."
---
## Выберите протокол
- [Список моделей](/ru/docs/api-models/): доступные ключу идентификаторы.
- [Anthropic Messages](/ru/docs/api-messages/): нативные сообщения Claude.
- [Chat Completions](/ru/docs/api-chat-completions/): совместимые чаты OpenAI.
- [Responses](/ru/docs/api-responses/): формат Responses для поддерживаемых моделей.
- [Изображения](/ru/docs/api-images/): генерация и редактирование в поддерживаемом формате.
Сначала проверьте [адрес и авторизацию](/ru/docs/base-url/). Ключи принадлежат нашему API; подписка ChatGPT или Claude не заменяет их.
Каждая статья содержит минимальный запрос и примеры чтения ответа. Дополнительные параметры проверяются для выбранной модели. Не следует считать, что вся поверхность API исходного поставщика совместима, а сохранение состояния или экспериментальная функция работает без отдельной проверки. Полной скачиваемой спецификации OpenAPI сайт пока не предоставляет.
Для прикладного кода используйте [SDK и примеры](/ru/docs/guides/), для ошибок — [диагностику](/ru/docs/troubleshooting/).
---
# Базовый URL, конечные точки и авторизация
Source: https://1zheai.com/ru/docs/base-url/
Markdown: https://1zheai.com/ru/docs/base-url.md
---
title: "Базовый URL, конечные точки и авторизация"
description: "Выберите правильный адрес для Anthropic, OpenAI SDK и прямых HTTP-запросов."
---
## Адрес зависит от клиента
| Клиент | Базовый URL |
| --- | --- |
| Anthropic SDK, Claude Code | `https://1zheai.com` |
| OpenAI SDK и совместимые провайдеры | `https://1zheai.com/v1` |
| Прямой HTTP-запрос | Полный путь, например `https://1zheai.com/v1/messages` |
Клиент может сам дописывать путь. Настройки одного приложения не следует переносить в другое без проверки. Двойной `/v1/v1` или неверная конечная точка приводят к 404.
## Авторизация
Anthropic Messages использует `x-api-key` и соответствующий `anthropic-version`. OpenAI-совместимые запросы используют `Authorization: Bearer ...`. Значение — ключ нашего кабинета, а не пароль аккаунта платформы или её подписка.
Пути `/v1/messages`, `/v1/chat/completions`, `/v1/responses` и `/v1/images/generations` имеют разные форматы. Список поддерживаемых методов зависит от модели; сверяйте [каталог](/ru/docs/models/) и [API-справочник](/ru/docs/api-reference/).
После изменения адреса откройте новый терминал, если инструмент читает окружение при запуске. При ошибке сохраните конечный URL без секретов, код HTTP и идентификатор запроса; смотрите [устранение ошибок](/ru/docs/troubleshooting/).
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```text
https://1zheai.com
```
```json
{"input_tokens":19}
```
```text
x-api-key: sk-YOUR_API_KEY
anthropic-version: 2023-06-01
content-type: application/json
```
```text
Authorization: Bearer sk-YOUR_API_KEY
content-type: application/json
```
```bash
curl https://1zheai.com/v1/models \
-H "Authorization: Bearer sk-YOUR_API_KEY"
```
```json
{"error":{"code":"","message":"Invalid token (request id: 202610150244361675490398268d9d6eKJPmcph)","type":"authentication_error"}}
```
---
# Список моделей через API
Source: https://1zheai.com/ru/docs/api-models/
Markdown: https://1zheai.com/ru/docs/api-models.md
---
title: "Список моделей через API"
description: "Как получить доступные вашему ключу модели и использовать точный model ID."
---
Выполните `GET /v1/models` с вашим ключом в заголовке `Authorization: Bearer ...`. В ответе используйте идентификаторы из `data[].id`; не преобразуйте их в отображаемые названия и не добавляйте собственные суффиксы.
## Что означает результат
Список зависит от ключа и его ограничений. Он не является проверкой живого выполнения каждой модели. Цена и поддерживаемые протоколы уточняются в [каталоге](https://1zheai.com/model-catalog?lng=ru); не рассчитывайте цену только по имени.
Если модель есть, но запрос не проходит, проверьте конечную точку, права, баланс, обязательные поля и состояние поставщика. При 401 сначала исправьте авторизацию. Пустой или ограниченный список не следует автоматически считать ошибкой всей платформы.
Примеры запроса приведены ниже. После выбора выполните короткий вызов в [Messages](/ru/docs/api-messages/) или [Chat Completions](/ru/docs/api-chat-completions/) и проверьте журнал.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
curl --fail-with-body --connect-timeout 10 --max-time 30 \
https://1zheai.com/v1/models \
-H "Authorization: Bearer $ONEZHE_API_KEY"
```
```json
{
"object": "list",
"data": [{"id": "gpt-5.6-sol", "object": "model"}]
}
```
```bash
curl --fail-with-body https://1zheai.com/v1/models \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01"
```
---
# OpenAI Chat Completions
Source: https://1zheai.com/ru/docs/api-chat-completions/
Markdown: https://1zheai.com/ru/docs/api-chat-completions.md
---
title: "OpenAI Chat Completions"
description: "Совместимый чат-API, чтение ответа и потоковых дельт."
---
Для поддерживаемой модели используйте `POST /v1/chat/completions` с `Authorization: Bearer ...`. В OpenAI SDK задайте `https://1zheai.com/v1` как `base_url` или `baseURL`.
## Минимальный вызов
Укажите точный `model` и `messages`. Начните без `temperature`, сложного формата результата и инструментов: некоторые модели рассуждений ограничивают такие параметры. Добавляйте их по одному после успешной проверки.
Обычный текст читается из `choices[].message.content`. При вызове инструмента сообщение может не содержать обычного текста. Проверьте `finish_reason`, включая остановку по длине, и `usage`.
Для потока читайте `choices[].delta`, обрабатывайте фрагменты, а не ожидайте целое сообщение в каждом событии. Учитывайте ошибки после начала ответа и протокольное завершение. Не смешивайте структуру Chat Completions с Messages или Responses.
В многошаговом диалоге приложение само передаёт нужную историю. Использование одного ключа не создаёт постоянную память сервера. [Потоки](/ru/docs/streaming/) · [Responses](/ru/docs/api-responses/).
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "Объясните назначение DNS одним предложением на русском."}]
}'
```
```json
{
"id": "example-completion",
"object": "chat.completion",
"model": "gpt-5.6-sol",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "DNS преобразует доменное имя в сетевой адрес."},
"finish_reason": "stop"
}]
}
```
```json
{
"model": "gpt-5.6-sol",
"messages": [
{"role": "user", "content": "Я изучаю DNS."},
{"role": "assistant", "content": "Можно начать с разрешения доменного имени."},
{"role": "user", "content": "Чем это отличается от HTTP?"}
]
}
```
---
# Anthropic Messages
Source: https://1zheai.com/ru/docs/api-messages/
Markdown: https://1zheai.com/ru/docs/api-messages.md
---
title: "Anthropic Messages"
description: "Минимальный запрос Claude, чтение текстовых блоков и завершение потока."
---
Используйте `POST /v1/messages` с заголовками `x-api-key`, `anthropic-version` и `content-type: application/json`. В Anthropic SDK базовый URL — корень сайта; SDK добавляет путь самостоятельно.
## Запрос и ответ
Укажите точный `model`, обязательный `max_tokens` и массив `messages`. Системный промпт в этом протоколе задаётся отдельно через `system`. Начните с короткого текста без экспериментальных параметров.
В ответе перебирайте `content` и выбирайте блоки типа `text`: нельзя предполагать единственную строку или только текст. Инструментальные блоки обрабатываются отдельно. Проверьте `stop_reason`, `usage` и то, не прерван ли ответ лимитом.
В потоковом режиме различайте начало сообщения, блоки, изменения текста и финальные события. Получение первых символов ещё не означает полного успеха. Если поток оборвался, сохраняйте признак незавершённого результата.
Кеш чтения и записи имеет отдельные поля и тарифы. [Оплата](/ru/docs/pricing-explained/) · [Потоки](/ru/docs/streaming/) · [Повтор запросов](/ru/docs/retries/).
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 256,
"system": "Ответьте кратко на русском.",
"messages": [{"role": "user", "content": "Что такое разрешение доменного имени?"}]
}'
```
```python
for block in message.content:
if block.type == "text":
print(block.text)
```
## Внешние источники
- [Источник 1](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
---
# OpenAI Responses
Source: https://1zheai.com/ru/docs/api-responses/
Markdown: https://1zheai.com/ru/docs/api-responses.md
---
title: "OpenAI Responses"
description: "Вызов Responses и проверка полного завершения результата."
---
Для модели с поддержкой этого протокола используйте `POST /v1/responses` с Bearer-ключом. SDK OpenAI получает базовый адрес `https://1zheai.com/v1`.
## Работа с результатом
В запросе задайте модель и `input`. В ответе читайте содержимое `output` или используйте `output_text` SDK. Не ищите текст в `choices`, как у Chat Completions.
В потоке обрабатывайте события соответствующих типов, текстовые дельты и итоговое состояние. Ошибки и незавершённость должны учитываться даже после полученного текста. Успех подтверждается событием завершения или итоговым успешным состоянием; при `response.failed`, `response.incomplete` либо обрыве не выдавайте частичный ответ за полный.
Возможность инструмента, хранения состояния, ссылки на предыдущий ответ или другого расширения нужно проверять отдельно для выбранной модели. Не считайте весь API исходного поставщика реализованным только потому, что работает базовый вызов.
Примеры ниже; [потоки](/ru/docs/streaming/) и [ошибки](/ru/docs/troubleshooting/).
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
https://1zheai.com/v1/responses \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-astra",
"input": "Объясните API-шлюз тремя предложениями.",
"store": false
}'
```
```python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONEZHE_API_KEY"],
base_url="https://1zheai.com/v1",
timeout=120.0,
max_retries=0,
)
response = client.responses.create(
model=os.environ.get("ONEZHE_MODEL", "gpt-6-astra"),
input="Объясните API-шлюз тремя предложениями.",
store=False,
)
print(response.output_text)
print("status:", response.status)
```
```python
with client.responses.create(
model=os.environ.get("ONEZHE_MODEL", "gpt-6-astra"),
input="Объясните API-шлюз тремя предложениями.",
store=False,
stream=True,
) as stream:
for event in stream:
if event.type == "response.output_text.delta":
print(event.delta, end="", flush=True)
elif event.type == "response.completed":
print("\nГотово")
elif event.type in {"response.failed", "response.incomplete", "error"}:
raise RuntimeError(f"Ответ не завершён：{event.type}")
```
## Внешние источники
- [Источник 1](https://github.com/openai/openai-python)
---
# Генерация изображений
Source: https://1zheai.com/ru/docs/api-images/
Markdown: https://1zheai.com/ru/docs/api-images.md
---
title: "Генерация изображений"
description: "Выбор модели, формат ответа, генерация и проверка поддержки редактирования."
---
Выберите доступную модель изображений в [каталоге](https://1zheai.com/model-catalog?lng=ru). Среди опубликованных вариантов есть `gpt-image-1.5` и `chatgpt-image-latest`; актуальный список и протокол проверяйте в кабинете.
## Генерация
Для OpenAI-совместимого варианта используется `POST /v1/images/generations` с Bearer-ключом. Укажите точный `model` и `prompt`, затем минимально необходимый набор параметров.
Результат может содержать URL или данные Base64; обрабатывайте фактические поля ответа. URL может иметь ограниченный срок действия. Не выводите большие Base64-строки в журналы.
## Редактирование и ограничения
Редактирование и загрузка исходного файла зависят от модели и конечной точки. Не предполагайте, что любой вариант генерации также поддерживает редактирование, произвольный размер, качество, количество и формат ответа. При 400 уберите необязательные параметры и добавляйте их по одному.
Тариф может зависеть от изображения, запроса, токенов и других показанных условий модели. Не переносите цену текстовой модели на изображения. Проверьте использование и списание в журнале после первого теста.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```python
import base64
import os
from pathlib import Path
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONEZHE_API_KEY"],
base_url="https://1zheai.com/v1",
timeout=300.0,
max_retries=0,
)
result = client.images.generate(
model=os.environ.get("ONEZHE_IMAGE_MODEL", "gpt-image-1.5"),
prompt="Белая керамическая чашка на светло-сером столе, мягкий естественный свет, без текста.",
)
if not result.data:
raise RuntimeError("В ответе нет изображения. Проверьте ошибку и журнал запросов.")
item = result.data[0]
if item.b64_json:
target = Path("generated-image.png")
target.write_bytes(base64.b64decode(item.b64_json, validate=True))
print(f"Изображение сохранено в {target.resolve()}")
elif item.url:
print("Получен URL изображения. Скачайте его своевременно:", item.url)
else:
raise RuntimeError("В ответе нет b64_json или url.")
```
## Внешние источники
- [Источник 1](https://developers.openai.com/api/reference/resources/images/methods/generate)
---
# Аккаунт и поддержка
Source: https://1zheai.com/ru/docs/support/
Markdown: https://1zheai.com/ru/docs/support.md
---
title: "Аккаунт и поддержка"
description: "Куда обращаться по API, платежам, товарным заказам и техническим ошибкам."
---
## Магазин
[Покупка](/ru/docs/store-guide/) · [Проверка заказа](/ru/docs/store-orders/) · [Правила поддержки](/ru/docs/store-rules/) · [Комиссии](/ru/docs/affiliate-guide/).
Сначала откройте [заказ](https://1zheai.com/store-orders?lng=ru), затем передайте его номер и обезличенную ошибку через официальный канал сайта. Не отправляйте пароль, код подтверждения, обменный код или полный Session JSON.
## API и платежи
[Цены](/ru/docs/pricing-explained/) · [Пополнение и возвраты](/ru/docs/billing/) · [Журнал использования](/ru/docs/usage-logs/) · [Ключи](/ru/docs/api-keys/).
Сначала проверьте [диагностику](/ru/docs/troubleshooting/), [адрес](/ru/docs/base-url/) и ограничения своего инструмента. Поддержке нужны время и часовой пояс, клиент и версия, model ID, HTTP-код, идентификатор и обезличенная ошибка. Не присылайте полный ключ, заголовки авторизации и всю приватную беседу.
Контакты должны совпадать с опубликованными на сайте. Основной адрес: support@1zheai.com. Не отправляйте деньги или доступ незнакомому аккаунту, представившемуся поставщиком.
---
# Цены и расчёт расходов
Source: https://1zheai.com/ru/docs/pricing-explained/
Markdown: https://1zheai.com/ru/docs/pricing-explained.md
---
title: "Цены и расчёт расходов"
description: "Скидки на ввод и вывод, кеш по стандартной цене и проверка фактических списаний."
---
Актуальные цены и единицы оплаты находятся на [странице цен](https://1zheai.com/ru/pricing/) и в [каталоге](https://1zheai.com/model-catalog?lng=ru). Баланс ведётся в USD. Числа примеров не заменяют тариф конкретной модели.
## Claude
Входные и выходные токены оплачиваются по официальной цене Anthropic, умноженной на коэффициент модели. Чтение и запись кеша оплачиваются по стандартной цене, **без этой скидки**. Поэтому общая скидка вызова с кешем не обязана совпадать со скидкой ввода и вывода.
Стоимость равна сумме отдельно рассчитанных категорий: ввод, вывод, чтение кеша и запись кеша. В каждом случае учитывайте правильную единицу, обычно миллион токенов. Если поля ввода и кеша различаются по протоколам, не складывайте их вслепую и не считайте один объём дважды.
## Системный промпт и другие семейства
Claude Code не получает дополнительного содержимого. Другие клиенты, включая SDK, curl и сторонние инструменты, получают системный промпт, оплачиваемый как вход: около 350 токенов для Sonnet 4.6 и 500 для серии 5.x.
GPT, MiMo, изображения и речь могут иметь другие единицы и способы оплаты. Проверяйте их собственную строку, а не переносите цену Claude. Комиссия пополнения относится к платежу и не включается в стоимость токенов.
## Проверка
Сверьте модель, время, объёмы категорий, тариф и итог в [журнале](/ru/docs/usage-logs/). [Кеш](/ru/docs/prompt-caching/) · [Пополнение и возвраты](/ru/docs/billing/).
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```text
Стоимость = ( Входные токены × Цена ввода
+ Токены записи кэша × Цена записи кэша
+ Токены чтения кэша × Цена чтения кэша
+ Выходные токены × Цена вывода ) ÷ 1,000,000
Цены ввода и вывода = стандартные цены × коэффициент модели
Цены чтения и записи кэша = соответствующие стандартные цены
```
```json
{
"input_tokens": 2000,
"cache_creation_input_tokens": 1500,
"cache_read_input_tokens": 30000,
"output_tokens": 800
}
```
```text
Стоимость ввода = $0.006 × 0.2 = $0.0012
Стоимость вывода = $0.012 × 0.2 = $0.0024
Стоимость кэша = $0.005625 + $0.009 = $0.014625
Итого = $0.018225
```
## Внешние источники
- [Источник 1](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
---
# Использование и сверка расходов
Source: https://1zheai.com/ru/docs/usage-logs/
Markdown: https://1zheai.com/ru/docs/usage-logs.md
---
title: "Использование и сверка расходов"
description: "Как найти запрос и проверить модель, токены, кеш и итоговое списание."
---
Откройте [журнал использования](https://1zheai.com/usage-logs/common?lng=ru) и найдите запрос по времени, ключу, модели и идентификатору, если он есть. Учитывайте часовой пояс.
## Проверка записи
Сверьте модель, состояние, вход, выход, чтение и запись кеша и итог. Один пользовательский запуск Claude Code обычно включает несколько вызовов, каждый со своим контекстом и записью. Не сравнивайте цену всей задачи с одним вызовом.
Цена модели и единица оплаты должны соответствовать записи. В Claude скидка относится к вводу и выводу; кеш без скидки. Платёжная комиссия не является токеновым расходом. Не прибавляйте категории токенов дважды, если протокол уже включает их в другую величину.
Успешный HTTP-код или начало текста не доказывают полного результата. При потоке сверяйте завершение; при тайм-ауте проверяйте, появилась ли запись, прежде чем повторить.
Для поддержки подготовьте время и часовой пояс, клиент и версию, модель, HTTP-код, идентификатор и обезличенную ошибку. Не отправляйте ключ, заголовок авторизации или приватную беседу целиком.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```text
Списание = ( Ввод × Цена ввода
+ Запись кэша × Цена записи кэша
+ Чтение кэша × Цена чтения кэша
+ Вывод × Цена вывода ) ÷ 1,000,000
```
---
# Пополнение, возвраты и документы об оплате
Source: https://1zheai.com/ru/docs/billing/
Markdown: https://1zheai.com/ru/docs/billing.md
---
title: "Пополнение, возвраты и документы об оплате"
description: "Баланс USD, доступные способы оплаты, комиссия, возврат остатка и отличие товарных заказов."
---
Баланс API ведётся в USD. Доступные способы и ограничения суммы отображаются в [кошельке](https://1zheai.com/wallet?lng=ru). Не считайте, что способ оплаты работает с любой страной выпуска карты: проверяйте доступность конкретного платежа в форме.
## Перед оплатой
Проверьте основную сумму зачисления, отдельно указанную комиссию за обработку, валюту и итоговую сумму. Комиссия не становится расходным балансом и не возвращается. Не ориентируйтесь на устаревшую минимальную сумму из чужой инструкции.
Для криптоплатежа используйте только сеть, валюту, реквизиты и срок из своей платёжной формы. Если согласуется ручной перевод, сначала свяжитесь с поддержкой и получите подтверждённую инструкцию. Не отправляйте деньги на адрес из чужого заказа или снимка.
## Возврат API-баланса
В течение 7 дней после пополнения можно запросить возврат неиспользованной основной суммы на исходный способ оплаты. Израсходованный баланс и комиссия за обработку не возвращаются. Сохраните данные платежа и обратитесь через официальный канал поддержки; не сообщайте полный API-ключ.
## Документы
Для WeChat Pay и Alipay оформление счёта предусматривает дополнительные 6% суммы платежа. Для Stripe предоставляется Stripe invoice. Для USDT счёт не предоставляется. Это условия документов соответствующих платёжных способов, а не обещание российского налогового документа.
## Товарные заказы
Пополнение кошелька не покупает товар. Отмена товарного заказа с возвратом в баланс и возврат исходного платежа — разные операции. Для аккаунтов, подписок и карт действуют [правила магазина](/ru/docs/store-rules/), а не автоматическое применение 7-дневного правила API.
---
# Проверка модели и использования
Source: https://1zheai.com/ru/docs/verify-model/
Markdown: https://1zheai.com/ru/docs/verify-model.md
---
title: "Проверка модели и использования"
description: "Что можно проверить в ответах, инструментах и журнале и чего эти проверки не доказывают."
---
Сверьте запрошенный model ID, возвращённые поля, поддерживаемые функции, использование и запись в журнале. Ответ на вопрос «какая ты модель?» не является надёжным доказательством происхождения.
## Минимальные проверки
Используйте короткий запрос, поток и необходимый инструментальный сценарий из примеров ниже. Проверьте завершение, `usage` и результат обработки инструмента. Для Sonnet 5.5 и других 5.x в указанном инструментальном примере применяется `tool_choice: auto`: принудительный выбор вроде `tool` или `any` может давать 400.
Отдельный успешный ответ не подтверждает все функции, весь диапазон контекста или постоянную доступность. Скорость, стиль текста, поля имени модели и биллинг по отдельности также не доказывают источник.
## При расхождении
Сохраните время, модель, протокол, идентификатор запроса и обезличенный ответ. Сопоставьте с [журналом](/ru/docs/usage-logs/) и [правилами оплаты](/ru/docs/pricing-explained/). Удалите ключ и приватные данные перед отправкой в поддержку.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
#!/usr/bin/env bash
# Использование:ONEZHE_API_KEY=sk-YOUR_API_KEY bash verify.sh [MODEL_ID]
set -euo pipefail
BASE="https://1zheai.com"
MODEL="${1:-claude-sonnet-5-5}"
H=(-H "x-api-key: $ONEZHE_API_KEY" -H "anthropic-version: 2023-06-01" -H "content-type: application/json")
echo "== 1. поле model"
curl -s "$BASE/v1/messages" "${H[@]}" \
-d "$(jq -n --arg m "$MODEL" '{model:$m,max_tokens:16,messages:[{role:"user",content:"ping"}]}')" \
| jq 'if .error then .error else {id, model, usage} end'
echo "== 2. кэш: повторите запрос и проверьте cache_read_input_tokens во втором ответе"
LONG=$(printf 'Это неизменный текст для проверки кэширования. Важна достаточная длина.%.0s' {1..600})
BODY=$(jq -n --arg m "$MODEL" --arg t "$LONG" '{model:$m,max_tokens:16,
system:[{type:"text",text:$t,cache_control:{type:"ephemeral"}}],
messages:[{role:"user",content:"ping"}]}')
for i in 1 2; do
curl -s "$BASE/v1/messages" "${H[@]}" -d "$BODY" | jq -c 'if .error then .error else .usage end'
done
echo "== 3. ID вызова инструмента"
curl -s "$BASE/v1/messages" "${H[@]}" \
-d "$(jq -n --arg m "$MODEL" '{model:$m,max_tokens:256,
tools:[{name:"get_weather",description:"Получить погоду в городе",
input_schema:{type:"object",properties:{city:{type:"string"}},required:["city"]}}],
tool_choice:{type:"auto"},
messages:[{role:"user",content:"Какая сегодня погода в Пекине?"}]}')" \
| jq -r 'if .error then .error.message else (.content[]? | select(.type=="tool_use") | .id) end'
echo "== 4. последовательность потоковых событий"
curl -sN "$BASE/v1/messages" "${H[@]}" \
-d "$(jq -n --arg m "$MODEL" '{model:$m,max_tokens:32,stream:true,messages:[{role:"user",content:"Сосчитайте до трёх"}]}')" \
| grep '^event:' | uniq
```
```text
== 1. поле model
{
"id": "msg_011Cg3Esh8zeEdLeXAPVALKe",
"model": "claude-sonnet-5-5",
"usage": {
"input_tokens": 518,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"output_tokens": 12,
...
}
}
== 2. кэш: повторите запрос и проверьте cache_read_input_tokens во втором ответе
{"input_tokens":23,"cache_creation_input_tokens":17920,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":17920,"ephemeral_1h_input_tokens":0},"output_tokens":4,"output_tokens_details":{"thinking_tokens":0},"service_tier":"standard","inference_geo":"global"}
{"input_tokens":23,"cache_creation_input_tokens":0,"cache_read_input_tokens":17920,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":4,"output_tokens_details":{"thinking_tokens":0},"service_tier":"standard","inference_geo":"global"}
== 3. ID вызова инструмента
toolu_01UPsdyKX8M9fJTTkDoSKHXA
== 4. последовательность потоковых событий
event: message_start
event: content_block_start
event: ping
event: content_block_delta
event: content_block_stop
event: message_delta
event: message_stop
```
```json
"thinking": {"type": "adaptive", "display": "summarized"}
```
---
# Ошибки API и диагностика
Source: https://1zheai.com/ru/docs/troubleshooting/
Markdown: https://1zheai.com/ru/docs/troubleshooting.md
---
title: "Ошибки API и диагностика"
description: "Проверка ключа, URL, модели, параметров, соединения и журнала."
---
Сначала воспроизведите проблему минимальным запросом из примеров, затем добавляйте параметры. Это отделяет неправильную конфигурацию клиента от ошибки модели.
| Ошибка | Что проверить |
| --- | --- |
| 400 | Обязательные поля, формат протокола и неподдерживаемые параметры; уберите необязательное |
| 401 | Значение ключа, пробелы, переменные нового процесса и нужный заголовок |
| 403 | Права, состояние ключа и ограничения доступа |
| 404 | Полный model ID, базовый URL, дублирование `/v1` и правильную конечную точку |
| 429 | Баланс, ограничения и причину ответа; не повторяйте бесконечно |
| 5xx / соединение | Доступность адреса, сеть, время ожидания и состояние поставщика |
Для Claude Code проверьте `/status`, переменные окружения и настройки `settings.json`. При конфликте ключей оставьте один поддерживаемый способ. Строгий поставщик может отвергать экспериментальные beta-поля; пример ниже показывает соответствующую настройку из инструкции Claude Code. Отключайте её осознанно и проверяйте нужные возможности.
При потоке ошибка может возникнуть после текста. Сначала проверьте [журнал](/ru/docs/usage-logs/), затем используйте [ограниченные повторы](/ru/docs/retries/).
Поддержке нужны время, часовой пояс, версия клиента, модель, конечный URL без секрета, HTTP-код и обезличенная ошибка. Полный ключ, сессия и приватные сообщения не нужны.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```bash
curl -i https://1zheai.com/v1/messages \
-H "x-api-key: sk-YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'
```
```json
{"error":{"message":"Invalid token (request id: 202610150244355244812608268d9d6T1pY7T84)","type":"authentication_error"},"type":"error"}
```
```json
{"error":{"type":"billing_error","message":"Insufficient user quota, remaining quota: ＄0.000000 (request id: 202610150244418753787808268d9d67YNhvwXd)"},"type":"error"}
```
```json
{"error":{"message":"This token has no access to model claude-sonnet-4-6 (request id: 202610150244377127013108268d9d6yCiFOxJA)","type":"permission_error"},"type":"error"}
```
```json
{"error":{"message":"Your IP address is not on this token's allowlist (request id: 202610150244409011371208268d9d63tJvd5GD)","type":"permission_error"},"type":"error"}
```
```json
{"error":{"type":"invalid_request_error","message":"messages: Unexpected role \"robot\". Allowed roles are \"user\", \"assistant\" or \"system\" (request id: 202610150245008404167198268d9d6sajV9TX3)"},"type":"error"}
```
```json
{"error":{"message":"Invalid URL (POST /v1/nonexistent)","type":"invalid_request_error","param":"","code":""}}
```
```bash
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
```
```text
Время и часовой пояс:
Клиент и версия:
HTTP-метод и полный путь:
ID модели:
HTTP-статус:
Request ID (если есть):
Текст ошибки без секретов:
Воспроизводится ли минимальным запросом:
Используется ли прокси / затронута ли одна модель:
```
## Внешние источники
- [Источник 1](https://platform.claude.com/docs/en/api/errors)
---
# Документация для ИИ и автоматизации
Source: https://1zheai.com/ru/docs/ai/
Markdown: https://1zheai.com/ru/docs/ai.md
---
title: "Документация для ИИ и автоматизации"
description: "Markdown, список страниц и границы автоматического подключения."
---
Русская документация доступна в HTML и в Markdown. Используйте [llms.txt](/ru/docs/llms.txt) как каталог, [список страниц](/ru/docs/docs-manifest.json) для выбора нужной темы и [полную версию](/ru/docs/llms-full.txt), если нужен весь материал.
## Как дать задачу помощнику
Передайте адрес нужной статьи и опишите клиент, версию, модель и цель. Попросите сначала проверить API, базовый URL и ограничения, затем подготовить конфигурацию с переменными окружения и короткий тест.
Не помещайте настоящий ключ в запрос помощнику, общую страницу или репозиторий. Пусть конфигурация читает секрет локально. Перед изменениями попросите сохранить прежние настройки и показать итог без значений ключей.
Подключаемого MCP-сервера документации пока нет. Базовый адрес API моделей не является адресом MCP. Чтение статьи или генерация конфига не доказывают, что живое приложение уже проверено. [Порядок работы](/ru/docs/agent-workflow/).
---
# Подключение с помощью ИИ
Source: https://1zheai.com/ru/docs/agent-workflow/
Markdown: https://1zheai.com/ru/docs/agent-workflow.md
---
title: "Подключение с помощью ИИ"
description: "Проверка условий, безопасная конфигурация и проверяемый результат вместо обещания совместимости."
---
## Передайте контекст
Назовите инструмент и версию, систему, точный model ID, нужные функции и адрес статьи. Используйте [каталог документации](/ru/docs/llms.txt); не передавайте ключ.
## Порядок работы
1. Помощник читает нужную инструкцию, проверяет протокол, адрес и статус проверки клиента.
2. Сохраняет исходные настройки и готовит минимальное изменение с ключом из окружения.
3. Вы показываете конфигурацию без секрета и подтверждаете целевую модель.
4. Выполняете короткий тест, затем при необходимости поток и инструменты.
5. Проверяете журнал и расходы. Неудача не считается успешной интеграцией.
Если живой тест не выполнен, итог должен прямо говорить об этом. Не следует автоматически заменять протокол по имени модели, раскрывать ключ или обещать поддержку всех расширений поставщика.
## Примеры запросов и конфигурации
Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
```text
Помогите подключить мой инструмент или приложение к 1ZheAI.
Инструмент и версия: [укажите]
Операционная система или язык программирования: [укажите]
Сначала прочитайте https://1zheai.com/ru/docs/llms.txt и найдите документацию инструмента или SDK.
Затем прочитайте Markdown этой страницы, справочник API и описание модели.
Требования:
1. Сначала объясните поддерживаемые функции и требования к конфигурации.
2. Выберите Base URL по инструменту. Не добавляйте и не удаляйте /v1 во всех адресах одинаково.
3. Используйте ID из документации и списка моделей, доступных ключу. Не угадывайте его.
4. Проверьте существующие настройки, меняйте только нужные поля, сохраните остальных провайдеров.
5. Используйте переменные окружения или хранилище клиента. Не помещайте ключи в исходный код,
диалоги, логи или историю коммитов. Попросите меня безопасно настроить ключ локально.
6. Перед платным тестом объясните действие и получите моё согласие.
7. Выполните один минимальный запрос и предложите проверить запись в журнале.
8. При ошибке сохраните статус и Request ID без секретов, используйте руководство по ошибкам;
Не скрывайте ошибку конфигурации многократными повторами.
9. Укажите изменённые файлы, результат проверки, ограничения и способ восстановления настроек.
```
---