跳转到主要内容
POST
使用 lana-thinking 时,每个请求消耗 10,000 积分;使用 lana-fast 时,每个请求消耗 2,000 积分。 需要付费套餐。免费套餐的请求会返回 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 在一个模型步骤中最多可以生成的输出 token 数量。包含查询的轮次需要执行多个步骤,因此该轮次的 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 组件,这些组件会以 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 张图片。messages 中的 image 块不计入此限制。
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 在一个模型步骤中最多可以写入的输出 token 数。包含查询的轮次需要多个步骤,因此该轮次的 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

以单个树形结构表示的所有 UI 组件。当 include_ui_schema 已启用且有内容可显示时存在。

documents
object[]

当 include_documents 已启用且 Lana 创建了文件时存在。

follow_up
string[]

当 include_followups 已启用且 Lana 建议了问题时存在。

sources
object[]

当 Lana 使用了网页时存在。

error
object