Перейти к основному содержанию
POST
Каждый запрос стоит 10 000 кредитов с lana-thinking или 2 000 кредитов с lana-fast. Требуется платный тариф. Запросы на бесплатном тарифе возвращают 403 Forbidden. Краткое руководство, сведения о потоковых событиях и обработке ошибок см. в руководстве по Lana API.

Параметры запроса

string
обязательно
lana-thinking предназначена для многоэтапного анализа и поддерживает до 20 этапов поиска за ход; она может передавать рассуждения в потоковом режиме. lana-fast предназначена для быстрого поиска и отдельных фактов и поддерживает до 4 этапов поиска за ход.
  • lana-thinking
  • lana-fast
array
обязательно
Диалог, начиная с самого старого сообщения. Он должен содержать хотя бы одно сообщение, а последнее сообщение должно иметь role user. API не хранит диалоги; отправляйте весь диалог с каждым запросом.
string
обязательно
Кто написал сообщение.
  • user
  • assistant
any
обязательно
Непустая строка или непустой массив блоков содержимого. text разрешен для обеих ролей, image и tool_result — только в сообщениях user, а tool_use — только в сообщениях assistant.
number
по умолчанию:"8192"
Максимальное количество выходных токенов, которое Lana может создать за один этап работы модели. Ход с поиском занимает несколько этапов, поэтому общее значение output_tokens за ход может быть выше. При значении ниже 2 048 lana-thinking не выполняет рассуждения.
boolean
по умолчанию:"false"
true передает отправляемые сервером события в потоковом режиме. false возвращает один объект JSON после завершения хода.
string
Дополнительные инструкции, например «Ответьте тремя пунктами маркированного списка». Они добавляются к собственным инструкциям Lana, а не заменяют их.
object
Параметры только для Lana. Все они необязательны. Параметры include_* разрешают вывод; Lana решает, отправлять ли его.
boolean
по умолчанию:"true"
Удаляет инструменты для переводов, обмена и запуска токенов. Оставьте значение true.
string
по умолчанию:"markdown"
plain указывает Lana не использовать Markdown и удаляет маркеры {{cite:N}}. События source по-прежнему поступают.
  • markdown
  • plain
boolean
по умолчанию:"false"
Разрешает компоненты пользовательского интерфейса в виде событий ui_block и ui_schema.
boolean
по умолчанию:"false"
Разрешает до 3 предлагаемых уточняющих вопросов.
boolean
по умолчанию:"false"
Разрешает скачиваемые файлы CSV, JSON или текстовые файлы в виде событий document.
boolean
по умолчанию:"false"
Позволяет Lana читать до 10 000 транзакций из истории адреса (50 000 для подсчета количества и итоговых значений), выполняя до 3 сканирований за ход. Только для основной сети. Без этого параметра Lana читает до 100 транзакций за один поиск. Стоимость остается фиксированной.
object
Сведения о пользователе, который задает вопрос.
string
Адрес пользователя, необходимый для обработки фраз «мой кошелек» и «мой баланс».
string
wallet или token: указывает, чем является wallet. Требует wallet.
string
Часовой пояс IANA, например America/New_York, необходимый для обработки слова «сегодня».
string
по умолчанию:"mainnet"
Сеть, в которой выполняется поиск.
  • mainnet
  • devnet
array
До 8 изображений, добавляемых к последнему сообщению пользователя. Блоки image в messages не учитываются в этом ограничении.
string
обязательно
URL изображения.
string
обязательно
Всегда image.
  • image
object
Используется обозревателем Orb. Вам этот параметр не нужен.
object
Используется обозревателем Orb. Вам этот параметр не нужен.

Авторизации

X-Api-Key
string
header
обязательно

Ваш ключ Helius API.

Тело

application/json
model
enum<string>
обязательно

lana-thinking — для многоэтапного анализа с максимум 20 шагами поиска за ход; модель может передавать рассуждения в потоковом режиме. lana-fast — для быстрого поиска и отдельных фактов с максимум 4 шагами поиска за ход.

Доступные опции:
lana-thinking,
lana-fast
Пример:

"lana-thinking"

messages
object[]
обязательно

Диалог в хронологическом порядке, начиная с самого раннего сообщения. Требуется хотя бы одно сообщение, а последнее должно иметь role со значением user. API не хранит диалоги; отправляйте весь диалог с каждым запросом.

Minimum array length: 1
max_tokens
integer
по умолчанию:8192

Максимальное количество выходных токенов, которое Lana может записать за один шаг модели. Ход с поиском состоит из нескольких шагов, поэтому общее значение output_tokens за ход может быть выше. При значении меньше 2 048 модель lana-thinking не рассуждает.

Требуемый диапазон: 1 <= x <= 8192
stream
boolean
по умолчанию:false

При true события, отправляемые сервером, передаются потоком. При false после завершения хода возвращается один объект JSON.

system
string

Дополнительные инструкции, например «Ответь тремя пунктами списка». Они добавляются к собственным инструкциям Lana, а не заменяют их.

Required string length: 1 - 10000
extensions
object

Параметры только для Lana. Все они необязательны. Параметры include_* разрешают вывод; Lana решает, отправлять ли его.

Ответ

Ход выполнен. При "stream": false возвращается один объект JSON. Проверьте stop_reason: ход, завершившийся ошибкой после создания содержимого, по-прежнему возвращает 200 с stop_reason: "error" и объектом error.

При "stream": true возвращается поток событий, отправляемых сервером. Каждое событие состоит из строки event: <type> и строки data: <json>, за которыми следует пустая строка. Поток начинается с message_start и всегда заканчивается message_end или error. Могут добавляться новые типы событий и поля; игнорируйте все незнакомые значения.

Ответ без потоковой передачи. Ответом являются блоки text, объединенные по порядку.

id
string
обязательно
Пример:

"msg_3f9c..."

type
enum<string>
обязательно
Доступные опции:
message
role
enum<string>
обязательно
Доступные опции:
assistant
model
enum<string>
обязательно
Доступные опции:
lana-thinking,
lana-fast
content
object[]
обязательно
stop_reason
enum<string>
обязательно
  • end_turn: Lana завершила ответ.
  • max_tokens: ответ достиг ограничения max_tokens и может быть обрезан.
  • tool_use: ход завершился на шаге поиска, обычно из-за достижения ограничения количества шагов.
  • error: ход завершился ошибкой. Ответ неполный.
Доступные опции:
end_turn,
max_tokens,
tool_use,
error
usage
object
обязательно
ui_schema
object

Все компоненты пользовательского интерфейса в виде одного дерева. Присутствует, когда включен include_ui_schema и есть что отобразить.

documents
object[]

Присутствует, когда включен include_documents и Lana создала файлы.

follow_up
string[]

Присутствует, когда включен include_followups и Lana предложила вопросы.

sources
object[]

Присутствует, когда Lana использовала веб-страницы.

error
object