> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear un mensaje de Lana

> Hazle una pregunta a Lana, un agente de IA de Solana, y obtén la respuesta como un flujo de eventos o una única respuesta JSON.

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](https://www.helius.dev/docs/es/lana.md).

## Parámetros de la solicitud

**model** `string` *required*

`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`

**messages** `array` *required*

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.

**messages\[].role** `string` *required*

Quién escribió el mensaje.

* `user`
* `assistant`

**messages\[].content** `any` *required*

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`.

**max\_tokens** `number` (default: 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.

**stream** `boolean` (default: false)

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

**system** `string`

Instrucciones adicionales, como "Responde con tres viñetas". Se agregan a las instrucciones propias de Lana, no se usan en su lugar.

**extensions** `object`

Opciones exclusivas de Lana. Todas son opcionales. Las opciones `include_*` permiten generar contenido de salida; Lana decide si lo envía.

**extensions.read\_only** `boolean` (default: true)

Elimina las herramientas de transferencia, intercambio y lanzamiento de tokens. Déjalo en `true`.

**extensions.output\_format** `string` (default: markdown)

`plain` indica a Lana que no use Markdown y elimina los marcadores `{{cite:N}}`. Los eventos `source` siguen llegando.

* `markdown`
* `plain`

**extensions.include\_ui\_schema** `boolean` (default: false)

Permite componentes de interfaz de usuario, como eventos `ui_block` y `ui_schema`.

**extensions.include\_followups** `boolean` (default: false)

Permite hasta 3 preguntas de seguimiento sugeridas.

**extensions.include\_documents** `boolean` (default: false)

Permite archivos CSV, JSON o de texto descargables, como eventos `document`.

**extensions.enable\_deep\_scan** `boolean` (default: 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.

**extensions.user\_context** `object`

Quién hace la pregunta.

**extensions.user\_context.wallet** `string`

La dirección del usuario, para que funcionen "mi billetera" y "mi saldo".

**extensions.user\_context.address\_kind** `string`

`wallet` o `token`: qué es `wallet`. Requiere `wallet`.

**extensions.user\_context.time\_zone** `string`

Una zona horaria de IANA, como `America/New_York`, para que funcione "hoy".

**extensions.user\_context.network** `string` (default: mainnet)

La red que se consultará.

* `mainnet`
* `devnet`

**extensions.attachments** `array`

Hasta 8 imágenes agregadas al último mensaje del usuario. Los bloques `image` de `messages` no cuentan para este límite.

**extensions.attachments\[].url** `string` *required*

La URL de la imagen.

**extensions.attachments\[].kind** `string` *required*

Siempre `image`.

* `image`

**extensions.progress\_context** `object`

Lo usa el explorador Orb. No lo necesitas.

**extensions.transaction\_filter\_context** `object`

Lo usa el explorador Orb. No lo necesitas.


## OpenAPI

````yaml es/openapi/lana/openapi.yaml POST /v1/lana/messages
openapi: 3.0.3
info:
  title: API de Lana
  description: >
    Lana es un agente de IA de Solana al que llamas mediante HTTP. Envía una
    pregunta en lenguaje natural y Lana consulta

    billeteras, tokens, transacciones y precios, y luego responde. La API tiene
    la misma estructura que la API de mensajes de Anthropic,

    pero los SDK de Anthropic no funcionan con ella.


    ## Autenticación


    Envía tu clave de API de Helius de una de estas formas:

    - Encabezado (recomendado): `X-Api-Key: YOUR_API_KEY`

    - Parámetro de consulta: `?api-key=YOUR_API_KEY`


    `Authorization: Bearer` no funciona en este endpoint y devuelve `401`.
  version: 1.0.0
  contact:
    name: Soporte de API
    url: https://helius.dev
servers:
  - url: https://beta.helius-rpc.com
    description: Gatekeeper (Beta)
security:
  - ApiKeyHeader: []
  - ApiKeyQuery: []
tags:
  - name: Mensajes
    description: Hazle una pregunta a Lana
paths:
  /v1/lana/messages:
    post:
      tags:
        - Mensajes
      summary: Crear un mensaje de Lana
      description: >
        Envía una conversación a Lana y devuelve su respuesta. Con `"stream":
        true`, la respuesta

        llega como eventos enviados por el servidor (`text/event-stream`). Con
        `"stream": false` (el valor predeterminado),

        llega como un único objeto JSON cuando termina el turno.


        Con `"stream": true`, el `200` y los primeros eventos llegan cuando Lana
        responde por primera vez o,

        como máximo, después de 10 segundos. Después, llega un evento `ping`
        cada 10 segundos. Configura

        el tiempo de espera de lectura de tu cliente HTTP en 30 segundos o más;
        el valor predeterminado de 5 segundos, como en `httpx`,

        es demasiado corto. Una solicitud que falla antes de que comience la
        respuesta recibe una respuesta de error

        normal con el estado correspondiente. Por eso, verifica el estado HTTP
        antes de leer el cuerpo como un

        flujo. Después de que comienza la respuesta, un fallo llega como un
        evento `error` final.


        Cada solicitud cuesta una tarifa fija de 10,000 créditos con
        `lana-thinking` o 2,000 créditos con

        `lana-fast`. Se cobra cada solicitud que obtiene un HTTP `200`, sin
        importar cómo termine el turno.

        Las solicitudes que fallan antes de que comience la respuesta obtienen
        otro estado y son gratuitas. Solo para

        planes de pago.
      operationId: createLanaMessage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MessagesRequest'
            examples:
              nonStreaming:
                summary: Sin streaming
                value:
                  model: lana-thinking
                  messages:
                    - role: user
                      content: ¿Cuál es el precio actual de SOL?
                  extensions:
                    read_only: true
              streaming:
                summary: Streaming
                value:
                  model: lana-thinking
                  stream: true
                  messages:
                    - role: user
                      content: >-
                        ¿Quiénes son los mayores titulares de
                        EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v?
                  extensions:
                    read_only: true
      responses:
        '200':
          description: >
            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.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
            text/event-stream:
              schema:
                $ref: '#/components/schemas/StreamEvent'
              example: >
                event: message_start

                data:
                {"type":"message_start","message":{"id":"msg_3f9c...","model":"lana-thinking"}}


                event: tool_use

                data:
                {"type":"tool_use","tool_use_id":"toolu_01...","name":"...","input":{"mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"}}


                event: tool_result

                data:
                {"type":"tool_result","tool_use_id":"toolu_01...","content":"{\"holders\":[..."}


                event: content_block_delta

                data:
                {"type":"content_block_delta","delta":{"type":"text_delta","text":"Los
                mayores titulares de USDC son"}}


                event: message_end

                data:
                {"type":"message_end","stop_reason":"end_turn","usage":{"input_tokens":91200,"output_tokens":212,"tool_calls":1,"prompt_tokens":46100,"context_window":200000}}
        '400':
          description: >
            El cuerpo no es válido, por ejemplo, por un modelo desconocido, un
            campo desconocido o un `max_tokens`

            superior a 8,192. `message` indica cada campo incorrecto. No se
            cobra.


            Gatekeeper rechaza los cuerpos de más de 10 MB con un cuerpo de
            texto sin formato `Bad Request`.


            Un turno que falla antes de que comience la respuesta porque la
            conversación no cabe

            en la ventana de contexto también devuelve `400`, con `error.type`
            igual a `context_overflow`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                type: error
                error:
                  type: invalid_request_error
                  message: 'max_tokens: max_tokens must be <= 8192'
            text/plain:
              schema:
                type: string
              example: Bad Request
        '401':
          description: >
            Falta la clave de API, no es válida o se envió como `Authorization:
            Bearer`. Cuerpo de texto sin formato. No se cobra.
          content:
            text/plain:
              schema:
                type: string
        '403':
          description: >-
            Tu plan no incluye Lana (el plan Free) o la configuración de acceso
            de tu clave la bloquea. Cuerpo de texto sin formato. No se cobra.
          content:
            text/plain:
              schema:
                type: string
        '429':
          description: >
            No se cobra. Puede ser uno de estos casos:

            - Texto sin formato `Too Many Requests`: superaste el límite de
            solicitudes de tu plan. Vuelve a intentarlo después de `Retry-After`
            (1 segundo).

            - Texto sin formato `max usage reached`: tu proyecto se quedó sin
            créditos. No hay `Retry-After`; los reintentos fallarán hasta que
            agregues créditos o mejores el plan.

            - JSON con `error.type` igual a `rate_limit_error`: tu proyecto ya
            tiene unas 3 solicitudes de Lana en ejecución. Vuelve a intentarlo
            después de `Retry-After` (5 segundos).
          headers:
            Retry-After:
              $ref: '#/components/headers/RetryAfter'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
            text/plain:
              schema:
                type: string
              example: Too Many Requests
        '500':
          description: >-
            El turno falló con `api_error` antes de que comenzara la respuesta.
            No se cobra.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: >-
            El turno falló con `tool_error` antes de que comenzara la respuesta.
            No se cobra.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: >-
            Lana alcanzó su capacidad máxima o se está reiniciando. Vuelve a
            intentarlo después de `Retry-After` (5 segundos si alcanzó su
            capacidad máxima, 30 durante el reinicio). No se cobra.
          headers:
            Retry-After:
              $ref: '#/components/headers/RetryAfter'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '504':
          description: >-
            El turno falló con `timeout_error` antes de que comenzara la
            respuesta. No se cobra.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '529':
          description: >-
            El turno falló con `overloaded_error` antes de que comenzara la
            respuesta. Algunos clientes HTTP no reconocen `529`; manéjalo como
            `503`. No se cobra.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    MessagesRequest:
      type: object
      additionalProperties: false
      required:
        - model
        - messages
      properties:
        model:
          type: string
          enum:
            - lana-thinking
            - lana-fast
          description: >-
            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.
          example: lana-thinking
        messages:
          type: array
          minItems: 1
          description: >-
            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.
          items:
            $ref: '#/components/schemas/Message'
        max_tokens:
          type: integer
          minimum: 1
          maximum: 8192
          default: 8192
          description: >-
            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.
        stream:
          type: boolean
          default: false
          description: >-
            `true` transmite eventos enviados por el servidor. `false` devuelve
            un objeto JSON cuando termina el turno.
        system:
          type: string
          minLength: 1
          maxLength: 10000
          description: >-
            Instrucciones adicionales, como "Responde en tres viñetas". Se
            agregan a las instrucciones propias de Lana, no las sustituyen.
        extensions:
          $ref: '#/components/schemas/Extensions'
    MessageResponse:
      type: object
      description: >-
        La respuesta sin streaming. La respuesta está en los bloques `text`,
        unidos en orden.
      required:
        - id
        - type
        - role
        - model
        - content
        - stop_reason
        - usage
      properties:
        id:
          type: string
          example: msg_3f9c...
        type:
          type: string
          enum:
            - message
        role:
          type: string
          enum:
            - assistant
        model:
          type: string
          enum:
            - lana-thinking
            - lana-fast
        content:
          type: array
          items:
            oneOf:
              - $ref: '#/components/schemas/TextBlock'
              - $ref: '#/components/schemas/ToolUseBlock'
              - $ref: '#/components/schemas/ToolResultBlock'
        stop_reason:
          $ref: '#/components/schemas/StopReason'
        usage:
          $ref: '#/components/schemas/Usage'
        ui_schema:
          type: object
          description: >-
            Todos los componentes de UI en un solo árbol. Está presente cuando
            `include_ui_schema` está activado y hay algo que mostrar.
        documents:
          type: array
          description: >-
            Está presente cuando `include_documents` está activado y Lana creó
            archivos.
          items:
            $ref: '#/components/schemas/Document'
        follow_up:
          type: array
          description: >-
            Está presente cuando `include_followups` está activado y Lana
            sugirió preguntas.
          items:
            type: string
        sources:
          type: array
          description: Está presente cuando Lana usó páginas web.
          items:
            $ref: '#/components/schemas/Source'
        error:
          $ref: '#/components/schemas/ErrorObject'
      example:
        id: msg_3f9c...
        type: message
        role: assistant
        model: lana-thinking
        content:
          - type: tool_use
            id: toolu_01...
            name: ...
            input:
              mint: So11111111111111111111111111111111111111112
          - type: tool_result
            tool_use_id: toolu_01...
            content: '{"price":...'
          - type: text
            text: SOL cotiza a ...
        stop_reason: end_turn
        usage:
          input_tokens: 90800
          output_tokens: 96
          tool_calls: 1
          prompt_tokens: 45600
          context_window: 200000
    StreamEvent:
      description: >
        Un evento enviado por el servidor. El `type` del JSON de `data` coincide
        con el nombre de `event`. Orden:

        1. `message_start`, siempre primero.

        2. Cualquier combinación de `content_block_delta`, `tool_use`,
        `tool_result`, `source`, `ui_block`, `document`, `progress_update` y
        `ping`.

        3. `ui_schema`, como máximo una vez.

        4. `follow_up`, como máximo una vez.

        5. `message_end` si el turno terminó, o `error` si falló. Siempre al
        final.
      oneOf:
        - $ref: '#/components/schemas/MessageStartEvent'
        - $ref: '#/components/schemas/ContentBlockDeltaEvent'
        - $ref: '#/components/schemas/ToolUseEvent'
        - $ref: '#/components/schemas/ToolResultEvent'
        - $ref: '#/components/schemas/SourceEvent'
        - $ref: '#/components/schemas/ProgressUpdateEvent'
        - $ref: '#/components/schemas/UiBlockEvent'
        - $ref: '#/components/schemas/DocumentEvent'
        - $ref: '#/components/schemas/UiSchemaEvent'
        - $ref: '#/components/schemas/FollowUpEvent'
        - $ref: '#/components/schemas/MessageEndEvent'
        - $ref: '#/components/schemas/ErrorEvent'
        - $ref: '#/components/schemas/PingEvent'
    ErrorResponse:
      type: object
      required:
        - type
        - error
      properties:
        type:
          type: string
          enum:
            - error
        error:
          $ref: '#/components/schemas/ErrorObject'
    Message:
      type: object
      additionalProperties: false
      required:
        - role
        - content
      properties:
        role:
          type: string
          enum:
            - user
            - assistant
          description: Quién escribió el mensaje.
        content:
          description: >-
            Una cadena no vacía o un arreglo no vacío de bloques de contenido.
            `text` se permite en ambos roles, `image` y `tool_result` solo en
            mensajes de `user`, y `tool_use` solo en mensajes de `assistant`.
          oneOf:
            - type: string
              minLength: 1
            - type: array
              minItems: 1
              items:
                $ref: '#/components/schemas/ContentBlock'
    Extensions:
      type: object
      additionalProperties: false
      description: >-
        Opciones exclusivas de Lana. Todas son opcionales. Las opciones
        `include_*` hacen posible la salida; Lana decide si la envía.
      properties:
        read_only:
          type: boolean
          default: true
          description: >-
            Elimina las herramientas de transferencia, intercambio y lanzamiento
            de tokens. Déjalo en `true`.
        output_format:
          type: string
          enum:
            - markdown
            - plain
          default: markdown
          description: >-
            `plain` indica a Lana que no use Markdown y elimina los marcadores
            `{{cite:N}}`. Los eventos `source` siguen llegando.
        include_ui_schema:
          type: boolean
          default: false
          description: Permite componentes de UI, como eventos `ui_block` y `ui_schema`.
        include_followups:
          type: boolean
          default: false
          description: Permite hasta 3 preguntas de seguimiento sugeridas.
        include_documents:
          type: boolean
          default: false
          description: >-
            Permite archivos CSV, JSON o de texto descargables, como eventos
            `document`.
        enable_deep_scan:
          type: boolean
          default: false
          description: >-
            Permite que Lana lea hasta 10,000 transacciones del historial de una
            dirección (50,000 para recuentos y totales), con hasta 3 análisis
            por turno. Solo en mainnet. Sin esta opción, Lana lee hasta 100
            transacciones por consulta. El mismo precio fijo.
        user_context:
          $ref: '#/components/schemas/UserContext'
        attachments:
          type: array
          maxItems: 8
          description: >-
            Hasta 8 imágenes agregadas al último mensaje del usuario. Los
            bloques `image` de `messages` no cuentan para este límite.
          items:
            $ref: '#/components/schemas/Attachment'
        progress_context:
          type: object
          description: Lo usa el explorador Orb. No lo necesitas.
        transaction_filter_context:
          type: object
          description: Lo usa el explorador Orb. No lo necesitas.
    TextBlock:
      type: object
      additionalProperties: false
      required:
        - type
        - text
      properties:
        type:
          type: string
          enum:
            - text
        text:
          type: string
          minLength: 1
    ToolUseBlock:
      type: object
      additionalProperties: false
      description: >-
        Una consulta de un turno anterior, reproducida tal como Lana la
        devolvió. Solo para mensajes de `assistant`.
      required:
        - type
        - id
        - name
        - input
      properties:
        type:
          type: string
          enum:
            - tool_use
        id:
          type: string
        name:
          type: string
        input:
          type: object
          additionalProperties: true
    ToolResultBlock:
      type: object
      additionalProperties: false
      description: El resultado de una consulta reproducida. Solo para mensajes de `user`.
      required:
        - type
        - tool_use_id
        - content
      properties:
        type:
          type: string
          enum:
            - tool_result
        tool_use_id:
          type: string
        content:
          type: string
        is_error:
          type: boolean
    StopReason:
      type: string
      enum:
        - end_turn
        - max_tokens
        - tool_use
        - error
      description: >
        - `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.
    Usage:
      type: object
      required:
        - input_tokens
        - output_tokens
        - tool_calls
        - prompt_tokens
      properties:
        input_tokens:
          type: integer
          description: Tokens de entrada de todo el turno.
        output_tokens:
          type: integer
          description: Tokens de salida de todo el turno.
        tool_calls:
          type: integer
          description: >-
            Consultas ejecutadas durante el turno, incluidas algunas que nunca
            aparecen como `tool_use`.
        prompt_tokens:
          type: integer
          description: >-
            Tokens de entrada del último paso del modelo. Úsalo para ver qué tan
            lleno está el contexto.
        context_window:
          type: integer
          description: La ventana de contexto del modelo, actualmente `200000`.
    Document:
      type: object
      required:
        - filename
        - format
        - content
      properties:
        tool_use_id:
          type: string
        filename:
          type: string
        format:
          type: string
          enum:
            - csv
            - json
            - txt
        content:
          type: string
        description:
          type: string
    Source:
      type: object
      required:
        - index
        - url
        - title
      properties:
        index:
          type: integer
          description: Coincide con los marcadores `{{cite:N}}` de la respuesta.
        url:
          type: string
        title:
          type: string
        snippet:
          type: string
    ErrorObject:
      type: object
      required:
        - type
        - message
      properties:
        type:
          type: string
          description: >
            Bifurca según este valor, no según `message`. Valores conocidos:
            `invalid_request_error`, `context_overflow`,

            `overloaded_error`, `timeout_error`, `tool_error`,
            `rate_limit_error`, `api_error`.

            Trata cualquier otro valor como `api_error`.
          example: invalid_request_error
        message:
          type: string
    MessageStartEvent:
      type: object
      title: message_start
      description: El turno comenzó.
      required:
        - type
        - message
      properties:
        type:
          type: string
          enum:
            - message_start
        message:
          type: object
          required:
            - id
            - model
          properties:
            id:
              type: string
            model:
              type: string
              enum:
                - lana-thinking
                - lana-fast
    ContentBlockDeltaEvent:
      type: object
      title: content_block_delta
      description: >-
        Un fragmento de la respuesta (`text_delta`) o del razonamiento de Lana
        (`thinking_delta`, solo con `lana-thinking`, cuando Lana razona).
        Muestra el razonamiento separado de la respuesta u omítelo.
      required:
        - type
        - delta
      properties:
        type:
          type: string
          enum:
            - content_block_delta
        delta:
          oneOf:
            - type: object
              title: text_delta
              required:
                - type
                - text
              properties:
                type:
                  type: string
                  enum:
                    - text_delta
                text:
                  type: string
            - type: object
              title: thinking_delta
              required:
                - type
                - thinking
              properties:
                type:
                  type: string
                  enum:
                    - thinking_delta
                thinking:
                  type: string
    ToolUseEvent:
      type: object
      title: tool_use
      description: >-
        Lana inició una consulta. Úsalo solo para indicadores de progreso; los
        nombres y las entradas de las herramientas pueden cambiar.
      required:
        - type
        - tool_use_id
        - name
        - input
      properties:
        type:
          type: string
          enum:
            - tool_use
        tool_use_id:
          type: string
        name:
          type: string
        input:
          type: object
          additionalProperties: true
    ToolResultEvent:
      type: object
      title: tool_result
      description: >-
        Terminó una consulta. Una consulta fallida no hace que el turno falle;
        Lana busca una alternativa.
      required:
        - type
        - tool_use_id
        - content
      properties:
        type:
          type: string
          enum:
            - tool_result
        tool_use_id:
          type: string
        content:
          type: string
          description: >-
            Una vista previa de hasta 500 caracteres. Cuando `is_error` es
            `true`, contiene JSON con un mensaje `error` y un `code`.
        is_error:
          type: boolean
    SourceEvent:
      type: object
      title: source
      description: Una página web que usó Lana.
      required:
        - type
        - index
        - url
        - title
      properties:
        type:
          type: string
          enum:
            - source
        index:
          type: integer
          description: Coincide con los marcadores `{{cite:N}}` de la respuesta.
        url:
          type: string
        title:
          type: string
        snippet:
          type: string
    ProgressUpdateEvent:
      type: object
      title: progress_update
      description: >-
        Una breve línea de estado durante un turno largo. Muéstrala separada de
        la respuesta.
      required:
        - type
        - id
        - message
        - created_at
      properties:
        type:
          type: string
          enum:
            - progress_update
        id:
          type: string
        message:
          type: string
        created_at:
          type: integer
          description: Milisegundos de Unix.
    UiBlockEvent:
      type: object
      title: ui_block
      description: Un componente de UI. Requiere `include_ui_schema`.
      required:
        - type
        - component
        - schema
      properties:
        type:
          type: string
          enum:
            - ui_block
        tool_use_id:
          type: string
        component:
          type: string
        schema:
          type: object
    DocumentEvent:
      type: object
      title: document
      description: Un archivo descargable. Requiere `include_documents`.
      required:
        - type
        - filename
        - format
        - content
      properties:
        type:
          type: string
          enum:
            - document
        tool_use_id:
          type: string
        filename:
          type: string
        format:
          type: string
          enum:
            - csv
            - json
            - txt
        content:
          type: string
        description:
          type: string
    UiSchemaEvent:
      type: object
      title: ui_schema
      description: >-
        Todos los componentes de UI en un solo árbol. Requiere
        `include_ui_schema`. Como máximo una vez.
      required:
        - type
        - schema
      properties:
        type:
          type: string
          enum:
            - ui_schema
        schema:
          type: object
    FollowUpEvent:
      type: object
      title: follow_up
      description: >-
        Preguntas sugeridas para continuar. Requiere `include_followups`. Como
        máximo una vez.
      required:
        - type
        - suggestions
      properties:
        type:
          type: string
          enum:
            - follow_up
        suggestions:
          type: array
          items:
            type: string
    MessageEndEvent:
      type: object
      title: message_end
      description: >-
        El turno terminó. Si `stop_reason` es `error`, trátalo como un
        `api_error`; cualquier texto de respuesta anterior está incompleto.
      required:
        - type
        - stop_reason
        - usage
      properties:
        type:
          type: string
          enum:
            - message_end
        stop_reason:
          $ref: '#/components/schemas/StopReason'
        usage:
          $ref: '#/components/schemas/Usage'
    ErrorEvent:
      type: object
      title: error
      description: >-
        El turno falló después de que comenzó el flujo. Cualquier texto de
        respuesta anterior está incompleto.
      required:
        - type
        - error
      properties:
        type:
          type: string
          enum:
            - error
        error:
          $ref: '#/components/schemas/ErrorObject'
    PingEvent:
      type: object
      title: ping
      description: Una señal de actividad cada 10 segundos. Ignórala.
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - ping
    ContentBlock:
      oneOf:
        - $ref: '#/components/schemas/TextBlock'
        - $ref: '#/components/schemas/ImageBlock'
        - $ref: '#/components/schemas/ToolUseBlock'
        - $ref: '#/components/schemas/ToolResultBlock'
    UserContext:
      type: object
      additionalProperties: false
      description: Quién hace la pregunta.
      properties:
        wallet:
          type: string
          minLength: 1
          maxLength: 128
          description: >-
            La dirección del usuario, para que funcionen "mi billetera" y "mi
            saldo".
        address_kind:
          type: string
          minLength: 1
          maxLength: 32
          description: '`wallet` o `token`: qué representa `wallet`. Requiere `wallet`.'
        time_zone:
          type: string
          minLength: 1
          maxLength: 64
          description: >-
            Una zona horaria de IANA, como `America/New_York`, para que funcione
            "hoy".
        network:
          type: string
          enum:
            - mainnet
            - devnet
          default: mainnet
          description: La red en la que se realizará la consulta.
    Attachment:
      type: object
      additionalProperties: false
      required:
        - url
        - kind
      properties:
        url:
          type: string
          format: uri
          description: La URL de la imagen.
        kind:
          type: string
          enum:
            - image
          description: Siempre `image`.
    ImageBlock:
      type: object
      additionalProperties: false
      description: >-
        Una imagen mediante URL. Solo para mensajes de `user`. No se admiten
        imágenes en Base64.
      required:
        - type
        - source
      properties:
        type:
          type: string
          enum:
            - image
        source:
          type: object
          additionalProperties: false
          required:
            - type
            - url
          properties:
            type:
              type: string
              enum:
                - url
            url:
              type: string
              format: uri
  headers:
    RetryAfter:
      description: Segundos que debes esperar antes de volver a intentarlo.
      schema:
        type: integer
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-Api-Key
      description: Tu clave de API de Helius.
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Tu clave de API de Helius.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.