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

# Criar uma mensagem da Lana

> Faça uma pergunta à Lana, uma agente de IA da Solana, e receba a resposta como um fluxo de eventos ou uma única resposta JSON.

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

## Parâmetros da solicitação

**model** `string` *required*

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

**messages** `array` *required*

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.

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

Quem escreveu a mensagem.

* `user`
* `assistant`

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

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

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

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

`true` transmite eventos enviados pelo servidor. `false` retorna um único objeto JSON quando a interação termina.

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

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

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

Remove as ferramentas de transferência, swap e lançamento de tokens. Mantenha como `true`.

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

`plain` instrui a Lana a não usar Markdown e remove os marcadores `{{cite:N}}`. Os eventos `source` continuam chegando.

* `markdown`
* `plain`

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

Permite componentes de interface, como eventos `ui_block` e `ui_schema`.

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

Permite até 3 sugestões de perguntas complementares.

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

Permite arquivos CSV, JSON ou de texto para download, como eventos `document`.

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

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

Quem está perguntando.

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

O endereço do usuário, para que "minha carteira" e "meu saldo" funcionem.

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

`wallet` ou `token`: o que é `wallet`. Requer `wallet`.

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

Um fuso horário da IANA, como `America/New_York`, para que "hoje" funcione.

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

A rede a ser consultada.

* `mainnet`
* `devnet`

**extensions.attachments** `array`

Até 8 imagens adicionadas à última mensagem do usuário. Os blocos `image` em `messages` não contam para esse limite.

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

A URL da imagem.

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

Sempre `image`.

* `image`

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

Usado pelo explorador Orb. Você não precisa disso.

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

Usado pelo explorador Orb. Você não precisa disso.


## OpenAPI

````yaml pt-BR/openapi/lana/openapi.yaml POST /v1/lana/messages
openapi: 3.0.3
info:
  title: API Lana
  description: >
    Lana é um agente de IA da Solana que você chama por HTTP. Envie uma pergunta
    em inglês simples, e Lana consulta

    carteiras, tokens, transações e preços e, em seguida, responde. A API tem o
    formato da API Messages da Anthropic,

    mas os SDKs da Anthropic não funcionam com ela.


    ## Autenticação


    Envie sua chave de API da Helius de uma destas formas:

    - Cabeçalho (recomendado): `X-Api-Key: YOUR_API_KEY`

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


    `Authorization: Bearer` não funciona neste endpoint e retorna `401`.
  version: 1.0.0
  contact:
    name: Suporte da API
    url: https://helius.dev
servers:
  - url: https://beta.helius-rpc.com
    description: Gatekeeper (Beta)
security:
  - ApiKeyHeader: []
  - ApiKeyQuery: []
tags:
  - name: Mensagens
    description: Faça uma pergunta à Lana
