lana-thinking и 2 000 кредитов для lana-fast. См. раздел Цены.
API устроен аналогично Anthropic Messages API, но SDK Anthropic с ним не работают. Вызывайте его напрямую по HTTP, как в примерах ниже. См. раздел Отличия от Anthropic Messages API.
Lana работает на моделях Claude от Anthropic. Ваши вопросы и беседа отправляются в Anthropic для генерации ответов.
Lana API находится на стадии бета-тестирования на конечной точке Gatekeeper (Beta),
beta.helius-rpc.com. На mainnet.helius-rpc.com он пока недоступен. Во время бета-тестирования могут добавляться новые события и поля.О чем можно спрашивать Lana
Вопросы, которые ваши пользователи могут задавать о своих сделках и кошельках, с которыми они взаимодействуют:- «Почему моя последняя транзакция завершилась с ошибкой?»
- «Какое проскальзывание произошло при этом обмене?»
- «Какие комиссии я заплатил за эту транзакцию?»
- «Откуда этот кошелек получил средства и куда их отправил?»
- «Связан ли этот кошелек с другим кошельком?»
- «Кто является крупнейшими держателями этого токена?»
extensions.user_context.wallet, чтобы работали вопросы о «моем» кошельке или «моей последней транзакции».
Краткое руководство
1
Get an API key
Скопируйте ключ API из панели управления Helius.
2
Ask a question
Замените
YOUR_API_KEY и выполните:cURL
-N заставляет curl выводить каждое событие сразу после его получения. Первое событие может поступить через 10 секунд.3
Read the answer
Ответ представляет собой поток событий:Ответ состоит из фрагментов
text_delta в порядке их поступления. lana-thinking также может отправлять фрагменты thinking_delta: это рассуждения Lana, поэтому показывайте их отдельно от ответа или пропускайте.Чтение потока в коде
Оба примера проверяют статус HTTP перед чтением тела в виде потока, ожидаютRetry-After при 429 или 503, выводят ответ по мере его поступления и останавливаются, если ход завершается с ошибкой или поток обрывается преждевременно.
Отличия от Anthropic Messages API
- Доступны модели
lana-thinkingиlana-fast. - Lana запускает собственные инструменты.
tools,tool_choice,temperature,top_p,top_k,stop_sequencesиmetadataвозвращают400. systemдобавляется к инструкциям Lana.max_tokensнеобязателен (значение по умолчанию и максимум — 8 192), а изображения должны быть представлены URL-адресами.- События отличаются. Отсутствуют
content_block_start,content_block_stop,message_deltaиmessage_stop. Поток завершается событиемmessage_endилиerror. usageдобавляетtool_calls,prompt_tokensиcontext_window.stop_reasonможет иметь значениеerror.extensionsиспользуется только в Lana.
Конечная точка и аутентификация
Authorization: Bearer не работает на этой конечной точке и возвращает 401.
mainnet.helius-rpc.com пока не обслуживает этот маршрут и возвращает 503.
Отправляйте Content-Type: application/json с каждым запросом.
Тело запроса
Тело представляет собой объект JSON. Неизвестные поля отклоняются с ошибкой400, включая неизвестные поля внутри extensions и блоков содержимого.
lana-thinking или lana-fast. См. раздел Модели.Беседа в хронологическом порядке, начиная с самого старого сообщения. Она должна содержать хотя бы одно сообщение, а последнее сообщение должно иметь
role: "user". См. раздел Сообщения.Максимальное количество выходных токенов, которое Lana может записать за один шаг модели: от
1 до 8192. Ход с поиском занимает несколько шагов, поэтому общее значение output_tokens для хода может превышать max_tokens. При значении меньше 2 048 модель lana-thinking не выполняет рассуждения.true передает события в потоковом режиме. false возвращает один ответ JSON после завершения хода.Дополнительные инструкции длиной от 1 до 10 000 символов, например «Ответь тремя пунктами». Они добавляются к собственным инструкциям Lana, а не заменяют их.
Параметры только для Lana. См. раздел Расширения.
Модели
lana-thinking выполняет рассуждения, только если max_tokens не меньше 2048.
Сообщения
Каждое сообщение содержитrole (user или assistant) и content:
assistant достаточно текста ответа Lana:
extensions.user_context.wallet.
content — это непустая строка или непустой массив блоков:
Изображения должны быть представлены URL-адресами. Изображения в формате Base64 не поддерживаются.
Блоки
tool_use и tool_result не обязательны. Они позволяют воспроизводить результаты поиска из предыдущего хода в том виде, в котором их вернула Lana, чтобы Lana могла использовать их повторно. tool_result также принимает необязательное логическое значение is_error.
Расширения
Все расширения необязательны.
Параметры
include_* делают вывод возможным. Lana сама решает, отправлять ли его.
extensions также принимает progress_context и transaction_filter_context. Они используются обозревателем Orb, и вам они не нужны.
Поля user_context:
Потоковые события
При использовании"stream": true вы получаете статус 200 и Content-Type: text/event-stream. Каждое событие выглядит так:
data — это одна строка JSON. Ее type соответствует имени event.
Статус 200 и первые события поступают, когда Lana впервые отвечает (рассуждением, текстом ответа, поиском или файлом), но не позднее чем через 10 секунд. До этого ничего не отправляется, поэтому запрос, завершившийся с ошибкой в этом интервале, получает обычный ответ с ошибкой и не тарифицируется. После этого, пока Lana работает, каждые 10 секунд поступает ping.
Установите тайм-аут чтения HTTP-клиента не менее 30 секунд. Значение по умолчанию 5 секунд, как в httpx, слишком мало: тайм-аут может истечь до получения первого байта или между двумя событиями.
События поступают в следующем порядке:
message_start— всегда первым.- Любая комбинация
content_block_delta,tool_use,tool_result,source,ui_block,document,progress_updateиping. ui_schema— не более одного раза.follow_up— не более одного раза.message_end, если ход завершен, илиerror, если он завершился с ошибкой. Это всегда последнее событие.
Советы по отображению потока:
- Используйте
tool_useтолько для индикаторов выполнения. Имена инструментов и входные данные могут изменяться. - При выводе
"markdown"преобразуйте каждый{{cite:N}}в ссылку наsourceс соответствующимindexили удалите его. ui_blockиui_schemaсодержат одни и те же компоненты. Lana может отправить толькоui_schema, поэтому отображайте событияui_block, если они поступают, а в противном случае визуализируйтеui_schema.- При поиске в интернете отправляется
tool_resultс текстомWeb search completed.илиWeb fetch completed.. Страницы поступают в виде событийsource.
Ошибки инструментов
Ошибка поиска не приводит к ошибке всего хода. Lana обходит ее, и повторять запрос не нужно.tool_result содержит is_error: true, а content представляет собой JSON с коротким сообщением и code:
Tool error codes
Tool error codes
Могут добавляться новые коды. Обрабатывайте неизвестный код как
internal.Причины остановки
stop_reason присутствует в message_end и в ответе JSON:
Использование
Собственные инструкции и инструменты поиска Lana занимают около 45 000 токенов на каждом шаге модели, поэтому
input_tokens имеет большое значение даже для короткого вопроса. Цена устанавливается за запрос, поэтому количество токенов не влияет на стоимость.
Непотоковый ответ
При использовании"stream": false после завершения хода вы получаете один объект JSON:
text, объединенных по порядку. Рассуждения и progress_update доступны только в потоковом режиме.
Следующие поля присутствуют, только если у них есть значение:
Ошибки
До начала потока
Запрос, который завершается с ошибкой до начала ответа, возвращает статус, отличный от200, с обычным телом ошибки даже при использовании "stream": true. События не отправляются, а плата не взимается. Проверяйте статус HTTP перед чтением тела в виде потока.
При использовании "stream": true ответ начинается, когда Lana впервые отвечает, но не позднее чем через 10 секунд. Ход, завершившийся с ошибкой до этого момента, например из-за перегрузки модели или слишком длинной беседы, также обрабатывается здесь.
Первые два ответа
429 связаны с вашим тарифом, и в теле ответа указано, какое ограничение было достигнуто. Третий поступает от Lana и имеет тело JSON.
Если 429 или 503 поступает без заголовка Retry-After, подождите несколько секунд перед повторной попыткой.
Собственные ошибки Lana (400 для недопустимого тела или context_overflow, 429 с rate_limit_error, 500, 502, 503, 504 и 529) имеют тело JSON. Ошибки Gatekeeper (401, 403, 400 из-за слишком большого тела и связанные с тарифом ответы 429) представляют собой обычный текст. Выбирайте ветвь обработки по error.type, а не по message:
После начала потока
Статус уже равен200, поэтому при ошибке поток завершается финальным событием error либо событием message_end с stop_reason: "error". В таком message_end нет объекта error; обрабатывайте его как api_error. Любой текст ответа перед ним является неполным. Покажите его как неполный или отбросьте.
Без потоковой передачи
При использовании"stream": false неудачный ход возвращает один из следующих результатов:
200сstop_reason: "error"и объектомerror, если во время хода было создано какое-либо содержимое, включая результаты поиска. Всегда проверяйтеstop_reason.- Тело ошибки JSON, если ход ничего не создал. Статус соответствует
error.type:400дляcontext_overflow,500дляapi_error,502дляtool_error,504дляtimeout_errorили529дляoverloaded_error(статус, который Anthropic использует для перегруженной модели; некоторые HTTP-клиенты его не распознают, поэтому обрабатывайте его как503). Такие запросы не тарифицируются. Обрабатывайте их, как описано в разделе Типы ошибок.
Типы ошибок
Обрабатывайте любой другой тип как
api_error.
Ограничения
Когда ход приближается к 5 минутам, Lana прекращает поиск и отвечает на основе уже полученных данных. Длительные ходы обычно заканчиваются частичным ответом с указанием недостающих сведений, а не ошибкой тайм-аута.
При потоковой передаче установите тайм-аут чтения HTTP-клиента не менее 30 секунд. Первый байт может поступить через 10 секунд, после чего
ping поступает каждые 10 секунд, поэтому значительно более длительный интервал означает разрыв соединения. Значение по умолчанию 5 секунд, как в httpx, слишком мало. Без потоковой передачи данные не поступают до завершения хода, поэтому установите тайм-аут чтения больше 5 минут.
Если вы разорвете соединение, Lana остановит ход. Если поток запроса уже начался, плата все равно взимается.
Когда Lana работает на пределе мощности, новые запросы получают 503 до начала потоковой передачи. Они не тарифицируются. Повторите запрос по истечении времени из заголовка Retry-After.
Цены
Каждый запрос оплачивается по фиксированной цене, которая зависит от модели:
Цена одинакова для потоковых и непотоковых запросов и для всех платных тарифов (Developer и выше). Lana недоступна на тарифе Free.
Кредиты списываются с вашего тарифа. См. раздел Кредиты.
За что взимается плата
Плата взимается за каждый запрос, получивший HTTP200, независимо от режима передачи и результата хода. Запросы, завершившиеся с ошибкой до начала ответа, получают другой статус и не тарифицируются.
- Потоковый ход, завершившийся с событием
error, или ход, от которого вы отключились после его начала, тарифицируется: статус уже был200. - Запрос, отклоненный до начала хода (
400,401,403,429,503), не тарифицируется. - Ход, завершившийся с ошибкой до начала ответа (
400,5xx), не тарифицируется независимо от режима передачи.
Другие примеры
Настройка тона и кошелька пользователя
cURL
Сканирование полной истории кошелька
cURL
Получение компонентов интерфейса, уточняющих вопросов и CSV
cURL
Дальнейшие действия
API Reference
Схема запроса и ответа с интерактивной средой.
Rate Limits
Ограничения частоты запросов Lana для каждого тарифа.
Credits
Как запросы Lana используют кредиты вашего тарифа.
Contact Support
Получите помощь через Discord, чат или электронную почту.