API генерации текста: протоколы, модели и цены за 1M токенов

​

Выбор протокола

• Новый проект или клиент на OpenAI SDK либо формате OpenAI: используйте Chat Completions, совместимый с OpenAI. См. справочник по протоколу OpenAI.
• Anthropic SDK, Claude Code или другой клиент Messages: используйте Anthropic Messages. См. справочник по протоколу Claude.
• Google Gen AI SDK или код, опирающийся на нативные поля Gemini: используйте формат Gemini. См. справочник по протоколу Gemini.

Совместимый с OpenAI   POST https://api.laozhang.ai/v1/chat/completions
Anthropic Messages     POST https://api.laozhang.ai/v1/messages
Нативный Gemini        POST https://api.laozhang.ai/v1beta/models/{model}:generateContent

• модели Claude, снова доступные с 18 октября 2026; перед переходом прочитайте ограничения моделей Claude;
• glm-5.2 (группа токена default);
• deepseek-v4-pro;
• deepseek-v4-flash.

​

Популярные текстовые модели

• Модели GPT-6, модели GPT-5.6, gpt-5.4 и claude-haiku-5-5 для длинных входов тарифицируются по повышенной ступени. Пороги и цены перечислены в таблице ступенчатых цен каталога.
• Как выбрать среди трёх моделей GPT-6 и каковы правила OpenAI для их параметров и вызова инструментов в Chat Completions, описано в объявлении о запуске GPT-6.
• Перечисленные модели OpenAI работают и с эндпоинтом Responses, POST /v1/responses, а серия o3-pro поддерживает только Responses.
• Вызов инструментов у GPT-6 Astra и GPT-6.1 Sol требует Responses. Остальные отличия параметров GPT-6.1 Sol описаны в объявлении о запуске GPT-6.1 Sol. Примеры есть в материале Модели OpenAI.
• Если Gemini 4 Argon должна рассуждать глубоко, передайте уровень мышления high. Уровни мышления и стартовые цены описаны в объявлении о запуске Gemini 4 Argon.
• Чтобы отправлять изображения модели с поддержкой зрения, см. API анализа изображений.

​

Первый запрос

export LAOZHANG_API_KEY="YOUR_LAOZHANG_API_KEY"

• Python: выполните python -m pip install openai.
• Node.js: выполните npm install openai, сохраните код как chat.mjs и запустите командой node chat.mjs.

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

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LAOZHANG_API_KEY"],
    base_url="https://api.laozhang.ai/v1",
    timeout=120.0,
    max_retries=0,
)
response = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[{"role": "user", "content": "Ответь только одним словом: connected"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LAOZHANG_API_KEY,
  baseURL: "https://api.laozhang.ai/v1",
  timeout: 120_000,
  maxRetries: 0,
});
const response = await client.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [{ role: "user", content: "Ответь только одним словом: connected" }],
});
console.log(response.choices[0].message.content);

​

Потоковая передача ответа

• Совместимый с OpenAI: добавляйте в конец каждый choices[0].delta.content по порядку и пропускайте фрагменты без choices или content. Поток заканчивается строкой data: [DONE]. Полные примеры cURL и Python и сырые события есть в разделе «Потоковый ответ» справочника по протоколу OpenAI.
• Anthropic Messages: текст приходит как delta.text в событиях content_block_delta, а ответ завершён только после message_stop. См. раздел «Потоковый ответ» справочника по протоколу Claude.
• Нативный Gemini: замените generateContent на streamGenerateContent и добавьте ?alt=sse. Каждое событие несёт частичный ответ с candidates; см. раздел о потоковом ответе в справочнике по протоколу Gemini.
• Если соединение закрылось до маркера конца, полученный текст неполон: считайте запрос неудавшимся или отправьте его заново. В cURL добавьте -N, чтобы отключить буферизацию вывода.

​

Типичные ошибки

• 404 с /v1/v1 в URL: базовый URL SDK повторяет часть пути. Для OpenAI SDK используйте https://api.laozhang.ai/v1, для Anthropic SDK и Google Gen AI SDK — https://api.laozhang.ai.
• Модель недоступна, 403 или 404: скопируйте точный ID модели из каталога, убедитесь, что группа токена включает эту модель, и проверьте, что модель поддерживает отправляемый формат. Например, o3-pro работает только через Responses, вызов инструментов у gpt-6-astra требует Responses, а модели GPT не принимают нативные запросы Gemini. См. доступность моделей.
• 400: частая причина — запрос Messages без max_tokens. В остальных случаях вернитесь к минимальному запросу, добавляйте необязательные поля по одному и исправьте поле, которое называет ошибка.
• 401: API-ключ неверен, заголовок сформирован неправильно или переменная окружения не задана в текущей оболочке.
• Пустой ответ:
  • Chat Completions: проверьте message.tool_calls и finish_reason.
  • Messages: читайте content[] по type блока, а не берите content[0].
  • Gemini: проверьте finishReason и promptFeedback.
• Обрезанный ответ: любое из этих значений означает, что ответ упёрся в предел вывода. Увеличьте лимит вывода модели или сократите вход.
  • Chat Completions: finish_reason равен length.
  • Messages: stop_reason равен max_tokens.
  • Gemini: finishReason равен MAX_TOKENS.
• 429: по тексту ошибки определите, лимит это скорости или параллельности либо нехватка баланса. Если баланс есть, см. Сбой при положительном балансе.

​

Перед выходом в продакшен

1. Зафиксируйте в конфигурации ID модели и протокол и проверяйте смену модели как любой другой релиз.
2. Прогоните выборку своих промптов через две-три модели-кандидата и сравните качество ответов, задержку и расход токенов. Сравнение описано в разделе «Выбор модели» справочника по протоколу OpenAI.
3. Проверьте обычные запросы, потоковую передачу и обработку ошибок. Держите повторы на одном уровне — либо в SDK, либо в приложении.
4. В журнале вызовов проверьте модель, входные и выходные токены и стоимость каждого запроса.

​

Связанные материалы

• Протокол OpenAI: Chat Completions
• Модели OpenAI в LaoZhang API
• Протокол Claude: Anthropic Messages
• Протокол Gemini: generateContent
• Руководство по подключению: ключи, базовые URL, Responses и изображения
• Каталог моделей и цен
• Документация провайдеров: генерация текста OpenAI, Anthropic Messages API и генерация текста Gemini