Pular para o conteúdo principal
POST
Cada solicitação custa 10.000 créditos com lana-thinking ou 2.000 créditos com lana-fast. Requer um plano pago. Solicitações do plano gratuito retornam 403 Forbidden. Para ver o início rápido, os eventos de streaming e o tratamento de erros, consulte o guia da API Lana.

Parâmetros da solicitação

string
obrigatório
lana-thinking para análises em várias etapas, com até 20 etapas de consulta por interação; pode transmitir o raciocínio em streaming. lana-fast para consultas rápidas e fatos isolados, com até 4 etapas de consulta por interação.
  • lana-thinking
  • lana-fast
array
obrigatório
A conversa, da mais antiga para a mais recente. Ela precisa ter pelo menos uma mensagem, e a última deve ter role user. A API não armazena conversas; envie a conversa completa em cada solicitação.
string
obrigatório
Quem escreveu a mensagem.
  • user
  • assistant
any
obrigatório
Uma string não vazia ou um array não vazio de blocos de conteúdo. text é permitido em ambas as funções, image e tool_result somente em mensagens user, e tool_use somente em mensagens assistant.
number
padrão:"8192"
O número máximo de tokens de saída que a Lana pode gerar em uma etapa do modelo. Uma interação com consultas exige várias etapas, portanto o output_tokens total da interação pode ser maior. Abaixo de 2.048, lana-thinking não executa raciocínio.
boolean
padrão:"false"
true transmite eventos enviados pelo servidor. false retorna um único objeto JSON quando a interação termina.
string
Instruções adicionais, como “Responda em três itens.” Elas são adicionadas às instruções próprias da Lana, e não usadas no lugar delas.
object
Opções exclusivas da Lana. Todas são opcionais. As opções include_* possibilitam a saída; a Lana decide se deve enviá-la.
boolean
padrão:"true"
Remove as ferramentas de transferência, swap e lançamento de tokens. Mantenha como true.
string
padrão:"markdown"
plain instrui a Lana a não usar Markdown e remove os marcadores {{cite:N}}. Os eventos source continuam chegando.
  • markdown
  • plain
boolean
padrão:"false"
Permite componentes de interface, como eventos ui_block e ui_schema.
boolean
padrão:"false"
Permite até 3 sugestões de perguntas complementares.
boolean
padrão:"false"
Permite arquivos CSV, JSON ou de texto para download, como eventos document.
boolean
padrão:"false"
Permite que a Lana leia até 10.000 transações do histórico de um endereço (50.000 para contagens e totais), com até 3 varreduras por interação. Somente na mainnet. Sem essa opção, a Lana lê até 100 transações por consulta. O mesmo preço fixo se aplica.
object
Quem está perguntando.
string
O endereço do usuário, para que “minha carteira” e “meu saldo” funcionem.
string
wallet ou token: o que é wallet. Requer wallet.
string
Um fuso horário da IANA, como America/New_York, para que “hoje” funcione.
string
padrão:"mainnet"
A rede a ser consultada.
  • mainnet
  • devnet
array
Até 8 imagens adicionadas à última mensagem do usuário. Os blocos image em messages não contam para esse limite.
string
obrigatório
A URL da imagem.
string
obrigatório
Sempre image.
  • image
object
Usado pelo explorador Orb. Você não precisa disso.
object
Usado pelo explorador Orb. Você não precisa disso.

Autorizações

X-Api-Key
string
header
obrigatório

Sua chave de API da Helius.

Corpo

application/json
model
enum<string>
obrigatório

Use lana-thinking para análises de várias etapas, com até 20 etapas de consulta por turno; ele pode transmitir o raciocínio por streaming. Use lana-fast para consultas rápidas e fatos isolados, com até 4 etapas de consulta por turno.

Opções disponíveis:
lana-thinking,
lana-fast
Exemplo:

"lana-thinking"

messages
object[]
obrigatório

A conversa, da mais antiga para a mais recente. Ela precisa ter pelo menos uma mensagem, e a última deve ter role igual a user. A API não armazena conversas; envie a conversa inteira em cada solicitação.

Minimum array length: 1
max_tokens
integer
padrão:8192

O número máximo de tokens de saída que Lana pode escrever em uma etapa do modelo. Um turno com consultas leva várias etapas, portanto o total de output_tokens do turno pode ser maior. Abaixo de 2.048, lana-thinking não raciocina.

Intervalo obrigatório: 1 <= x <= 8192
stream
boolean
padrão:false

true transmite eventos enviados pelo servidor. false retorna um objeto JSON quando o turno termina.

system
string

Instruções adicionais, como "Responda em três itens." Elas são adicionadas às próprias instruções da Lana, sem substituí-las.

Required string length: 1 - 10000
extensions
object

Opções exclusivas da Lana. Todas são opcionais. As opções include_* possibilitam a saída; Lana decide se deve enviá-la.

Resposta

O turno foi executado. Com "stream": false, um objeto JSON. Verifique stop_reason: um turno que falha após produzir conteúdo ainda retorna 200, com stop_reason: "error" e um objeto error.

Com "stream": true, um stream de eventos enviados pelo servidor. Cada evento é uma linha event: <type> e uma linha data: <json>, seguidas por uma linha em branco. O stream começa com message_start e sempre termina com message_end ou error. Novos tipos de evento e campos podem ser adicionados; ignore os que você não reconhecer.

A resposta sem streaming. A resposta é formada pelos blocos text, unidos na ordem.

id
string
obrigatório
Exemplo:

"msg_3f9c..."

type
enum<string>
obrigatório
Opções disponíveis:
message
role
enum<string>
obrigatório
Opções disponíveis:
assistant
model
enum<string>
obrigatório
Opções disponíveis:
lana-thinking,
lana-fast
content
object[]
obrigatório
stop_reason
enum<string>
obrigatório
  • end_turn: Lana concluiu a resposta.
  • max_tokens: a resposta atingiu max_tokens e pode ter sido cortada.
  • tool_use: o turno terminou em uma etapa de consulta, geralmente no limite de etapas.
  • error: o turno falhou. A resposta está incompleta.
Opções disponíveis:
end_turn,
max_tokens,
tool_use,
error
usage
object
obrigatório
ui_schema
object

Todos os componentes de UI como uma única árvore. Presente quando include_ui_schema está ativado e há algo para mostrar.

documents
object[]

Presente quando include_documents está ativado e Lana criou arquivos.

follow_up
string[]

Presente quando include_followups está ativado e Lana sugeriu perguntas.

sources
object[]

Presente quando Lana usou páginas da web.

error
object