Перейти к основному содержанию
Lana API — это ИИ-агент Solana, которого вы вызываете по HTTP. Вы отправляете ему вопрос на обычном английском языке, а он находит для вас сведения о кошельках, токенах, транзакциях и ценах, а затем передает ответ в потоковом режиме. Lana выполняет каждый поиск на стороне Helius, поэтому вам не нужно определять или запускать какие-либо инструменты. Сервис доступен на платных тарифах Helius (Developer и выше) по фиксированной цене за запрос: 10 000 кредитов для 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.

Конечная точка и аутентификация

Передайте ключ API Helius одним из следующих способов: Authorization: Bearer не работает на этой конечной точке и возвращает 401. mainnet.helius-rpc.com пока не обслуживает этот маршрут и возвращает 503. Отправляйте Content-Type: application/json с каждым запросом.
Ваш ключ API расходует кредиты тарифа. Вызывайте Lana со своего сервера, а не из браузера или приложения, которое вы распространяете среди пользователей.

Тело запроса

Тело представляет собой объект JSON. Неизвестные поля отклоняются с ошибкой 400, включая неизвестные поля внутри extensions и блоков содержимого.
string
обязательно
lana-thinking или lana-fast. См. раздел Модели.
object[]
обязательно
Беседа в хронологическом порядке, начиная с самого старого сообщения. Она должна содержать хотя бы одно сообщение, а последнее сообщение должно иметь role: "user". См. раздел Сообщения.
integer
по умолчанию:"8192"
Максимальное количество выходных токенов, которое Lana может записать за один шаг модели: от 1 до 8192. Ход с поиском занимает несколько шагов, поэтому общее значение output_tokens для хода может превышать max_tokens. При значении меньше 2 048 модель lana-thinking не выполняет рассуждения.
boolean
по умолчанию:"false"
true передает события в потоковом режиме. false возвращает один ответ JSON после завершения хода.
string
Дополнительные инструкции длиной от 1 до 10 000 символов, например «Ответь тремя пунктами». Они добавляются к собственным инструкциям Lana, а не заменяют их.
object
Параметры только для Lana. См. раздел Расширения.

Модели

lana-thinking выполняет рассуждения, только если max_tokens не меньше 2048.

Сообщения

Каждое сообщение содержит role (user или assistant) и content:
API не хранит беседы. Чтобы задать уточняющий вопрос, снова отправьте всю беседу, добавив новый вопрос в конец. Для ходов assistant достаточно текста ответа Lana:
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, слишком мало: тайм-аут может истечь до получения первого байта или между двумя событиями. События поступают в следующем порядке:
  1. message_start — всегда первым.
  2. Любая комбинация content_block_delta, tool_use, tool_result, source, ui_block, document, progress_update и ping.
  3. ui_schema — не более одного раза.
  4. follow_up — не более одного раза.
  5. 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:
Могут добавляться новые коды. Обрабатывайте неизвестный код как 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. Кредиты списываются с вашего тарифа. См. раздел Кредиты.

За что взимается плата

Плата взимается за каждый запрос, получивший HTTP 200, независимо от режима передачи и результата хода. Запросы, завершившиеся с ошибкой до начала ответа, получают другой статус и не тарифицируются.
  • Потоковый ход, завершившийся с событием error, или ход, от которого вы отключились после его начала, тарифицируется: статус уже был 200.
  • Запрос, отклоненный до начала хода (400, 401, 403, 429, 503), не тарифицируется.
  • Ход, завершившийся с ошибкой до начала ответа (400, 5xx), не тарифицируется независимо от режима передачи.

Другие примеры

Настройка тона и кошелька пользователя

cURL

Сканирование полной истории кошелька

cURL

Получение компонентов интерфейса, уточняющих вопросов и CSV

cURL

Дальнейшие действия

API Reference

Схема запроса и ответа с интерактивной средой.

Rate Limits

Ограничения частоты запросов Lana для каждого тарифа.

Credits

Как запросы Lana используют кредиты вашего тарифа.

Contact Support

Получите помощь через Discord, чат или электронную почту.