https://api.laozhang.ai/v1, а Google Gen AI SDK и Anthropic SDK используют корень хоста и сами добавляют свои пути.
Все три домена принимают один и тот же API-ключ, пути и параметры, поэтому при переключении меняется только имя хоста. Консоль тоже открывается на каждом из них. Выберите формат запроса, который уже использует ваше приложение, и модель, доступную группе вашего ключа.
Создание API-ключа
Создайте API-ключ в разделе Управление токенами: в консоли он называется токеном. При создании вы выбираете группу и режим оплаты токена, а группа определяет, какие модели ключ может вызывать. В качестве режима оплаты выберите «сначала по использованию» (в консоли — «按量优先», рекомендуется). Такой ключ вызывает и текстовые модели с оплатой по использованию, и модель изображений с оплатой за вызов, которые используются ниже. Обе настройки описаны в разделе Тарификация, группы токенов и счета. Сохраните ключ в переменной окружения в том терминале, где будете запускать примеры:gpt-5.4-mini— для текстаgemini-3.8-flash— для нативных запросов Geminiglm-5.2— для Anthropic Messagesgpt-image-2.5-flare-vip— для генерации изображений,gpt-image-2.5-sunburst-vip— для их редактирования
Текстовый запрос
Chat Completions принимает массивmessages. API-ключ передаётся как Bearer-токен, тело запроса — JSON:
choices[0].message.content; на этот промпт ожидается connected. Чтобы использовать тот же запрос в своём приложении, подставьте собственный текст сообщения. Поля сообщений, потоковую передачу и параметры отдельных моделей описывает справочник по протоколу OpenAI.
Подключение через OpenAI SDK
OpenAI SDK сам формирует путь эндпоинта, поэтому задайте базовый URLhttps://api.laozhang.ai/v1 без суффикса /chat/completions.
- Python
- Node.js
Установите SDK:
o3-pro, GPT Image и речевые модели, показано в разделе Модели OpenAI в LaoZhang API.
Перенос существующего приложения с OpenAI
Приложению, которое уже работает через OpenAI SDK, нужно изменить три вещи: API-ключ и базовый URL в клиенте (ниже) и значениеmodel в каждом запросе. Остальной код запросов остаётся прежним.
OPENAI_API_KEY и OPENAI_BASE_URL:
- ID моделей. Название модели, которое работает у OpenAI, в LaoZhang API может иметь другой ID или другую группу. Копируйте точные ID из раздела Модели и цены; остальные отличия от прямых вызовов OpenAI перечислены в руководстве по моделям OpenAI.
- Необязательные параметры. Параметры сэмплирования, лимиты вывода, структурированный вывод и настройки инструментов зависят от модели. Начните с обязательных полей, затем добавляйте нужные опции. Если запрос вернул ошибку о неподдерживаемом параметре, уберите или измените указанное в ошибке поле.
- Повторные попытки. Держите логику повторов в одном месте. Если повторяют и SDK, и приложение, одно действие пользователя породит несколько вызовов API.
- Результат. Выполните минимальный запрос выше, найдите его в журнале вызовов и сверьте модель, расход токенов и списанную сумму.
Responses API
Responses API принимает в запросе полеinput и возвращает массив output. Тело запроса отличается от Chat Completions, поэтому при переходе нужно изменить и сам запрос, и разбор ответа.
- cURL
- Python
text из элементов содержимого типа output_text внутри массива output. Хелпер SDK делает это за вас. Другие элементы массива могут содержать рассуждения или вызовы инструментов, поэтому первый элемент не обязательно является текстовым ответом.
LaoZhang API поддерживает Responses API от OpenAI, так что его могут использовать текстовые модели OpenAI, например GPT-6, GPT-5.6, GPT-5.4 и o3-pro. Прежде чем переводить на этот эндпоинт модель другого вендора, отправьте минимальный запрос и убедитесь, что она работает.
Серверное хранение диалога, previous_response_id и встроенные инструменты тоже зависят от модели. Если приложению нужна история диалога, храните сообщения, которые понадобятся следующему запросу. Поля описаны в справочнике OpenAI по Responses, а обработка данных — в Политике данных.
Генерация и редактирование изображений
Оба эндпоинта Images возвращают массивdata. В зависимости от модели каждый элемент содержит изображение в Base64 в поле b64_json или ссылку для скачивания в поле url.
В примерах используются модели GPT Image 2.5 VIP: они оплачиваются за вызов, тогда как текстовые примеры оплачиваются по использованию. Ключ с режимом «сначала по использованию» вызывает и те и другие; если запрос на изображение отклонён, проверьте, что режим оплаты ключа — «сначала по использованию» (按量优先) или «оплата за вызов» (按次计费).
Генерация изображения
Отправьте промпт в JSON на эндпоинт генерации:Редактирование изображения
Положите референсное изображениеinput.png в текущую папку и отправьте его вместе с инструкцией как multipart/form-data:
@ загружает содержимое файла. Тип содержимого multipart и boundary выставит сам cURL, поэтому не добавляйте в этот запрос заголовок Content-Type: application/json.
Сохранение результата
Файл ответа — это JSON, а не изображение. Сохраните этот скрипт какsave_images.py; он использует только стандартную библиотеку Python:
data, например generation-1.png. Он обрабатывает:
- Base64 с префиксом
data:image/...;base64,или без завершающего padding=. - Результаты в виде
url: он скачивает их без вашего API-ключа. Сохраняйте такие файлы сразу и держите собственную копию.
Нативный API Gemini
Нативный API Gemini используетcontents[].parts[] вместо сообщений OpenAI:
candidates[].content.parts[]. Если текста нет, проверьте finishReason и promptFeedback.
Для Google Gen AI SDK используйте корень хоста https://api.laozhang.ai и api_version="v1beta": SDK сам добавит путь модели и заголовок с ключом. В справочнике по протоколу Gemini есть полный пример на Python, оба варианта заголовка авторизации и инструкции по передаче изображений, PDF и аудио. Анализ кадров и звука из видео MP4 описан в разделе API понимания видео.
API Anthropic Messages
Приложения на формате Anthropic Messages, в том числе на Anthropic SDK, отправляют запросы на/v1/messages:
- Обязательные поля:
model,messagesиmax_tokens. - Системный промпт: передавайте его в поле
systemверхнего уровня, а не вmessages. - Ответ: массив
contentможет содержать блокиtext,thinkingиtool_use. - Текст ответа: читайте блоки с
type, равнымtext, и не считайте первый блок ответом.
- Модели Claude, снова доступные с 18 октября 2026 года, например
claude-sonnet-5-5иclaude-opus-5-5. Чем они отличаются от собственного API Anthropic, описано в разделе ограничения моделей Claude. glm-5.2из группы токеновdefaultведёт себя почти так же, как собственный Messages API Anthropic.deepseek-v4-proиdeepseek-v4-flashтоже помечены для этого эндпоинта.
base_url="https://api.laozhang.ai" и свой API-ключ LaoZhang API: SDK сам добавит /v1/messages. SDK, потоковую передачу и вызов инструментов описывает справочник по протоколу Claude.
Другие операции API
- Models API: список ID моделей для вашего приложения.
- Эмбеддинги: преобразование текста в векторы.
- Транскрипция аудио: загрузка аудио и получение расшифровки.
Частые ошибки
Исправляйте некорректные запросы до повторной отправки. При временных сбоях используйте повторы с ограниченной задержкой и не накладывайте повторы SDK на повторы приложения.
Таймаут на стороне клиента не отменяет генерацию и не показывает, было ли списание. Прежде чем повторно отправлять запрос на изображение, проверьте журнал вызовов.
За помощью пишите на hi@laozhang.ai или в Telegram @laozhang_cn, указав время запроса, модель, эндпоинт, группу токена и ошибку без секретных данных. Оплата и возвраты регулируются Условиями использования.
Документация в ИИ-инструментах для программирования
Передайте ассистенту модель, задачу и один из этих файлов:- skill.md: правила подключения и минимальные запросы для ассистентов, на английском языке.
- llms.txt и llms-full.txt: индекс страниц и полный текст документации. Сейчас оба файла содержат китайскую версию.
Справочники API
Справочники LaoZhang API:- API генерации текста: выбор протокола и модели
- Модели OpenAI: эндпоинты и настройка SDK
- Протокол OpenAI: Chat Completions
- Протокол Claude: Anthropic Messages
- Протокол Gemini: generateContent
- Images API: генерация и редактирование изображений
- Models API
- OpenAI: API reference, Chat Completions, Responses и модели
- Anthropic: Messages API
- Google: документация Gemini API и справочник generateContent