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 使用。
端点和身份验证
Authorization: Bearer 不适用于此端点,并会返回 401。
mainnet.helius-rpc.com 尚未提供此路由,并会返回 503。
在每个请求中发送 Content-Type: application/json。
请求正文
正文是一个 JSON 对象。未知字段会被拒绝并返回400,包括 extensions 和内容块中的未知字段。
lana-thinking 或 lana-fast。请参阅模型。对话,最早的消息在前。至少需要一条消息,且最后一条必须具有
role: "user"。请参阅消息。Lana 在一个模型步骤中最多可写入的输出 token 数,范围为
1 到 8192。包含查询的一轮需要多个步骤,因此该轮的 output_tokens 总数可能高于 max_tokens。低于 2,048 时,lana-thinking 不会进行推理。Lana 专用选项。请参阅扩展。
模型
仅当
max_tokens 为 2048 或更高时,lana-thinking 才会进行推理。
消息
每条消息都有一个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 秒。像 httpx 中那样使用默认的 5 秒超时太短:它可能在收到第一个字节之前或两个事件之间到期。
事件按以下顺序到达:
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}}转换为指向具有相应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:
Tool error codes
Tool error codes
可能会添加新代码。将未知代码视为
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。
积分来自你的套餐。请参阅积分。
收费范围
无论是否使用流式传输,也无论本轮如何结束,只要请求获得 HTTP200,就会收费。在响应开始前失败的请求会获得其他状态,且不收费。
- 如果流式轮次以
error事件失败,或你在其开始后断开连接,则会收费:因为状态已经是200。 - 在本轮开始前被拒绝的请求(
400、401、403、429、503)不收费。 - 在响应开始前失败的轮次(
400、5xx),无论是否使用流式传输,均不收费。
更多示例
设置语气和用户的钱包
cURL
扫描钱包的完整历史记录
cURL
获取 UI 组件、后续问题和 CSV
cURL
后续步骤
API Reference
请求和响应架构,并提供交互式测试工具。
Rate Limits
Lana 各套餐的速率限制。
Credits
Lana 请求如何使用你的套餐积分。
Contact Support
通过 Discord、聊天或电子邮件获取帮助。