paths:
  /v1/lana/messages:
    post:
      tags:
        - Mensagens
      summary: Criar uma mensagem da Lana
      description: >
        Envia uma conversa para Lana e retorna a resposta dela. Com `"stream":
        true`, a resposta

        chega como eventos enviados pelo servidor (`text/event-stream`). Com
        `"stream": false` (o padrão),

        ela chega como um objeto JSON quando o turno termina.


        Com `"stream": true`, o `200` e os primeiros eventos chegam quando Lana
        responde pela primeira vez ou,

        no máximo, após 10 segundos, e um evento `ping` chega a cada 10 segundos
        depois disso. Defina

        o tempo limite de leitura do seu cliente HTTP como 30 segundos ou mais;
        o padrão de 5 segundos, como no `httpx`,

        é curto demais. Uma solicitação que falha antes do início da resposta
        recebe uma resposta de erro

        normal com o status correspondente. Portanto, verifique o status HTTP
        antes de ler o corpo como um

        stream. Depois que a resposta começa, uma falha chega como um evento
        `error` final.


        Cada solicitação custa 10.000 créditos fixos com `lana-thinking` ou
        2.000 créditos com

        `lana-fast`. Toda solicitação que recebe HTTP `200` é cobrada,
        independentemente de como o turno termina.

        Solicitações que falham antes do início da resposta recebem outro status
        e são gratuitas. Somente

        planos pagos.
      operationId: createLanaMessage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MessagesRequest'
            examples:
              nonStreaming:
                summary: Sem streaming
                value:
                  model: lana-thinking
                  messages:
                    - role: user
                      content: Qual é o preço atual de SOL?
                  extensions:
                    read_only: true
              streaming:
                summary: Streaming
                value:
                  model: lana-thinking
                  stream: true
                  messages:
                    - role: user
                      content: >-
                        Quem são os maiores detentores de
                        EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v?
                  extensions:
                    read_only: true
      responses:
        '200':
          description: >
            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.
          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":"Os
                maiores detentores de USDC são"}}


                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: >
            O corpo é inválido, por exemplo, por conter um modelo desconhecido,
            um campo desconhecido ou um `max_tokens`

            acima de 8.192. `message` identifica cada campo incorreto. Não há
            cobrança.


            Um corpo acima de 10 MB é rejeitado pelo Gatekeeper com um corpo
            `Bad Request` em texto simples.


            Um turno que falha antes do início da resposta porque a conversa não
            cabe

            na janela de contexto também retorna `400`, com `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 deve ser <= 8192'
            text/plain:
              schema:
                type: string
              example: Bad Request
        '401':
          description: >
            A chave de API está ausente ou é inválida, ou foi enviada como
            `Authorization: Bearer`. Corpo em texto simples. Não há cobrança.
          content:
            text/plain:
              schema:
                type: string
        '403':
          description: >-
            Seu plano não inclui Lana (o plano Free) ou as configurações de
            acesso da sua chave a bloqueiam. Corpo em texto simples. Não há
            cobrança.
          content:
            text/plain:
              schema:
                type: string
        '429':
          description: >
            Não há cobrança. Uma das seguintes situações:

            - `Too Many Requests` em texto simples: você excedeu o limite de
            taxa do seu plano. Tente novamente após `Retry-After` (1 segundo).

            - `max usage reached` em texto simples: seu projeto ficou sem
            créditos. Sem `Retry-After`; novas tentativas falharão até você
            adicionar créditos ou fazer upgrade.

            - JSON com `error.type` igual a `rate_limit_error`: seu projeto já
            tem cerca de 3 solicitações da Lana em execução. Tente novamente
            após `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: >-
            O turno falhou com `api_error` antes do início da resposta. Não há
            cobrança.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: >-
            O turno falhou com `tool_error` antes do início da resposta. Não há
            cobrança.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: >-
            Lana atingiu a capacidade máxima ou está reiniciando. Tente
            novamente após `Retry-After` (5 segundos quando estiver na
            capacidade máxima, 30 durante a reinicialização). Não há cobrança.
          headers:
            Retry-After:
              $ref: '#/components/headers/RetryAfter'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '504':
          description: >-
            O turno falhou com `timeout_error` antes do início da resposta. Não
            há cobrança.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '529':
          description: >-
            O turno falhou com `overloaded_error` antes do início da resposta.
            Alguns clientes HTTP não reconhecem `529`; trate-o como `503`. Não
            há cobrança.
          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: >-
            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.
          example: lana-thinking
        messages:
          type: array
          minItems: 1
          description: >-
            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.
          items:
            $ref: '#/components/schemas/Message'
        max_tokens:
          type: integer
          minimum: 1
          maximum: 8192
          default: 8192
          description: >-
            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.
        stream:
          type: boolean
          default: false
          description: >-
            `true` transmite eventos enviados pelo servidor. `false` retorna um
            objeto JSON quando o turno termina.
        system:
          type: string
          minLength: 1
          maxLength: 10000
          description: >-
            Instruções adicionais, como "Responda em três itens." Elas são
            adicionadas às próprias instruções da Lana, sem substituí-las.
        extensions:
          $ref: '#/components/schemas/Extensions'
    MessageResponse:
      type: object
      description: >-
        A resposta sem streaming. A resposta é formada pelos blocos `text`,
        unidos na ordem.
      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 os componentes de UI como uma única árvore. Presente quando
            `include_ui_schema` está ativado e há algo para mostrar.
        documents:
          type: array
          description: >-
            Presente quando `include_documents` está ativado e Lana criou
            arquivos.
          items:
            $ref: '#/components/schemas/Document'
        follow_up:
          type: array
          description: >-
            Presente quando `include_followups` está ativado e Lana sugeriu
            perguntas.
          items:
            type: string
        sources:
          type: array
          description: Presente quando Lana usou páginas da 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 está sendo negociado a ...
        stop_reason: end_turn
        usage:
          input_tokens: 90800
          output_tokens: 96
          tool_calls: 1
          prompt_tokens: 45600
          context_window: 200000
    StreamEvent:
      description: >
        Um evento enviado pelo servidor. O `type` do JSON em `data` corresponde
        ao nome de `event`. Ordem:

        1. `message_start`, sempre primeiro.

        2. Qualquer combinação de `content_block_delta`, `tool_use`,
        `tool_result`, `source`, `ui_block`, `document`, `progress_update` e
        `ping`.

        3. `ui_schema`, no máximo uma vez.

        4. `follow_up`, no máximo uma vez.

        5. `message_end` se o turno terminou, ou `error` se ele falhou. Sempre
        por último.
      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: Quem escreveu a mensagem.
        content:
          description: >-
            Uma string não vazia ou um array não vazio de blocos de conteúdo.
            `text` é permitido nas duas funções, `image` e `tool_result` somente
            em mensagens de `user`, e `tool_use` somente em mensagens de
            `assistant`.
          oneOf:
            - type: string
              minLength: 1
            - type: array
              minItems: 1
              items:
                $ref: '#/components/schemas/ContentBlock'
    Extensions:
      type: object
      additionalProperties: false
      description: >-
        Opções exclusivas da Lana. Todas são opcionais. As opções `include_*`
        possibilitam a saída; Lana decide se deve enviá-la.
      properties:
        read_only:
          type: boolean
          default: true
          description: >-
            Remove as ferramentas de transferência, swap e lançamento de token.
            Mantenha como `true`.
        output_format:
          type: string
          enum:
            - markdown
            - plain
          default: markdown
          description: >-
            `plain` instrui Lana a não usar Markdown e remove os marcadores
            `{{cite:N}}`. Os eventos `source` ainda chegam.
        include_ui_schema:
          type: boolean
          default: false
          description: Permite componentes de UI, como eventos `ui_block` e `ui_schema`.
        include_followups:
          type: boolean
          default: false
          description: Permite até 3 perguntas de acompanhamento sugeridas.
        include_documents:
          type: boolean
          default: false
          description: >-
            Permite arquivos CSV, JSON ou de texto para download, como eventos
            `document`.
        enable_deep_scan:
          type: boolean
          default: false
          description: >-
            Permite que 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
            turno. Somente na mainnet. Sem essa opção, Lana lê até 100
            transações por consulta. O mesmo preço fixo.
        user_context:
          $ref: '#/components/schemas/UserContext'
        attachments:
          type: array
          maxItems: 8
          description: >-
            Até 8 imagens adicionadas à última mensagem do usuário. Blocos
            `image` em `messages` não contam para esse limite.
          items:
            $ref: '#/components/schemas/Attachment'
        progress_context:
          type: object
          description: Usado pelo explorador Orb. Você não precisa disso.
        transaction_filter_context:
          type: object
          description: Usado pelo explorador Orb. Você não precisa disso.
    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: >-
        Uma consulta de um turno anterior, reproduzida como Lana a retornou.
        Somente mensagens 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: O resultado de uma consulta reproduzida. Somente mensagens 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 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.
    Usage:
      type: object
      required:
        - input_tokens
        - output_tokens
        - tool_calls
        - prompt_tokens
      properties:
        input_tokens:
          type: integer
          description: Tokens de entrada do turno inteiro.
        output_tokens:
          type: integer
          description: Tokens de saída do turno inteiro.
        tool_calls:
          type: integer
          description: >-
            Consultas executadas no turno, incluindo algumas que nunca aparecem
            como `tool_use`.
        prompt_tokens:
          type: integer
          description: >-
            Tokens de entrada na última etapa do modelo. Use esse valor para ver
            o nível de ocupação do contexto.
        context_window:
          type: integer
          description: A janela de contexto do modelo, atualmente `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: Corresponde aos marcadores `{{cite:N}}` na resposta.
        url:
          type: string
        title:
          type: string
        snippet:
          type: string
    ErrorObject:
      type: object
      required:
        - type
        - message
      properties:
        type:
          type: string
          description: >
            Crie a ramificação com base neste campo, não em `message`. Valores
            conhecidos: `invalid_request_error`, `context_overflow`,

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

            Trate qualquer outro valor como `api_error`.
          example: invalid_request_error
        message:
          type: string
    MessageStartEvent:
      type: object
      title: message_start
      description: O turno começou.
      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: >-
        Um trecho da resposta (`text_delta`) ou do raciocínio da Lana
        (`thinking_delta`, somente `lana-thinking`, quando Lana raciocina).
        Mostre o raciocínio separado da resposta ou ignore-o.
      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 iniciou uma consulta. Use-a somente para indicadores de progresso;
        os nomes e as entradas das ferramentas podem mudar.
      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: >-
        Uma consulta foi concluída. Uma consulta com falha não faz o turno
        falhar; Lana contorna o problema.
      required:
        - type
        - tool_use_id
        - content
      properties:
        type:
          type: string
          enum:
            - tool_result
        tool_use_id:
          type: string
        content:
          type: string
          description: >-
            Uma prévia de até 500 caracteres. Quando `is_error` é `true`, um
            JSON com uma mensagem `error` e um `code`.
        is_error:
          type: boolean
    SourceEvent:
      type: object
      title: source
      description: Uma página da web usada pela Lana.
      required:
        - type
        - index
        - url
        - title
      properties:
        type:
          type: string
          enum:
            - source
        index:
          type: integer
          description: Corresponde aos marcadores `{{cite:N}}` na resposta.
        url:
          type: string
        title:
          type: string
        snippet:
          type: string
    ProgressUpdateEvent:
      type: object
      title: progress_update
      description: >-
        Uma linha curta de status durante um turno longo. Mostre-a separada da
        resposta.
      required:
        - type
        - id
        - message
        - created_at
      properties:
        type:
          type: string
          enum:
            - progress_update
        id:
          type: string
        message:
          type: string
        created_at:
          type: integer
          description: Milissegundos Unix.
    UiBlockEvent:
      type: object
      title: ui_block
      description: Um componente de UI. Requer `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: Um arquivo para download. Requer `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 os componentes de UI como uma única árvore. Requer
        `include_ui_schema`. No máximo uma vez.
      required:
        - type
        - schema
      properties:
        type:
          type: string
          enum:
            - ui_schema
        schema:
          type: object
    FollowUpEvent:
      type: object
      title: follow_up
      description: >-
        Próximas perguntas sugeridas. Requer `include_followups`. No máximo uma
        vez.
      required:
        - type
        - suggestions
      properties:
        type:
          type: string
          enum:
            - follow_up
        suggestions:
          type: array
          items:
            type: string
    MessageEndEvent:
      type: object
      title: message_end
      description: >-
        O turno terminou. Com `stop_reason` igual a `error`, trate-o como um
        `api_error`; qualquer texto de resposta anterior é parcial.
      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: >-
        O turno falhou após o início do stream. Qualquer texto de resposta
        anterior é parcial.
      required:
        - type
        - error
      properties:
        type:
          type: string
          enum:
            - error
        error:
          $ref: '#/components/schemas/ErrorObject'
    PingEvent:
      type: object
      title: ping
      description: Um sinal de atividade a cada 10 segundos. Ignore-o.
      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: Quem está perguntando.
      properties:
        wallet:
          type: string
          minLength: 1
          maxLength: 128
          description: >-
            O endereço do usuário, para que "minha carteira" e "meu saldo"
            funcionem.
        address_kind:
          type: string
          minLength: 1
          maxLength: 32
          description: '`wallet` ou `token`: o que `wallet` representa. Requer `wallet`.'
        time_zone:
          type: string
          minLength: 1
          maxLength: 64
          description: >-
            Um fuso horário da IANA, como `America/New_York`, para que "hoje"
            funcione.
        network:
          type: string
          enum:
            - mainnet
            - devnet
          default: mainnet
          description: A rede a ser consultada.
    Attachment:
      type: object
      additionalProperties: false
      required:
        - url
        - kind
      properties:
        url:
          type: string
          format: uri
          description: A URL da imagem.
        kind:
          type: string
          enum:
            - image
          description: Sempre `image`.
    ImageBlock:
      type: object
      additionalProperties: false
      description: >-
        Uma imagem por URL. Somente mensagens de `user`. Imagens em Base64 não
        são compatíveis.
      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 de espera antes de tentar novamente.
      schema:
        type: integer
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-Api-Key
      description: Sua chave de API da Helius.
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Sua chave de API da Helius.

````

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