Главная / Документация

Документация · Quick Start

Первый запрос к нейросети: за 5 минут

TryLucid говорит на языке OpenAI API. Есть код под OpenAI, переписывать логику не нужно: поменяйте base_url и ключ, и тот же код пойдёт к Claude, GPT, Gemini или Grok.

Получить ключ Каталог моделей

Quick Start: три шага до ответа

Получите ключ: зарегистрируйтесь на app.trylucid.co, пополните баланс и создайте ключ в личном кабинете (см. «Аутентификация»).
Укажите базовый адрес: https://app.trylucid.co/v1
Отправьте запрос на /v1/chat/completions с Bearer-ключом в заголовке.

ПЕРВЫЙ ЗАПРОС · curl

curl https://app.trylucid.co/v1/chat/completions \
  -H "Authorization: Bearer $LUCID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {"role": "user", "content": "Привет! Ответь одним предложением."}
    ]
  }'

Важно сразу: ответ приходит целиком, одним объектом: потоковая передача (stream) не поддерживается. Нужен эффект «печати» в чат-интерфейсе, его сглаживают на стороне клиента.

Аутентификация

Авторизация — по стандарту OpenAI: секретный ключ передаётся в заголовке Authorization как Bearer-токен.

Authorization: Bearer ВАШ_КЛЮЧ

Один ключ: все модели и один баланс. Не нужно заводить отдельные аккаунты и карты у каждого вендора: одним ключом вы обращаетесь к моделям всех подключённых провайдеров, а списание идёт с единого рублёвого баланса.

Как выдаётся ключ (честно, без прикрас)

Личный кабинет на app.trylucid.co: регистрация, баланс и выпуск ключей — самостоятельно.
Баланс пополняется в личном кабинете; юрлицам выставляем счёт по заявке. Персональное подключение остаётся: поможем вставить base_url и ключ в ваш код и проверить первый запрос.
Цены — за 1 млн токенов, вход и выход отдельно, в рублях. Ставки указаны в каталоге Модели.

Безопасность ключа

Храните ключ в переменных окружения (например, LUCID_API_KEY), а не в коде и не в репозитории.
Не передавайте ключ на фронтенд: все вызовы к API делайте с сервера.
Ключ утёк — напишите инженеру в Telegram, перевыпустим.

Базовый URL и эндпоинт

Все запросы идут на единый базовый адрес. Пути повторяют формат OpenAI, поэтому клиентские библиотеки работают без доработок: достаточно подменить base_url.

https://app.trylucid.co/v1

Метод	Путь	Назначение
`POST`	`/v1/chat/completions`	Генерация ответа модели по истории сообщений (chat-формат). Главный эндпоинт: здесь 95% сценариев.

Нужен другой OpenAI-совместимый путь под вашу интеграцию, уточните у инженера в Telegram: подскажем по факту, поддерживается ли он на шлюзе.

`id` (поле model)	Модель	Контекст	Vision	Function calling
`claude-sonnet-4-6`	Claude Sonnet	200K	✓	✓
`claude-opus-4-7`	Claude Opus	200K	✓	✓
`claude-haiku-4-5-20251001`	Claude Haiku	200K	✕	✓
`gpt-5.5-2026-04-23`	GPT-5.5	128K	✓	✓
`grok-4-latest`	Grok 4	131K	✕	✓

Параметры запроса и нюансы

Запрос к /v1/chat/completions использует привычные OpenAI-параметры. Обязательные: model и messages.

Параметр	Тип	Назначение
`model`	string	`id` модели из таблицы выше. Обязателен.
`messages`	array	История диалога: объекты с `role` (system/user/assistant) и `content`. Обязателен.
`max_tokens`	integer	Ограничение длины ответа в токенах.
`temperature`	number	Степень «креативности» (0 — детерминированнее).
`top_p`	number	Nucleus-сэмплинг как альтернатива `temperature`.
`stop`	string / array	Стоп-последовательности.
`tools` / `tool_choice`	array / string	Function calling: поддерживается всеми моделями из списка.

