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

# Eine Lana-Nachricht erstellen

> Stelle Lana, einem Solana-KI-Agenten, eine Frage und erhalte die Antwort als Event-stream oder als einzelne JSON-response.

Jeder request kostet **10.000 Credits** mit `lana-thinking` oder **2.000 Credits** mit `lana-fast`.

Erfordert einen kostenpflichtigen Tarif. Requests im kostenlosen Tarif geben `403 Forbidden` zurück.

Den Schnellstart, Streaming-Events und Informationen zur Fehlerbehandlung findest du im [Lana API-Leitfaden](https://www.helius.dev/docs/de/lana.md).

## Request-Parameter

**model** `string` *required*

`lana-thinking` für mehrstufige Analysen mit bis zu 20 Nachschlageschritten pro Durchlauf; kann Schlussfolgerungen streamen. `lana-fast` für schnelle Abfragen und einzelne Fakten mit bis zu 4 Nachschlageschritten pro Durchlauf.

* `lana-thinking`
* `lana-fast`

**messages** `array` *required*

Die Unterhaltung, beginnend mit der ältesten Nachricht. Sie muss mindestens eine Nachricht enthalten, und die letzte muss `role` `user` enthalten. Die API speichert keine Unterhaltungen. Sende bei jedem request die gesamte Unterhaltung.

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

Wer die Nachricht verfasst hat.

* `user`
* `assistant`

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

Ein nicht leerer String oder ein nicht leeres Array mit Inhaltsblöcken. `text` ist für beide Rollen zulässig, `image` und `tool_result` nur in Nachrichten mit `user` und `tool_use` nur in Nachrichten mit `assistant`.

**max\_tokens** `number` (default: 8192)

Die maximale Anzahl an Ausgabe-token, die Lana in einem Modellschritt schreiben kann. Ein Durchlauf mit Abfragen umfasst mehrere Schritte, daher kann der gesamte `output_tokens` des Durchlaufs höher sein. Unter 2.048 führt `lana-thinking` keine Schlussfolgerungen aus.

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

`true` streamt serverseitig gesendete Events. `false` gibt nach Abschluss des Durchlaufs ein einzelnes JSON-Objekt zurück.

**system** `string`

Zusätzliche Anweisungen wie „Antworte in drei Stichpunkten.“ Sie werden Lanas eigenen Anweisungen hinzugefügt und ersetzen sie nicht.

**extensions** `object`

Optionen nur für Lana. Alle sind optional. Die Optionen für `include_*` ermöglichen die Ausgabe. Lana entscheidet, ob sie diese sendet.

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

Entfernt die Tools für Übertragungen, Swaps und token-Starts. Belasse den Wert auf `true`.

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

`plain` weist Lana an, kein Markdown zu verwenden, und entfernt `{{cite:N}}`-Markierungen. `source`-Events treffen weiterhin ein.

* `markdown`
* `plain`

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

Ermöglicht UI-Komponenten als `ui_block`- und `ui_schema`-Events.

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

Ermöglicht bis zu 3 vorgeschlagene Anschlussfragen.

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

Ermöglicht herunterladbare CSV-, JSON- oder Textdateien als `document`-Events.

**extensions.enable\_deep\_scan** `boolean` (default: false)

Damit kann Lana bis zu 10.000 Transaktionen aus dem Verlauf einer Adresse lesen (50.000 für Anzahlen und Summen), mit bis zu 3 Scans pro Durchlauf. Nur Mainnet. Ohne diese Option liest Lana bis zu 100 Transaktionen pro Abfrage. Derselbe Pauschalpreis gilt.

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

Wer die Anfrage stellt.

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

Die Adresse des Benutzers, damit „meine Wallet“ und „mein Guthaben“ funktionieren.

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

`wallet` oder `token`: Gibt an, was `wallet` ist. Erfordert `wallet`.

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

Eine IANA-Zeitzone wie `America/New_York`, damit „heute“ funktioniert.

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

Das abzufragende Netzwerk.

* `mainnet`
* `devnet`

**extensions.attachments** `array`

Bis zu 8 Bilder, die der letzten Benutzernachricht hinzugefügt werden. `image`-Blöcke in `messages` zählen nicht zu diesem Limit.

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

Die URL des Bildes.

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

Immer `image`.

* `image`

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

Wird vom Orb-Explorer verwendet. Du brauchst dieses Feld nicht.

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

Wird vom Orb-Explorer verwendet. Du brauchst dieses Feld nicht.


## OpenAPI

````yaml de/openapi/lana/openapi.yaml POST /v1/lana/messages
openapi: 3.0.3
info:
  title: Lana API
  description: >
    Lana ist ein Solana-KI-Agent, den du über HTTP aufrufst. Sende eine Frage in
    einfachem Englisch. Lana sucht dann nach

    Wallets, Token, Transaktionen und Preisen und antwortet dir. Die API ist wie
    die Anthropic

    Messages API aufgebaut, aber die Anthropic SDKs funktionieren nicht damit.


    ## Authentifizierung


    Sende deinen Helius API key auf eine der folgenden Arten:

    - Header (empfohlen): `X-Api-Key: YOUR_API_KEY`

    - Abfrageparameter: `?api-key=YOUR_API_KEY`


    `Authorization: Bearer` funktioniert bei diesem endpoint nicht und gibt
    `401` zurück.
  version: 1.0.0
  contact:
    name: API-Support
    url: https://helius.dev
servers:
  - url: https://beta.helius-rpc.com
    description: Gatekeeper (Beta)
security:
  - ApiKeyHeader: []
  - ApiKeyQuery: []
tags:
  - name: Nachrichten
    description: Stelle Lana eine Frage
paths:
  /v1/lana/messages:
    post:
      tags:
        - Nachrichten
      summary: Lana-Nachricht erstellen
      description: >
        Sendet eine Unterhaltung an Lana und gibt ihre Antwort zurück. Mit
        `"stream": true` trifft die Antwort

        als serverseitig gesendete Events (`text/event-stream`) ein. Mit
        `"stream": false` (Standard)

        trifft sie nach Abschluss des Durchlaufs als einzelnes JSON-Objekt ein.


        Mit `"stream": true` treffen der Status `200` und die ersten Events ein,
        sobald Lana erstmals antwortet,

        spätestens jedoch nach 10 Sekunden. Danach trifft alle 10 Sekunden ein
        `ping`-Event ein. Setze

        den Lese-timeout deines HTTP-Clients auf mindestens 30 Sekunden. Ein
        Standardwert von 5 Sekunden,

        wie bei `httpx`, ist zu kurz. Wenn ein request vor Beginn der response
        fehlschlägt, erhältst du eine normale

        Fehler-response mit dem entsprechenden Status. Prüfe deshalb den
        HTTP-Status, bevor du den Body als

        stream liest. Wenn nach Beginn der response ein Fehler auftritt, trifft
        er als abschließendes `error`-Event ein.


        Jeder request kostet pauschal 10.000 Credits mit `lana-thinking` oder
        2.000 Credits mit

        `lana-fast`. Jeder request mit HTTP-Status `200` wird abgerechnet,
        unabhängig davon, wie der Durchlauf endet.

        Requests, die vor Beginn der response fehlschlagen, erhalten einen
        anderen Status und sind kostenlos. Nur

        für kostenpflichtige Tarife.
      operationId: createLanaMessage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MessagesRequest'
            examples:
              nonStreaming:
                summary: Ohne Streaming
                value:
                  model: lana-thinking
                  messages:
                    - role: user
                      content: Wie hoch ist der aktuelle Preis von SOL?
                  extensions:
                    read_only: true
              streaming:
                summary: Streaming
                value:
                  model: lana-thinking
                  stream: true
                  messages:
                    - role: user
                      content: >-
                        Wer sind die größten Inhaber von
                        EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v?
                  extensions:
                    read_only: true
      responses:
        '200':
          description: >
            Der Durchlauf wurde ausgeführt. Mit `"stream": false` erhältst du
            ein JSON-Objekt. Prüfe `stop_reason`: Ein Durchlauf,

            der nach der Ausgabe von Inhalten fehlschlägt, gibt weiterhin `200`
            zurück, mit `stop_reason: "error"`

            und einem `error`-Objekt.


            Mit `"stream": true` erhältst du einen stream serverseitig
            gesendeter Events. Jedes Event besteht aus einer

            Zeile `event: <type>` und einer Zeile `data: <json>`, gefolgt von
            einer Leerzeile. Der stream

            beginnt mit `message_start` und endet immer mit `message_end` oder
            `error`. Neue Event-Typen

            und Felder können hinzukommen. Ignoriere alle, die du nicht kennst.
          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":"Die
                größten USDC-Inhaber sind"}}


                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: >
            Der Body ist ungültig, zum Beispiel wegen eines unbekannten Modells,
            eines unbekannten Felds oder eines `max_tokens`-Werts

            über 8.192. `message` nennt jedes ungültige Feld. Wird nicht
            abgerechnet.


            Einen Body mit mehr als 10 MB lehnt Gatekeeper mit einem
            Nur-Text-Body `Bad Request` ab.


            Wenn ein Durchlauf vor Beginn der response fehlschlägt, weil die
            Unterhaltung nicht in das Kontextfenster passt,

            wird ebenfalls `400` zurückgegeben, mit `error.type`
            `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: >
            Der API key fehlt, ist ungültig oder wurde als `Authorization:
            Bearer` gesendet. Nur-Text-Body. Wird nicht abgerechnet.
          content:
            text/plain:
              schema:
                type: string
        '403':
          description: >-
            Dein Tarif umfasst Lana nicht (kostenloser Tarif) oder die
            Zugriffseinstellungen deines Keys blockieren Lana. Nur-Text-Body.
            Wird nicht abgerechnet.
          content:
            text/plain:
              schema:
                type: string
        '429':
          description: >
            Wird nicht abgerechnet. Eine der folgenden Ursachen:

            - Nur-Text `Too Many Requests`: Du hast das rate limit deines Tarifs
            überschritten. Versuche es nach `Retry-After` erneut (1 Sekunde).

            - Nur-Text `max usage reached`: Dein Projekt hat keine Credits mehr.
            Kein `Retry-After`; weitere Versuche schlagen fehl, bis du Credits
            hinzufügst oder den Tarif wechselst.

            - JSON mit `error.type` `rate_limit_error`: In deinem Projekt laufen
            bereits etwa 3 Lana-Requests. Versuche es nach `Retry-After` erneut
            (5 Sekunden).
          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: >-
            Der Durchlauf ist vor Beginn der response mit `api_error`
            fehlgeschlagen. Wird nicht abgerechnet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: >-
            Der Durchlauf ist vor Beginn der response mit `tool_error`
            fehlgeschlagen. Wird nicht abgerechnet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: >-
            Lana ist ausgelastet oder wird neu gestartet. Versuche es nach
            `Retry-After` erneut (5 Sekunden bei Auslastung, 30 Sekunden während
            eines Neustarts). Wird nicht abgerechnet.
          headers:
            Retry-After:
              $ref: '#/components/headers/RetryAfter'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '504':
          description: >-
            Der Durchlauf ist vor Beginn der response mit `timeout_error`
            fehlgeschlagen. Wird nicht abgerechnet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '529':
          description: >-
            Der Durchlauf ist vor Beginn der response mit `overloaded_error`
            fehlgeschlagen. Einige HTTP-Clients erkennen `529` nicht. Behandle
            den Status wie `503`. Wird nicht abgerechnet.
          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: >-
            Verwende `lana-thinking` für mehrstufige Analysen mit bis zu 20
            Suchschritten pro Durchlauf. Es kann Schlussfolgerungen streamen.
            Verwende `lana-fast` für schnelle Suchen und einzelne Fakten mit bis
            zu 4 Suchschritten pro Durchlauf.
          example: lana-thinking
        messages:
          type: array
          minItems: 1
          description: >-
            Die Unterhaltung, beginnend mit der ältesten Nachricht. Sie muss
            mindestens eine Nachricht enthalten und die letzte Nachricht muss
            die `role` `user` haben. Die API speichert keine Unterhaltungen.
            Sende bei jedem request die gesamte Unterhaltung.
          items:
            $ref: '#/components/schemas/Message'
        max_tokens:
          type: integer
          minimum: 1
          maximum: 8192
          default: 8192
          description: >-
            Die maximale Anzahl an Ausgabe-Token, die Lana in einem
            Modellschritt schreiben kann. Ein Durchlauf mit Suchen umfasst
            mehrere Schritte. Daher kann die Gesamtzahl der `output_tokens` des
            Durchlaufs höher sein. Unter 2.048 führt `lana-thinking` keine
            Schlussfolgerungen aus.
        stream:
          type: boolean
          default: false
          description: >-
            `true` streamt serverseitig gesendete Events. `false` gibt nach
            Abschluss des Durchlaufs ein JSON-Objekt zurück.
        system:
          type: string
          minLength: 1
          maxLength: 10000
          description: >-
            Zusätzliche Anweisungen wie „Antworte in drei Stichpunkten.“ Sie
            ergänzen Lanas eigene Anweisungen und ersetzen sie nicht.
        extensions:
          $ref: '#/components/schemas/Extensions'
    MessageResponse:
      type: object
      description: >-
        Die response ohne Streaming. Die Antwort besteht aus den der Reihe nach
        verbundenen `text`-Blöcken.
      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: >-
            Alle UI-Komponenten als ein Baum. Vorhanden, wenn
            `include_ui_schema` aktiviert ist und es etwas anzuzeigen gibt.
        documents:
          type: array
          description: >-
            Vorhanden, wenn `include_documents` aktiviert ist und Lana Dateien
            erstellt hat.
          items:
            $ref: '#/components/schemas/Document'
        follow_up:
          type: array
          description: >-
            Vorhanden, wenn `include_followups` aktiviert ist und Lana Fragen
            vorgeschlagen hat.
          items:
            type: string
        sources:
          type: array
          description: Vorhanden, wenn Lana Webseiten verwendet hat.
          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 wird zu ... gehandelt
        stop_reason: end_turn
        usage:
          input_tokens: 90800
          output_tokens: 96
          tool_calls: 1
          prompt_tokens: 45600
          context_window: 200000
    StreamEvent:
      description: >
        Ein serverseitig gesendetes Event. Der `type` im `data`-JSON entspricht
        dem Namen des `event`. Reihenfolge:

        1. `message_start`, immer zuerst.

        2. Eine beliebige Mischung aus `content_block_delta`, `tool_use`,
        `tool_result`, `source`, `ui_block`, `document`, `progress_update` und
        `ping`.

        3. `ui_schema`, höchstens einmal.

        4. `follow_up`, höchstens einmal.

        5. `message_end`, wenn der Durchlauf abgeschlossen wurde, oder `error`,
        wenn er fehlgeschlagen ist. Immer zuletzt.
      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: Wer die Nachricht verfasst hat.
        content:
          description: >-
            Eine nicht leere Zeichenfolge oder ein nicht leeres Array mit
            Inhaltsblöcken. `text` ist für beide Rollen zulässig, `image` und
            `tool_result` nur in `user`-Nachrichten und `tool_use` nur in
            `assistant`-Nachrichten.
          oneOf:
            - type: string
              minLength: 1
            - type: array
              minItems: 1
              items:
                $ref: '#/components/schemas/ContentBlock'
    Extensions:
      type: object
      additionalProperties: false
      description: >-
        Nur für Lana verfügbare Optionen. Alle sind optional. Die
        `include_*`-Optionen ermöglichen die Ausgabe. Lana entscheidet, ob sie
        diese sendet.
      properties:
        read_only:
          type: boolean
          default: true
          description: >-
            Entfernt die Tools für Übertragungen, Swaps und Token-Starts. Lass
            den Wert auf `true`.
        output_format:
          type: string
          enum:
            - markdown
            - plain
          default: markdown
          description: >-
            `plain` weist Lana an, kein Markdown zu verwenden, und entfernt
            `{{cite:N}}`-Markierungen. `source`-Events treffen weiterhin ein.
        include_ui_schema:
          type: boolean
          default: false
          description: Erlaubt UI-Komponenten als `ui_block`- und `ui_schema`-Events.
        include_followups:
          type: boolean
          default: false
          description: Erlaubt bis zu 3 vorgeschlagene Folgefragen.
        include_documents:
          type: boolean
          default: false
          description: >-
            Erlaubt herunterladbare CSV-, JSON- oder Textdateien als
            `document`-Events.
        enable_deep_scan:
          type: boolean
          default: false
          description: >-
            Ermöglicht Lana, bis zu 10.000 Transaktionen aus dem Verlauf einer
            Adresse zu lesen (50.000 für Anzahlen und Summen), mit bis zu 3
            Scans pro Durchlauf. Nur Mainnet. Ohne diese Option liest Lana bis
            zu 100 Transaktionen pro Suche. Gleicher Pauschalpreis.
        user_context:
          $ref: '#/components/schemas/UserContext'
        attachments:
          type: array
          maxItems: 8
          description: >-
            Bis zu 8 Bilder, die der letzten Benutzernachricht hinzugefügt
            werden. `image`-Blöcke in `messages` zählen nicht zu diesem Limit.
          items:
            $ref: '#/components/schemas/Attachment'
        progress_context:
          type: object
          description: Wird vom Orb-Explorer verwendet. Du brauchst es nicht.
        transaction_filter_context:
          type: object
          description: Wird vom Orb-Explorer verwendet. Du brauchst es nicht.
    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: >-
        Eine Suche aus einem früheren Durchlauf, wiedergegeben wie von Lana
        zurückgegeben. Nur für `assistant`-Nachrichten.
      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: Das Ergebnis einer wiedergegebenen Suche. Nur für `user`-Nachrichten.
      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 hat ihre Antwort abgeschlossen.

        - `max_tokens`: Die Antwort hat `max_tokens` erreicht und wurde
        möglicherweise abgeschnitten.

        - `tool_use`: Der Durchlauf endete bei einem Suchschritt, normalerweise
        am Schrittlimit.

        - `error`: Der Durchlauf ist fehlgeschlagen. Die Antwort ist
        unvollständig.
    Usage:
      type: object
      required:
        - input_tokens
        - output_tokens
        - tool_calls
        - prompt_tokens
      properties:
        input_tokens:
          type: integer
          description: Eingabe-Token für den gesamten Durchlauf.
        output_tokens:
          type: integer
          description: Ausgabe-Token für den gesamten Durchlauf.
        tool_calls:
          type: integer
          description: >-
            Im Durchlauf ausgeführte Suchen, einschließlich einiger, die nie als
            `tool_use` erscheinen.
        prompt_tokens:
          type: integer
          description: >-
            Eingabe-Token im letzten Modellschritt. Daran erkennst du, wie voll
            der Kontext ist.
        context_window:
          type: integer
          description: Das Kontextfenster des Modells, derzeit `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: Entspricht den `{{cite:N}}`-Markierungen in der Antwort.
        url:
          type: string
        title:
          type: string
        snippet:
          type: string
    ErrorObject:
      type: object
      required:
        - type
        - message
      properties:
        type:
          type: string
          description: >
            Verzweige anhand dieses Werts, nicht anhand von `message`. Bekannte
            Werte: `invalid_request_error`, `context_overflow`,

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

            Behandle jeden anderen Wert wie `api_error`.
          example: invalid_request_error
        message:
          type: string
    MessageStartEvent:
      type: object
      title: message_start
      description: Der Durchlauf wurde gestartet.
      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: >-
        Ein Teil der Antwort (`text_delta`) oder von Lanas Schlussfolgerungen
        (`thinking_delta`, nur `lana-thinking`, wenn Lana Schlussfolgerungen
        ausführt). Zeige die Schlussfolgerungen getrennt von der Antwort an oder
        überspringe sie.
      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 hat eine Suche gestartet. Verwende das Event nur für
        Fortschrittsanzeigen. Tool-Namen und Eingaben können sich ändern.
      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: >-
        Eine Suche wurde abgeschlossen. Eine fehlgeschlagene Suche führt nicht
        zum Fehlschlagen des Durchlaufs. Lana umgeht den Fehler.
      required:
        - type
        - tool_use_id
        - content
      properties:
        type:
          type: string
          enum:
            - tool_result
        tool_use_id:
          type: string
        content:
          type: string
          description: >-
            Eine Vorschau mit bis zu 500 Zeichen. Wenn `is_error` den Wert
            `true` hat, enthält das JSON eine `error`-Meldung und einen `code`.
        is_error:
          type: boolean
    SourceEvent:
      type: object
      title: source
      description: Eine von Lana verwendete Webseite.
      required:
        - type
        - index
        - url
        - title
      properties:
        type:
          type: string
          enum:
            - source
        index:
          type: integer
          description: Entspricht den `{{cite:N}}`-Markierungen in der Antwort.
        url:
          type: string
        title:
          type: string
        snippet:
          type: string
    ProgressUpdateEvent:
      type: object
      title: progress_update
      description: >-
        Eine kurze Statuszeile während eines langen Durchlaufs. Zeige sie
        getrennt von der Antwort an.
      required:
        - type
        - id
        - message
        - created_at
      properties:
        type:
          type: string
          enum:
            - progress_update
        id:
          type: string
        message:
          type: string
        created_at:
          type: integer
          description: Unix-Millisekunden.
    UiBlockEvent:
      type: object
      title: ui_block
      description: Eine UI-Komponente. Erfordert `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: Eine herunterladbare Datei. Erfordert `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: >-
        Alle UI-Komponenten als ein Baum. Erfordert `include_ui_schema`.
        Höchstens einmal.
      required:
        - type
        - schema
      properties:
        type:
          type: string
          enum:
            - ui_schema
        schema:
          type: object
    FollowUpEvent:
      type: object
      title: follow_up
      description: >-
        Vorgeschlagene nächste Fragen. Erfordert `include_followups`. Höchstens
        einmal.
      required:
        - type
        - suggestions
      properties:
        type:
          type: string
          enum:
            - follow_up
        suggestions:
          type: array
          items:
            type: string
    MessageEndEvent:
      type: object
      title: message_end
      description: >-
        Der Durchlauf wurde abgeschlossen. Wenn `stop_reason` den Wert `error`
        hat, behandle ihn wie einen `api_error`. Jeder davor ausgegebene
        Antworttext ist unvollständig.
      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: >-
        Der Durchlauf ist nach dem Start des streams fehlgeschlagen. Jeder davor
        ausgegebene Antworttext ist unvollständig.
      required:
        - type
        - error
      properties:
        type:
          type: string
          enum:
            - error
        error:
          $ref: '#/components/schemas/ErrorObject'
    PingEvent:
      type: object
      title: ping
      description: Ein Heartbeat alle 10 Sekunden. Ignoriere ihn.
      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: Wer die Frage stellt.
      properties:
        wallet:
          type: string
          minLength: 1
          maxLength: 128
          description: >-
            Die Adresse des Benutzers, damit „meine Wallet“ und „mein Guthaben“
            funktionieren.
        address_kind:
          type: string
          minLength: 1
          maxLength: 32
          description: >-
            `wallet` oder `token`: Gibt an, was `wallet` ist. Erfordert
            `wallet`.
        time_zone:
          type: string
          minLength: 1
          maxLength: 64
          description: >-
            Eine IANA-Zeitzone wie `America/New_York`, damit „heute“
            funktioniert.
        network:
          type: string
          enum:
            - mainnet
            - devnet
          default: mainnet
          description: Das Netzwerk für die Suche.
    Attachment:
      type: object
      additionalProperties: false
      required:
        - url
        - kind
      properties:
        url:
          type: string
          format: uri
          description: Die Bild-URL.
        kind:
          type: string
          enum:
            - image
          description: Immer `image`.
    ImageBlock:
      type: object
      additionalProperties: false
      description: >-
        Ein Bild per URL. Nur für `user`-Nachrichten. Base64-Bilder werden nicht
        unterstützt.
      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: Wartezeit in Sekunden bis zum nächsten Versuch.
      schema:
        type: integer
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-Api-Key
      description: Dein Helius API key.
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Dein Helius API key.

````

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