跳转到主要内容
Lana API 是一个可通过 HTTP 调用的 Solana AI 代理。你用自然英语向它提问,它会为你查询钱包、代币、交易和价格,然后以流式方式返回回答。 Lana 在 Helius 端执行所有查询,因此你无需定义或运行任何工具。付费 Helius 套餐(Developer 及以上)可使用此服务,并按请求收取固定费用:lana-thinking 为 10,000 积分,lana-fast 为 2,000 积分。请参阅定价。 该 API 的形式与 Anthropic Messages API 类似,但 Anthropic SDK 无法与它配合使用。请像下面的示例一样,通过普通 HTTP 调用它。请参阅与 Anthropic Messages API 的差异。 Lana 基于 Anthropic 的 Claude 模型运行。你的问题和对话会发送给 Anthropic 以生成回答。
Lana API 目前在 Gatekeeper(测试版)端点 beta.helius-rpc.com 上处于测试阶段。mainnet.helius-rpc.com 暂不支持。测试期间可能会添加新的事件和字段。

你可以向 Lana 询问什么

你的用户可以询问有关其交易及相关钱包的问题:
  • “为什么我上一笔交易失败了?”
  • “这次兑换的滑点是多少?”
  • “我为这笔交易支付了哪些费用?”
  • “这个钱包的资金来自哪里,又转到了哪里?”
  • “这个钱包是否与另一个钱包有关联?”
  • “这个代币的最大持有者有哪些?”
在 extensions.user_context.wallet 中传入用户的钱包,这样有关“我的”钱包或“我的上一笔交易”的问题就能正常处理。

快速入门

1

Get an API key

从 Helius Dashboard 复制一个 API 密钥。
2

Ask a question

替换 YOUR_API_KEY,然后运行:
cURL
-N 会让 curl 在每个事件到达后立即打印它。第一个事件最多可能需要 10 秒才会到达。
3

Read the answer

响应是一个事件流:
回答由按顺序排列的 text_delta 分块组成。lana-thinking 也可能发送 thinking_delta 分块:这是 Lana 的推理过程,因此请将其与回答分开显示,或将其跳过。

在代码中读取流

两个示例都会先检查 HTTP 状态,再将正文作为流读取;在 429 或 503 时等待 Retry-After;以流式方式打印回答;并在本轮失败或流提前结束时停止。

与 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 使用。

端点和身份验证

通过以下任一方式发送 Helius API 密钥: 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 在一个模型步骤中最多可写入的输出 token 数,范围为 1 到 8192。包含查询的一轮需要多个步骤,因此该轮的 output_tokens 总数可能高于 max_tokens。低于 2,048 时,lana-thinking 不会进行推理。
boolean
默认值:"false"
true 会以流式方式返回事件。false 会在本轮结束时返回一个 JSON 响应。
string
额外指令,长度为 1 到 10,000 个字符,例如“用三个要点回答”。这些指令会添加到 Lana 自身的指令中,而不是替代它们。
object
Lana 专用选项。请参阅扩展。

模型

仅当 max_tokens 为 2048 或更高时,lana-thinking 才会进行推理。

消息

每条消息都有一个 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 秒。像 httpx 中那样使用默认的 5 秒超时太短:它可能在收到第一个字节之前或两个事件之间到期。 事件按以下顺序到达:
  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}} 转换为指向具有相应 index 的 source 的链接,或将其移除。
  • ui_block 和 ui_schema 携带相同的组件。Lana 可能只发送 ui_schema,因此如果收到 ui_block 事件,则显示它们;否则渲染 ui_schema。
  • Web 搜索会发送一个包含文本 Web search completed. 或 Web fetch completed. 的 tool_result。页面以 source 事件到达。

工具错误

查询失败不会导致本轮失败。Lana 会绕过该问题,你无需重试。tool_result 包含 is_error: true,而 content 是一个 JSON,其中包含简短消息和 code:
可能会添加新代码。将未知代码视为 internal。

停止原因

stop_reason 位于 message_end 和 JSON 响应中:

用量

Lana 自身的指令和查询工具在每个模型步骤中约占用 45,000 个 token,因此即使问题很短,input_tokens 也会很高。定价按请求计算,因此 token 数不会改变你支付的费用。

非流式响应

使用 "stream": false 时,本轮结束后你会获得一个 JSON 对象:
回答由按顺序连接的 text 块组成。推理和 progress_update 仅以流式方式提供。 以下字段仅在有值时出现:

错误

流开始之前

在响应开始前失败的请求会返回非 200 状态和普通错误正文,即使使用 "stream": true 也是如此。不会发送任何事件,也不会收费。将正文作为流读取之前,请检查 HTTP 状态。 使用 "stream": true 时,响应会在 Lana 首次响应时开始,最迟不超过 10 秒。在此之前失败的轮次(例如模型过载或对话过长)也属于这种情况。 前两个 429 来自你的套餐,响应正文会说明触发了哪一个。第三个来自 Lana,并具有 JSON 正文。 如果收到没有 Retry-After 标头的 429 或 503,请等待几秒后再重试。 Lana 自身的错误(无效正文或 context_overflow 对应的 400、带 rate_limit_error 的 429、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 对应:context_overflow 对应 400,api_error 对应 500,tool_error 对应 502,timeout_error 对应 504,overloaded_error 对应 529(这是 Anthropic 用于模型过载的状态;某些 HTTP 客户端无法识别它,因此请像处理 503 一样处理)。这些请求不会收费。按照错误类型中的说明处理。

错误类型

将任何其他类型视为 api_error。

限制

当一轮接近 5 分钟时,Lana 会停止查询,并根据已有信息回答。较长的轮次通常会以说明缺失内容的部分回答结束,而不是超时。 使用流式传输时,请将 HTTP 客户端的读取超时设置为至少 30 秒。第一个字节最多可能需要 10 秒才会到达,之后每 10 秒会到达一个 ping,因此如果间隔长得多,说明连接已断开。像 httpx 中那样使用默认的 5 秒超时太短。不使用流式传输时,在本轮结束之前不会收到任何内容,因此请将读取超时设置为 5 分钟以上。 如果断开连接,Lana 会停止本轮。流已经开始的请求仍会收费。 当 Lana 已满载时,新请求会在流式传输任何内容之前收到 503。这些请求不会收费。按照 Retry-After 标头等待后重试。

定价

每个请求按固定价格收费,价格取决于模型: 流式和非流式请求的价格相同,所有付费套餐(Developer 及以上)的价格也相同。Free 套餐无法使用 Lana。 积分来自你的套餐。请参阅积分。

收费范围

无论是否使用流式传输,也无论本轮如何结束,只要请求获得 HTTP 200,就会收费。在响应开始前失败的请求会获得其他状态,且不收费。
  • 如果流式轮次以 error 事件失败,或你在其开始后断开连接,则会收费:因为状态已经是 200。
  • 在本轮开始前被拒绝的请求(400、401、403、429、503)不收费。
  • 在响应开始前失败的轮次(400、5xx),无论是否使用流式传输,均不收费。

更多示例

设置语气和用户的钱包

cURL

扫描钱包的完整历史记录

cURL

获取 UI 组件、后续问题和 CSV

cURL

后续步骤

API Reference

请求和响应架构,并提供交互式测试工具。

Rate Limits

Lana 各套餐的速率限制。

Credits

Lana 请求如何使用你的套餐积分。

Contact Support

通过 Discord、聊天或电子邮件获取帮助。