> ## Documentation Index > Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt > Use this file to discover all available pages before exploring further. # API генерации текста: протоколы, модели и цены за 1M токенов > Генерируйте текст через LaoZhang API: выберите формат OpenAI, Anthropic Messages или Gemini, сравните модели и научитесь читать потоковые ответы. LaoZhang API отдаёт текстовые модели в трёх форматах запросов с одним и тем же API-ключом: Chat Completions, совместимый с OpenAI, Anthropic Messages и нативный generateContent от Gemini. Для нового проекта берите Chat Completions: он работает с наибольшим числом текстовых моделей. | Параметр | Значение | | - | - | | Хост API | `https://api.laozhang.ai` | | Новый проект | Отправьте `model` и `messages` на `POST /v1/chat/completions` и прочитайте ответ из `choices[0].message.content` | | Приложение на готовом SDK | Если оно уже использует Anthropic SDK, Claude Code или Google Gen AI SDK, сохраните формат запросов и замените только базовый URL и API-ключ | | Форматы по моделям | Столбец **Endpoints** в [каталоге моделей](https://docs.laozhang.ai/ru/models.md) | | Цены | См. раздел «Популярные текстовые модели» ниже | ## Выбор протокола * **Новый проект или клиент на OpenAI SDK либо формате OpenAI**: используйте Chat Completions, совместимый с OpenAI. См. [справочник по протоколу OpenAI](https://docs.laozhang.ai/ru/api-reference/chat-completions.md). * **Anthropic SDK, Claude Code или другой клиент Messages**: используйте Anthropic Messages. См. [справочник по протоколу Claude](https://docs.laozhang.ai/ru/api-reference/claude.md). * **Google Gen AI SDK или код, опирающийся на нативные поля Gemini**: используйте формат Gemini. См. [справочник по протоколу Gemini](https://docs.laozhang.ai/ru/api-reference/gemini.md). У каждого формата свой эндпоинт: ```text theme={null} Совместимый с 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 ``` При работе через SDK задайте для OpenAI SDK базовый URL `https://api.laozhang.ai/v1`. Anthropic SDK и Google Gen AI SDK принимают корень хоста `https://api.laozhang.ai` и сами добавляют путь. Эндпоинт Anthropic Messages обслуживает модели, помеченные для него в конфигурации цен, в том числе: * модели Claude, снова доступные с 18 октября 2026; перед переходом прочитайте [ограничения моделей Claude](https://docs.laozhang.ai/ru/api-reference/claude.md); * `glm-5.2` (группа токена `default`); * `deepseek-v4-pro`; * `deepseek-v4-flash`. Структуры запросов и ответов различаются, поэтому при смене формата нужно менять и код запроса, и разбор ответа: | | Совместимый с OpenAI | Anthropic Messages | Нативный Gemini | | - | - | - | - | | ID модели | `model` в теле | `model` в теле | Путь URL | | Вход | `messages` | `messages` и обязательный `max_tokens` | `contents[].parts[]` | | Системный промпт | Сообщение с ролью `system` | `system` верхнего уровня | `systemInstruction` | | Текст ответа | `choices[0].message.content` | Блоки `text` в `content[]` | `text` в `parts[]` | | Потоковая передача | `"stream": true` | `"stream": true` | `streamGenerateContent` | Модель, помеченная двумя форматами, например `gemini-3.8-flash` (Chat Completions и нативный Gemini), принимает любой из них, но каждый запрос должен использовать поля одного формата. ## Популярные текстовые модели Цены ниже — публичные цены LaoZhang API по состоянию на 18 октября 2026. Это прайс-цены для группы токена `default` в долларах США за 1M токенов. Цены чтения из кэша, другие модели и другие группы токенов есть в [каталоге моделей](https://docs.laozhang.ai/ru/models.md). | ID модели | Форматы | Вход / выход | | - | - | - | | `gpt-6-luna` | Совместимый с OpenAI | \$0.1 / \$0.5 | | `gpt-6-sol` | Совместимый с OpenAI | \$2 / \$10 | | `gpt-6.1-sol` | Совместимый с OpenAI | \$2 / \$10 | | `gpt-6-astra` | Совместимый с OpenAI | \$10 / \$50 | | `gpt-5.6-luna` | Совместимый с OpenAI | \$0.2 / \$1.2 | | `gpt-5.6-terra` | Совместимый с OpenAI | \$2 / \$12 | | `gpt-5.6-sol` | Совместимый с OpenAI | \$4 / \$20 | | `gpt-5.4-mini` | Совместимый с OpenAI | \$0.75 / \$4.5 | | `gpt-5.4` | Совместимый с OpenAI | \$2.5 / \$15 | | `gemini-4-argon` | Совместимый с OpenAI, нативный Gemini | \$2 / \$10 | | `gemini-3.8-flash` | Совместимый с OpenAI, нативный Gemini | \$0.75 / \$3.75 | | `gemini-3.6-flash` | Совместимый с OpenAI, нативный Gemini | \$1.5 / \$7.5 | | `gemini-3.5-flash-lite` | Совместимый с OpenAI, нативный Gemini | \$0.3 / \$2.502 | | `claude-opus-5-5` | Совместимый с OpenAI, Anthropic Messages | \$4 / \$20 | | `claude-sonnet-5-5` | Совместимый с OpenAI, Anthropic Messages | \$2 / \$10 | | `claude-haiku-5-5` | Совместимый с OpenAI, Anthropic Messages | \$0.1 / \$0.5 | | `glm-5.2` | Совместимый с OpenAI, Anthropic Messages | См. каталог | | `deepseek-v4-pro` | Совместимый с OpenAI, Anthropic Messages | См. каталог | | `deepseek-v4-flash` | Совместимый с OpenAI, Anthropic Messages | См. каталог | | `o3-pro` | Responses | См. каталог | * Модели GPT-6, модели GPT-5.6, `gpt-5.4` и `claude-haiku-5-5` для длинных входов тарифицируются по повышенной ступени. Пороги и цены перечислены в таблице [ступенчатых цен](https://docs.laozhang.ai/ru/models.md) каталога. * Как выбрать среди трёх моделей GPT-6 и каковы правила OpenAI для их параметров и вызова инструментов в Chat Completions, описано в [объявлении о запуске GPT-6](https://docs.laozhang.ai/en/announcements/gpt-6-launch-2026-09.md). * Перечисленные модели OpenAI работают и с эндпоинтом Responses, `POST /v1/responses`, а серия `o3-pro` поддерживает только Responses. * Вызов инструментов у GPT-6 Astra и GPT-6.1 Sol требует Responses. Остальные отличия параметров GPT-6.1 Sol описаны в [объявлении о запуске GPT-6.1 Sol](https://docs.laozhang.ai/en/announcements/gpt-6-1-sol-2026-10.md). Примеры есть в материале [Модели OpenAI](https://docs.laozhang.ai/ru/api-reference/openai.md). * Если Gemini 4 Argon должна рассуждать глубоко, передайте уровень мышления `high`. Уровни мышления и стартовые цены описаны в [объявлении о запуске Gemini 4 Argon](https://docs.laozhang.ai/en/announcements/gemini-4-argon-2026-10.md). * Чтобы отправлять изображения модели с поддержкой зрения, см. [API анализа изображений](https://docs.laozhang.ai/en/api-capabilities/vision-understanding.md). ## Первый запрос Создайте API-ключ в разделе [управления токенами](https://api.laozhang.ai/token). Выберите режим оплаты «сначала по использованию» (按量优先, рекомендуется) или «оплата по использованию» (按量计费) и убедитесь, что группа токена позволяет вызывать нужную модель. Затем сохраните ключ в переменной окружения: ```bash theme={null} export LAOZHANG_API_KEY="YOUR_LAOZHANG_API_KEY" ``` В примерах одно сообщение отправляется в `gpt-5.4-mini` в формате, совместимом с OpenAI. Перед запуском установите SDK: * Python: выполните `python -m pip install openai`. * Node.js: выполните `npm install openai`, сохраните код как `chat.mjs` и запустите командой `node chat.mjs`. > [tab] cURL > > ```bash theme={null} > 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"}] > }' > ``` > [tab] Python > > ```python theme={null} > 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) > ``` > [tab] Node.js > > ```javascript theme={null} > 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); > ``` Ответом должно быть `connected`. Чтобы попробовать другую модель, замените `model` на ID, у которого в **Endpoints** есть формат OpenAI. В SDK-примерах автоматические повторы отключены, чтобы вы сами решали, когда отправлять запрос заново. ## Потоковая передача ответа Добавьте `"stream": true`, чтобы получать ответ как server-sent events по мере того, как модель его пишет. Форматы передают поток немного по-разному: * **Совместимый с OpenAI**: добавляйте в конец каждый `choices[0].delta.content` по порядку и пропускайте фрагменты без `choices` или `content`. Поток заканчивается строкой `data: [DONE]`. Полные примеры cURL и Python и сырые события есть в разделе «Потоковый ответ» [справочника по протоколу OpenAI](https://docs.laozhang.ai/ru/api-reference/chat-completions.md). * **Anthropic Messages**: текст приходит как `delta.text` в событиях `content_block_delta`, а ответ завершён только после `message_stop`. См. раздел «Потоковый ответ» [справочника по протоколу Claude](https://docs.laozhang.ai/ru/api-reference/claude.md). * **Нативный Gemini**: замените `generateContent` на `streamGenerateContent` и добавьте `?alt=sse`. Каждое событие несёт частичный ответ с `candidates`; см. раздел о потоковом ответе в [справочнике по протоколу Gemini](https://docs.laozhang.ai/ru/api-reference/gemini.md). * Если соединение закрылось до маркера конца, полученный текст неполон: считайте запрос неудавшимся или отправьте его заново. В 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. См. [доступность моделей](https://docs.laozhang.ai/en/faq/model-availability.md). * **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**: по тексту ошибки определите, лимит это скорости или параллельности либо нехватка баланса. Если баланс есть, см. [Сбой при положительном балансе](https://docs.laozhang.ai/ru/faq/balance-insufficient.md). ## Перед выходом в продакшен 1. Зафиксируйте в конфигурации ID модели и протокол и проверяйте смену модели как любой другой релиз. 2. Прогоните выборку своих промптов через две-три модели-кандидата и сравните качество ответов, задержку и расход токенов. Сравнение описано в разделе «Выбор модели» [справочника по протоколу OpenAI](https://docs.laozhang.ai/ru/api-reference/chat-completions.md). 3. Проверьте обычные запросы, потоковую передачу и обработку ошибок. Держите повторы на одном уровне — либо в SDK, либо в приложении. 4. В [журнале вызовов](https://api.laozhang.ai/log) проверьте модель, входные и выходные токены и стоимость каждого запроса. ## Связанные материалы * [Протокол OpenAI: Chat Completions](https://docs.laozhang.ai/ru/api-reference/chat-completions.md) * [Модели OpenAI в LaoZhang API](https://docs.laozhang.ai/ru/api-reference/openai.md) * [Протокол Claude: Anthropic Messages](https://docs.laozhang.ai/ru/api-reference/claude.md) * [Протокол Gemini: generateContent](https://docs.laozhang.ai/ru/api-reference/gemini.md) * [Руководство по подключению](https://docs.laozhang.ai/ru/api-manual.md): ключи, базовые URL, Responses и изображения * [Каталог моделей и цен](https://docs.laozhang.ai/ru/models.md) * Документация провайдеров: [генерация текста OpenAI](https://developers.openai.com/api/docs/guides/text), [Anthropic Messages API](https://platform.claude.com/docs/en/api/messages) и [генерация текста Gemini](https://ai.google.dev/gemini-api/docs/text-generation) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.