Нюанс 1. temperature и top_p нельзя передавать одновременно: выбирайте что-то одно, иначе шлюз вернёт 400. По умолчанию достаточно temperature.

Нюанс 2. Потоковая передача (stream) не поддерживается: ответ всегда приходит целиком, одним JSON. Не завязывайте архитектуру на построчный вывод из API. На бэкенд-задачи (генерация, классификация, function calling) это не влияет.

Примеры кода

Везде одинаковый принцип: штатный OpenAI-клиент + подмена base_url на https://app.trylucid.co/v1. Кастомных SDK ставить не нужно.

Python · openai

from openai import OpenAI

client = OpenAI(
    api_key="ВАШ_КЛЮЧ",
    base_url="https://app.trylucid.co/v1",
)
r = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "system", "content": "Ты — лаконичный ассистент."},
        {"role": "user", "content": "Что такое эмбеддинг?"},
    ],
    temperature=0.7,  # не вместе с top_p
)
print(r.choices[0].message.content)

Node.js · openai

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LUCID_API_KEY,
  baseURL: "https://app.trylucid.co/v1",
});
const r = await client.chat.completions.create({
  model: "gpt-5.5-2026-04-23",
  messages: [
    { role: "user", content: "Три идеи названия." },
  ],
  // stream: true — не поддерживается
});
console.log(r.choices[0].message.content);

LangChain · langchain_openai

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="claude-sonnet-4-6",
    api_key="ВАШ_КЛЮЧ",
    base_url="https://app.trylucid.co/v1",
)
print(llm.invoke("План статьи про RAG.").content)

curl · Haiku для классификации

curl https://app.trylucid.co/v1/chat/completions \
  -H "Authorization: Bearer $LUCID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5-20251001",
    "messages": [
      {"role":"user","content":"Тональность: Отличный сервис!"}
    ],
    "max_tokens": 50
  }'

Обработка ошибок

Шлюз возвращает стандартные HTTP-коды и OpenAI-совместимое тело ошибки: обработка в вашем коде остаётся привычной.

Код	Значение	Что делать
`200`	OK	Успех, ответ в `choices[].message.content`.
`400`	Bad Request	Невалидный JSON, нет `model`/`messages`, либо `temperature` и `top_p` вместе.
`401`	Unauthorized	Ключ отсутствует, неверен или отозван. Проверьте заголовок `Authorization`.
`403`	Forbidden	Доступ к модели/операции закрыт. Уточните у инженера.
`404`	Not Found	Неверный путь или несуществующий `id` модели (сверьтесь с таблицей).
`429`	Too Many Requests	Превышены лимиты/квоты или закончился баланс. Повтор с backoff.
`5xx`	Server Error	Временный сбой шлюза или upstream. Повторите с retry.

Для 429 и 5xx: повтор с экспоненциальной задержкой (backoff), они временные.
Для 400/401 повтор бесполезен: чините запрос или ключ.
Официальные SDK кидают типизированные исключения: оборачивайте вызовы в try/except и логируйте error.message.

Лимиты, квоты и оплата

Лимит частоты запросов: [уточняется], согласуем под ваш объём.
Квоты по токенам: [уточняется].
Тарификация: по факту использования, в рублях, за токены: вход и выход отдельно, за 1 млн токенов. Без обязательной подписки. Ставки: [цена уточняется], прайс высылаем на заявку.

Один баланс работает на все модели: не нужно распределять средства между провайдерами. Планируете высокую нагрузку — предупредите инженера заранее, подберём условия под объём.

Готовы сделать первый запрос?

Оставьте заявку: инженер выдаст ключ, пришлёт прайс и поможет подключиться. Из России, без VPN, оплата в рублях.

Оставить заявку на ключ

Первый запрос к нейросети: за 5 минут

Quick Start: три шага до ответа

Аутентификация

Как выдаётся ключ (честно, без прикрас)

Безопасность ключа

Базовый URL и эндпоинт

Популярные модели и их id

Параметры запроса и нюансы

Примеры кода

Обработка ошибок

Лимиты, квоты и оплата

Готовы сделать первый запрос?

Популярные модели и их `id`