Saltar al contenido principal
POST
Cada solicitud cuesta 10,000 créditos con lana-thinking o 2,000 créditos con lana-fast. Requiere un plan de pago. Las solicitudes del plan gratuito devuelven 403 Forbidden. Para consultar la guía de inicio rápido, los eventos de streaming y el manejo de errores, consulta la guía de la API de Lana.

Parámetros de la solicitud

string
requerido
lana-thinking para análisis de varios pasos, con hasta 20 pasos de consulta por turno; puede transmitir el razonamiento. lana-fast para consultas rápidas y datos puntuales, con hasta 4 pasos de consulta por turno.
  • lana-thinking
  • lana-fast
array
requerido
La conversación, empezando por el mensaje más antiguo. Necesita al menos un mensaje, y el último debe tener role user. La API no almacena conversaciones; envía la conversación completa en cada solicitud.
string
requerido
Quién escribió el mensaje.
  • user
  • assistant
any
requerido
Una cadena que no esté vacía o un arreglo no vacío de bloques de contenido. text se permite en ambos roles; image y tool_result solo se permiten en mensajes user; e tool_use solo se permite en mensajes assistant.
number
predeterminado:"8192"
La cantidad máxima de tokens de salida que Lana puede escribir en un paso del modelo. Un turno con consultas requiere varios pasos, por lo que el output_tokens total del turno puede ser mayor. Por debajo de 2,048, lana-thinking no razona.
boolean
predeterminado:"false"
true transmite eventos enviados por el servidor. false devuelve un único objeto JSON cuando termina el turno.
string
Instrucciones adicionales, como “Responde con tres viñetas”. Se agregan a las instrucciones propias de Lana, no se usan en su lugar.
object
Opciones exclusivas de Lana. Todas son opcionales. Las opciones include_* permiten generar contenido de salida; Lana decide si lo envía.
boolean
predeterminado:"true"
Elimina las herramientas de transferencia, intercambio y lanzamiento de tokens. Déjalo en true.
string
predeterminado:"markdown"
plain indica a Lana que no use Markdown y elimina los marcadores {{cite:N}}. Los eventos source siguen llegando.
  • markdown
  • plain
boolean
predeterminado:"false"
Permite componentes de interfaz de usuario, como eventos ui_block y ui_schema.
boolean
predeterminado:"false"
Permite hasta 3 preguntas de seguimiento sugeridas.
boolean
predeterminado:"false"
Permite archivos CSV, JSON o de texto descargables, como eventos document.
boolean
predeterminado:"false"
Permite que Lana lea hasta 10,000 transacciones del historial de una dirección (50,000 para recuentos y totales), con un máximo de 3 análisis por turno. Solo en mainnet. Sin esta opción, Lana lee hasta 100 transacciones por consulta. El mismo precio fijo.
object
Quién hace la pregunta.
string
La dirección del usuario, para que funcionen “mi billetera” y “mi saldo”.
string
wallet o token: qué es wallet. Requiere wallet.
string
Una zona horaria de IANA, como America/New_York, para que funcione “hoy”.
string
predeterminado:"mainnet"
La red que se consultará.
  • mainnet
  • devnet
array
Hasta 8 imágenes agregadas al último mensaje del usuario. Los bloques image de messages no cuentan para este límite.
string
requerido
La URL de la imagen.
string
requerido
Siempre image.
  • image
object
Lo usa el explorador Orb. No lo necesitas.
object
Lo usa el explorador Orb. No lo necesitas.

Autorizaciones

X-Api-Key
string
header
requerido

Tu clave de API de Helius.

Cuerpo

application/json
model
enum<string>
requerido

Usa lana-thinking para análisis de varios pasos, con hasta 20 pasos de consulta por turno; puede transmitir el razonamiento. Usa lana-fast para consultas rápidas y datos individuales, con hasta 4 pasos de consulta por turno.

Opciones disponibles:
lana-thinking,
lana-fast
Ejemplo:

"lana-thinking"

messages
object[]
requerido

La conversación, desde la más antigua. Necesita al menos un mensaje y el último debe tener role igual a user. La API no almacena conversaciones; envía la conversación completa en cada solicitud.

Minimum array length: 1
max_tokens
integer
predeterminado:8192

La cantidad máxima de tokens de salida que Lana puede escribir en un paso del modelo. Un turno con consultas requiere varios pasos, por lo que el total de output_tokens del turno puede ser mayor. Por debajo de 2,048, lana-thinking no razona.

Rango requerido: 1 <= x <= 8192
stream
boolean
predeterminado:false

true transmite eventos enviados por el servidor. false devuelve un objeto JSON cuando termina el turno.

system
string

Instrucciones adicionales, como "Responde en tres viñetas". Se agregan a las instrucciones propias de Lana, no las sustituyen.

Required string length: 1 - 10000
extensions
object

Opciones exclusivas de Lana. Todas son opcionales. Las opciones include_* hacen posible la salida; Lana decide si la envía.

Respuesta

El turno se ejecutó. Con "stream": false, se devuelve un objeto JSON. Verifica stop_reason: un turno que falla después de producir contenido aún devuelve 200, con stop_reason: "error" y un objeto error.

Con "stream": true, se devuelve un flujo de eventos enviados por el servidor. Cada evento es una línea event: <type> y una línea data: <json>, seguidas de una línea en blanco. El flujo comienza con message_start y siempre termina con message_end o error. Se pueden agregar nuevos tipos de eventos y campos; ignora los que no reconozcas.

La respuesta sin streaming. La respuesta está en los bloques text, unidos en orden.

id
string
requerido
Ejemplo:

"msg_3f9c..."

type
enum<string>
requerido
Opciones disponibles:
message
role
enum<string>
requerido
Opciones disponibles:
assistant
model
enum<string>
requerido
Opciones disponibles:
lana-thinking,
lana-fast
content
object[]
requerido
stop_reason
enum<string>
requerido
  • end_turn: Lana terminó su respuesta.
  • max_tokens: la respuesta alcanzó max_tokens y puede estar truncada.
  • tool_use: el turno terminó en un paso de consulta, normalmente al alcanzar el límite de pasos.
  • error: el turno falló. La respuesta está incompleta.
Opciones disponibles:
end_turn,
max_tokens,
tool_use,
error
usage
object
requerido
ui_schema
object

Todos los componentes de UI en un solo árbol. Está presente cuando include_ui_schema está activado y hay algo que mostrar.

documents
object[]

Está presente cuando include_documents está activado y Lana creó archivos.

follow_up
string[]

Está presente cuando include_followups está activado y Lana sugirió preguntas.

sources
object[]

Está presente cuando Lana usó páginas web.

error
object