Перейти к основному содержанию
Отправляйте запросы на один из хостов из таблицы, указывая свой API-ключ LaoZhang API. OpenAI SDK работает с https://api.laozhang.ai/v1, а Google Gen AI SDK и Anthropic SDK используют корень хоста и сами добавляют свои пути. Все три домена принимают один и тот же API-ключ, пути и параметры, поэтому при переключении меняется только имя хоста. Консоль тоже открывается на каждом из них. Выберите формат запроса, который уже использует ваше приложение, и модель, доступную группе вашего ключа.

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

Создайте API-ключ в разделе Управление токенами: в консоли он называется токеном. При создании вы выбираете группу и режим оплаты токена, а группа определяет, какие модели ключ может вызывать. В качестве режима оплаты выберите «сначала по использованию» (в консоли — «按量优先», рекомендуется). Такой ключ вызывает и текстовые модели с оплатой по использованию, и модель изображений с оплатой за вызов, которые используются ниже. Обе настройки описаны в разделе Тарификация, группы токенов и счета. Сохраните ключ в переменной окружения в том терминале, где будете запускать примеры:
Замените заглушку своим ключом. Храните ключ на сервере: не добавляйте его в клиентские сборки, репозиторий и логи. AccessToken для управления аккаунтом — отдельные учётные данные, они нужны только для эндпоинтов аккаунта, например API запроса баланса. В примерах используются такие модели:
  • gpt-5.4-mini — для текста
  • gemini-3.8-flash — для нативных запросов Gemini
  • glm-5.2 — для Anthropic Messages
  • gpt-image-2.5-flare-vip — для генерации изображений, gpt-image-2.5-sunburst-vip — для их редактирования
Чтобы взять другую модель, скопируйте её точный ID из раздела Модели и цены и проверьте, что группа вашего ключа может её вызывать. Как выбрать текстовую модель и формат запроса, описано в руководстве API генерации текста.

Текстовый запрос

Chat Completions принимает массив messages. API-ключ передаётся как Bearer-токен, тело запроса — JSON:
Ответ находится в choices[0].message.content; на этот промпт ожидается connected. Чтобы использовать тот же запрос в своём приложении, подставьте собственный текст сообщения. Поля сообщений, потоковую передачу и параметры отдельных моделей описывает справочник по протоколу OpenAI.

Подключение через OpenAI SDK

OpenAI SDK сам формирует путь эндпоинта, поэтому задайте базовый URL https://api.laozhang.ai/v1 без суффикса /chat/completions.
Установите SDK:
В примерах автоматические повторные попытки SDK отключены: так приложение само решает, когда повторять запрос. Тот же клиент работает и с эндпоинтами Responses, Images, Audio, Embeddings и Moderations. Какой эндпоинт нужен каждой модели OpenAI, включая o3-pro, GPT Image и речевые модели, показано в разделе Модели OpenAI в LaoZhang API.

Перенос существующего приложения с OpenAI

Приложению, которое уже работает через OpenAI SDK, нужно изменить три вещи: API-ключ и базовый URL в клиенте (ниже) и значение model в каждом запросе. Остальной код запросов остаётся прежним.
Если приложение настраивает SDK только через переменные окружения, переключиться можно без правки кода. Python- и Node.js-версии OpenAI SDK читают OPENAI_API_KEY и OPENAI_BASE_URL:
Перед отправкой рабочего трафика проверьте следующее:
  • ID моделей. Название модели, которое работает у OpenAI, в LaoZhang API может иметь другой ID или другую группу. Копируйте точные ID из раздела Модели и цены; остальные отличия от прямых вызовов OpenAI перечислены в руководстве по моделям OpenAI.
  • Необязательные параметры. Параметры сэмплирования, лимиты вывода, структурированный вывод и настройки инструментов зависят от модели. Начните с обязательных полей, затем добавляйте нужные опции. Если запрос вернул ошибку о неподдерживаемом параметре, уберите или измените указанное в ошибке поле.
  • Повторные попытки. Держите логику повторов в одном месте. Если повторяют и SDK, и приложение, одно действие пользователя породит несколько вызовов API.
  • Результат. Выполните минимальный запрос выше, найдите его в журнале вызовов и сверьте модель, расход токенов и списанную сумму.
Чтобы вернуться назад, восстановите прежние API-ключ и базовый URL.

Responses API

Responses API принимает в запросе поле input и возвращает массив output. Тело запроса отличается от Chat Completions, поэтому при переходе нужно изменить и сам запрос, и разбор ответа.
В сыром JSON соберите значения 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-ключа. Сохраняйте такие файлы сразу и держите собственную копию.
Примеры работы с обеими операциями через Python SDK есть в справочнике Images 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, и не считайте первый блок ответом.
Эндпоинт Messages обслуживает модели с пометкой Anthropic Messages в разделе Модели и цены:
  • Модели 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 тоже помечены для этого эндпоинта.
Для Anthropic Python SDK передайте base_url="https://api.laozhang.ai" и свой API-ключ LaoZhang API: SDK сам добавит /v1/messages. SDK, потоковую передачу и вызов инструментов описывает справочник по протоколу Claude.

Другие операции API

Частые ошибки

Исправляйте некорректные запросы до повторной отправки. При временных сбоях используйте повторы с ограниченной задержкой и не накладывайте повторы SDK на повторы приложения. Таймаут на стороне клиента не отменяет генерацию и не показывает, было ли списание. Прежде чем повторно отправлять запрос на изображение, проверьте журнал вызовов. За помощью пишите на hi@laozhang.ai или в Telegram @laozhang_cn, указав время запроса, модель, эндпоинт, группу токена и ошибку без секретных данных. Оплата и возвраты регулируются Условиями использования.

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

Передайте ассистенту модель, задачу и один из этих файлов:
  • skill.md: правила подключения и минимальные запросы для ассистентов, на английском языке.
  • llms.txt и llms-full.txt: индекс страниц и полный текст документации. Сейчас оба файла содержат китайскую версию.
Передавайте учётные данные через окружение, а не вставляйте их в промпты.

Справочники API

Справочники LaoZhang API: Поля запросов и возможности моделей определяют официальные справочники провайдеров. ID моделей, доступ и цены в LaoZhang API указаны в разделе Модели и цены и в консоли. Для Alibaba Cloud, ByteDance, xAI, Black Forest Labs, DeepSeek и других вендоров смотрите официальную документацию API по вендорам: там же указано, какое руководство LaoZhang API соответствует каждому вендору.