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

# Buat Pesan Lana

> Ajukan pertanyaan kepada Lana, agen AI Solana, dan dapatkan jawabannya sebagai aliran peristiwa atau satu respons JSON.

Setiap permintaan menggunakan **10.000 kredit** dengan `lana-thinking` atau **2.000 kredit** dengan `lana-fast`.

Memerlukan paket berbayar. Permintaan dari paket gratis akan mengembalikan `403 Forbidden`.

Untuk panduan memulai cepat, peristiwa streaming, dan penanganan kesalahan, lihat [panduan Lana API](https://www.helius.dev/docs/id/lana.md).

## Parameter Permintaan

**model** `string` *required*

`lana-thinking` untuk analisis beberapa langkah, dengan hingga 20 langkah pencarian per giliran; model ini dapat melakukan streaming penalaran. `lana-fast` untuk pencarian cepat dan fakta tunggal, dengan hingga 4 langkah pencarian per giliran.

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

**messages** `array` *required*

Percakapan, dimulai dari yang paling lama. Percakapan memerlukan setidaknya satu pesan, dan pesan terakhir harus memiliki `role` `user`. API tidak menyimpan percakapan; kirim seluruh percakapan pada setiap permintaan.

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

Pihak yang menulis pesan.

* `user`
* `assistant`

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

String yang tidak kosong, atau array blok konten yang tidak kosong. `text` diizinkan dalam kedua peran, `image` dan `tool_result` hanya dalam pesan `user`, dan `tool_use` hanya dalam pesan `assistant`.

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

Jumlah maksimum token keluaran yang dapat ditulis Lana dalam satu langkah model. Satu giliran dengan pencarian memerlukan beberapa langkah, sehingga total `output_tokens` giliran tersebut dapat lebih tinggi. Di bawah 2.048, `lana-thinking` tidak melakukan penalaran.

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

`true` melakukan streaming peristiwa yang dikirim server. `false` mengembalikan satu objek JSON saat giliran berakhir.

**system** `string`

Instruksi tambahan, seperti "Jawab dalam tiga poin berpoin." Instruksi tersebut ditambahkan ke instruksi Lana sendiri, bukan digunakan untuk menggantikannya.

**extensions** `object`

Opsi khusus Lana. Semuanya bersifat opsional. Opsi `include_*` memungkinkan keluaran; Lana memutuskan apakah akan mengirimkannya.

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

Menghapus alat transfer, penukaran, dan peluncuran token. Biarkan nilainya tetap `true`.

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

`plain` memberi tahu Lana agar tidak menggunakan Markdown dan menghapus penanda `{{cite:N}}`. Peristiwa `source` tetap diterima.

* `markdown`
* `plain`

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

Mengizinkan komponen UI, sebagai peristiwa `ui_block` dan `ui_schema`.

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

Mengizinkan hingga 3 pertanyaan tindak lanjut yang disarankan.

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

Mengizinkan file CSV, JSON, atau teks yang dapat diunduh, sebagai peristiwa `document`.

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

Memungkinkan Lana membaca hingga 10.000 transaksi dari riwayat suatu alamat (50.000 untuk jumlah dan total), hingga 3 pemindaian per giliran. Hanya mainnet. Tanpa opsi ini, Lana membaca hingga 100 transaksi per pencarian. Harga tetap sama.

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

Pihak yang mengajukan pertanyaan.

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

Alamat pengguna, sehingga "dompet saya" dan "saldo saya" dapat digunakan.

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

`wallet` atau `token`: jenis dari `wallet`. Memerlukan `wallet`.

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

Zona waktu IANA, seperti `America/New_York`, agar "hari ini" dapat digunakan.

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

Jaringan yang akan dicari.

* `mainnet`
* `devnet`

**extensions.attachments** `array`

Hingga 8 gambar yang ditambahkan ke pesan pengguna terakhir. Blok `image` dalam `messages` tidak termasuk dalam batas ini.

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

URL gambar.

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

Selalu `image`.

* `image`

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

Digunakan oleh penjelajah Orb. Anda tidak memerlukannya.

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

Digunakan oleh penjelajah Orb. Anda tidak memerlukannya.


## OpenAPI

````yaml id/openapi/lana/openapi.yaml POST /v1/lana/messages
openapi: 3.0.3
info:
  title: Lana API
  description: >
    Lana adalah agen AI Solana yang Anda panggil melalui HTTP. Kirim pertanyaan
    dalam bahasa Inggris biasa, lalu Lana mencari

    dompet, token, transaksi, dan harga, kemudian menjawabnya. Bentuk API ini
    menyerupai Anthropic

    Messages API, tetapi SDK Anthropic tidak kompatibel dengannya.


    ## Autentikasi


    Kirim kunci API Helius Anda dengan salah satu cara berikut:

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

    - Parameter kueri: `?api-key=YOUR_API_KEY`


    `Authorization: Bearer` tidak berfungsi pada endpoint ini dan mengembalikan
    `401`.
  version: 1.0.0
  contact:
    name: Dukungan API
    url: https://helius.dev
servers:
  - url: https://beta.helius-rpc.com
    description: Gatekeeper (Beta)
security:
  - ApiKeyHeader: []
  - ApiKeyQuery: []
tags:
  - name: Pesan
    description: Ajukan pertanyaan kepada Lana
paths:
  /v1/lana/messages:
    post:
      tags:
        - Pesan
      summary: Buat pesan Lana
      description: >
        Mengirim percakapan ke Lana dan mengembalikan jawabannya. Dengan
        `"stream": true`, jawaban

        tiba sebagai peristiwa yang dikirim server (`text/event-stream`). Dengan
        `"stream": false` (default),

        jawaban tiba sebagai satu objek JSON saat giliran berakhir.


        Dengan `"stream": true`, respons `200` dan peristiwa pertama tiba saat
        Lana pertama kali merespons, atau

        paling lambat setelah 10 detik, kemudian peristiwa `ping` tiba setiap 10
        detik. Atur

        batas waktu baca klien HTTP Anda menjadi 30 detik atau lebih; nilai
        default 5 detik, seperti pada `httpx`,

        terlalu singkat. Permintaan yang gagal sebelum respons dimulai akan
        menerima respons galat

        normal dengan status yang sesuai. Jadi, periksa status HTTP sebelum Anda
        membaca isi sebagai

        stream. Setelah respons dimulai, kegagalan tiba sebagai peristiwa
        `error` terakhir.


        Setiap permintaan dikenai biaya tetap 10.000 kredit dengan
        `lana-thinking` atau 2.000 kredit dengan

        `lana-fast`. Setiap permintaan yang menerima HTTP `200` dikenai biaya,
        terlepas dari cara giliran berakhir.

        Permintaan yang gagal sebelum respons dimulai menerima status lain dan
        tidak dikenai biaya. Hanya untuk

        paket berbayar.
      operationId: createLanaMessage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MessagesRequest'
            examples:
              nonStreaming:
                summary: Tanpa streaming
                value:
                  model: lana-thinking
                  messages:
                    - role: user
                      content: Berapa harga SOL saat ini?
                  extensions:
                    read_only: true
              streaming:
                summary: Streaming
                value:
                  model: lana-thinking
                  stream: true
                  messages:
                    - role: user
                      content: >-
                        Siapa pemilik terbesar
                        EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v?
                  extensions:
                    read_only: true
      responses:
        '200':
          description: >
            Giliran dijalankan. Dengan `"stream": false`, satu objek JSON.
            Periksa `stop_reason`: giliran

            yang gagal setelah menghasilkan konten tetap mengembalikan `200`,
            dengan `stop_reason: "error"`

            dan objek `error`.


            Dengan `"stream": true`, stream peristiwa yang dikirim server.
            Setiap peristiwa berupa baris

            `event: <type>` dan baris `data: <json>`, diikuti baris kosong.
            Stream

            dimulai dengan `message_start` dan selalu berakhir dengan
            `message_end` atau `error`. Jenis

            peristiwa dan bidang baru dapat ditambahkan; abaikan yang tidak Anda
            kenali.
          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":"The
                largest USDC holders are"}}


                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: >
            Isi tidak valid, misalnya model yang tidak dikenal, bidang yang
            tidak dikenal, atau `max_tokens`

            di atas 8.192. `message` menyebutkan setiap bidang yang salah. Tidak
            dikenai biaya.


            Isi yang melebihi 10 MB ditolak oleh Gatekeeper dengan isi teks
            biasa `Bad Request`.


            Giliran yang gagal sebelum respons dimulai karena percakapan tidak
            muat

            di jendela konteks juga mengembalikan `400`, dengan `error.type`
            berupa `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: >
            Kunci API tidak ada atau tidak valid, atau dikirim sebagai
            `Authorization: Bearer`. Isi berupa teks biasa. Tidak dikenai biaya.
          content:
            text/plain:
              schema:
                type: string
        '403':
          description: >-
            Paket Anda tidak mencakup Lana (paket Gratis), atau pengaturan akses
            kunci Anda memblokirnya. Isi berupa teks biasa. Tidak dikenai biaya.
          content:
            text/plain:
              schema:
                type: string
        '429':
          description: >
            Tidak dikenai biaya. Salah satu dari berikut:

            - Teks biasa `Too Many Requests`: Anda melampaui batas laju paket.
            Coba lagi setelah `Retry-After` (1 detik).

            - Teks biasa `max usage reached`: kredit proyek Anda habis. Tidak
            ada `Retry-After`; percobaan ulang akan gagal sampai Anda
            menambahkan kredit atau meningkatkan paket.

            - JSON dengan `error.type` berupa `rate_limit_error`: proyek Anda
            sudah menjalankan sekitar 3 permintaan Lana. Coba lagi setelah
            `Retry-After` (5 detik).
          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: >-
            Giliran gagal dengan `api_error` sebelum respons dimulai. Tidak
            dikenai biaya.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: >-
            Giliran gagal dengan `tool_error` sebelum respons dimulai. Tidak
            dikenai biaya.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: >-
            Kapasitas Lana penuh atau Lana sedang dimulai ulang. Coba lagi
            setelah `Retry-After` (5 detik saat kapasitas penuh, 30 detik saat
            dimulai ulang). Tidak dikenai biaya.
          headers:
            Retry-After:
              $ref: '#/components/headers/RetryAfter'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '504':
          description: >-
            Giliran gagal dengan `timeout_error` sebelum respons dimulai. Tidak
            dikenai biaya.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '529':
          description: >-
            Giliran gagal dengan `overloaded_error` sebelum respons dimulai.
            Beberapa klien HTTP tidak mengenali `529`; tangani seperti `503`.
            Tidak dikenai biaya.
          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: >-
            Gunakan `lana-thinking` untuk analisis beberapa langkah, dengan
            hingga 20 langkah pencarian per giliran; model ini dapat melakukan
            streaming penalaran. Gunakan `lana-fast` untuk pencarian cepat dan
            fakta tunggal, dengan hingga 4 langkah pencarian per giliran.
          example: lana-thinking
        messages:
          type: array
          minItems: 1
          description: >-
            Percakapan, dimulai dari yang paling lama. Percakapan memerlukan
            setidaknya satu pesan, dan pesan terakhir harus memiliki `role`
            `user`. API tidak menyimpan percakapan; kirim seluruh percakapan
            pada setiap permintaan.
          items:
            $ref: '#/components/schemas/Message'
        max_tokens:
          type: integer
          minimum: 1
          maximum: 8192
          default: 8192
          description: >-
            Jumlah maksimum token keluaran yang dapat ditulis Lana dalam satu
            langkah model. Giliran dengan pencarian memerlukan beberapa langkah,
            sehingga total `output_tokens` giliran dapat lebih tinggi. Di bawah
            2.048, `lana-thinking` tidak melakukan penalaran.
        stream:
          type: boolean
          default: false
          description: >-
            `true` melakukan streaming peristiwa yang dikirim server. `false`
            mengembalikan satu objek JSON saat giliran berakhir.
        system:
          type: string
          minLength: 1
          maxLength: 10000
          description: >-
            Instruksi tambahan, seperti "Jawab dalam tiga poin." Instruksi ini
            ditambahkan ke instruksi Lana sendiri, bukan digunakan sebagai
            penggantinya.
        extensions:
          $ref: '#/components/schemas/Extensions'
    MessageResponse:
      type: object
      description: >-
        Respons tanpa streaming. Jawabannya adalah blok `text`, yang digabungkan
        secara berurutan.
      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: >-
            Semua komponen UI sebagai satu pohon. Ada saat `include_ui_schema`
            diaktifkan dan ada sesuatu untuk ditampilkan.
        documents:
          type: array
          description: Ada saat `include_documents` diaktifkan dan Lana membuat file.
          items:
            $ref: '#/components/schemas/Document'
        follow_up:
          type: array
          description: >-
            Ada saat `include_followups` diaktifkan dan Lana menyarankan
            pertanyaan.
          items:
            type: string
        sources:
          type: array
          description: Ada saat Lana menggunakan halaman 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 diperdagangkan pada harga ...
        stop_reason: end_turn
        usage:
          input_tokens: 90800
          output_tokens: 96
          tool_calls: 1
          prompt_tokens: 45600
          context_window: 200000
    StreamEvent:
      description: >
        Satu peristiwa yang dikirim server. `type` dalam JSON `data` sesuai
        dengan nama `event`. Urutan:

        1. `message_start`, selalu pertama.

        2. Kombinasi apa pun dari `content_block_delta`, `tool_use`,
        `tool_result`, `source`, `ui_block`, `document`, `progress_update`, dan
        `ping`.

        3. `ui_schema`, paling banyak satu kali.

        4. `follow_up`, paling banyak satu kali.

        5. `message_end` jika giliran selesai, atau `error` jika gagal. Selalu
        terakhir.
      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: Pihak yang menulis pesan.
        content:
          description: >-
            String yang tidak kosong, atau array blok konten yang tidak kosong.
            `text` diizinkan dalam kedua peran, `image` dan `tool_result` hanya
            dalam pesan `user`, serta `tool_use` hanya dalam pesan `assistant`.
          oneOf:
            - type: string
              minLength: 1
            - type: array
              minItems: 1
              items:
                $ref: '#/components/schemas/ContentBlock'
    Extensions:
      type: object
      additionalProperties: false
      description: >-
        Opsi khusus Lana. Semuanya opsional. Opsi `include_*` memungkinkan
        keluaran; Lana menentukan apakah akan mengirimkannya.
      properties:
        read_only:
          type: boolean
          default: true
          description: >-
            Menghapus alat transfer, swap, dan peluncuran token. Biarkan
            bernilai `true`.
        output_format:
          type: string
          enum:
            - markdown
            - plain
          default: markdown
          description: >-
            `plain` memberi tahu Lana agar tidak menggunakan Markdown dan
            menghapus penanda `{{cite:N}}`. Peristiwa `source` tetap tiba.
        include_ui_schema:
          type: boolean
          default: false
          description: >-
            Mengizinkan komponen UI, sebagai peristiwa `ui_block` dan
            `ui_schema`.
        include_followups:
          type: boolean
          default: false
          description: Mengizinkan hingga 3 pertanyaan lanjutan yang disarankan.
        include_documents:
          type: boolean
          default: false
          description: >-
            Mengizinkan file CSV, JSON, atau teks yang dapat diunduh, sebagai
            peristiwa `document`.
        enable_deep_scan:
          type: boolean
          default: false
          description: >-
            Memungkinkan Lana membaca hingga 10.000 transaksi dari riwayat
            alamat (50.000 untuk penghitungan dan total), hingga 3 pemindaian
            per giliran. Hanya mainnet. Tanpa opsi ini, Lana membaca hingga 100
            transaksi per pencarian. Harga tetap sama.
        user_context:
          $ref: '#/components/schemas/UserContext'
        attachments:
          type: array
          maxItems: 8
          description: >-
            Hingga 8 gambar ditambahkan ke pesan pengguna terakhir. Blok `image`
            dalam `messages` tidak dihitung dalam batas ini.
          items:
            $ref: '#/components/schemas/Attachment'
        progress_context:
          type: object
          description: Digunakan oleh penjelajah Orb. Anda tidak memerlukannya.
        transaction_filter_context:
          type: object
          description: Digunakan oleh penjelajah Orb. Anda tidak memerlukannya.
    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: >-
        Pencarian dari giliran sebelumnya, diputar ulang seperti saat Lana
        mengembalikannya. Hanya untuk pesan `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: Hasil pencarian yang diputar ulang. Hanya untuk pesan `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 menyelesaikan jawabannya.

        - `max_tokens`: jawaban mencapai `max_tokens` dan mungkin terpotong.

        - `tool_use`: giliran berakhir pada langkah pencarian, biasanya pada
        batas langkah.

        - `error`: giliran gagal. Jawaban tidak lengkap.
    Usage:
      type: object
      required:
        - input_tokens
        - output_tokens
        - tool_calls
        - prompt_tokens
      properties:
        input_tokens:
          type: integer
          description: Token masukan untuk seluruh giliran.
        output_tokens:
          type: integer
          description: Token keluaran untuk seluruh giliran.
        tool_calls:
          type: integer
          description: >-
            Pencarian yang dijalankan dalam giliran, termasuk beberapa yang
            tidak pernah muncul sebagai `tool_use`.
        prompt_tokens:
          type: integer
          description: >-
            Token masukan pada langkah model terakhir. Gunakan untuk melihat
            seberapa penuh konteksnya.
        context_window:
          type: integer
          description: Jendela konteks model, saat ini `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: Sesuai dengan penanda `{{cite:N}}` dalam jawaban.
        url:
          type: string
        title:
          type: string
        snippet:
          type: string
    ErrorObject:
      type: object
      required:
        - type
        - message
      properties:
        type:
          type: string
          description: >
            Buat percabangan berdasarkan nilai ini, bukan `message`. Nilai yang
            diketahui: `invalid_request_error`, `context_overflow`,

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

            Perlakukan nilai lain seperti `api_error`.
          example: invalid_request_error
        message:
          type: string
    MessageStartEvent:
      type: object
      title: message_start
      description: Giliran dimulai.
      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: >-
        Potongan jawaban (`text_delta`), atau penalaran Lana (`thinking_delta`,
        hanya `lana-thinking`, saat Lana melakukan penalaran). Tampilkan
        penalaran secara terpisah dari jawaban, atau lewati.
      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 memulai pencarian. Gunakan hanya untuk indikator progres; nama dan
        masukan alat dapat berubah.
      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: >-
        Pencarian selesai. Pencarian yang gagal tidak menggagalkan giliran; Lana
        akan mengatasinya.
      required:
        - type
        - tool_use_id
        - content
      properties:
        type:
          type: string
          enum:
            - tool_result
        tool_use_id:
          type: string
        content:
          type: string
          description: >-
            Pratinjau hingga 500 karakter. Saat `is_error` bernilai `true`, JSON
            berisi pesan `error` dan `code`.
        is_error:
          type: boolean
    SourceEvent:
      type: object
      title: source
      description: Halaman web yang digunakan Lana.
      required:
        - type
        - index
        - url
        - title
      properties:
        type:
          type: string
          enum:
            - source
        index:
          type: integer
          description: Sesuai dengan penanda `{{cite:N}}` dalam jawaban.
        url:
          type: string
        title:
          type: string
        snippet:
          type: string
    ProgressUpdateEvent:
      type: object
      title: progress_update
      description: >-
        Baris status singkat selama giliran yang panjang. Tampilkan secara
        terpisah dari jawaban.
      required:
        - type
        - id
        - message
        - created_at
      properties:
        type:
          type: string
          enum:
            - progress_update
        id:
          type: string
        message:
          type: string
        created_at:
          type: integer
          description: Milidetik Unix.
    UiBlockEvent:
      type: object
      title: ui_block
      description: Satu komponen UI. Memerlukan `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: File yang dapat diunduh. Memerlukan `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: >-
        Semua komponen UI sebagai satu pohon. Memerlukan `include_ui_schema`.
        Paling banyak satu kali.
      required:
        - type
        - schema
      properties:
        type:
          type: string
          enum:
            - ui_schema
        schema:
          type: object
    FollowUpEvent:
      type: object
      title: follow_up
      description: >-
        Pertanyaan berikutnya yang disarankan. Memerlukan `include_followups`.
        Paling banyak satu kali.
      required:
        - type
        - suggestions
      properties:
        type:
          type: string
          enum:
            - follow_up
        suggestions:
          type: array
          items:
            type: string
    MessageEndEvent:
      type: object
      title: message_end
      description: >-
        Giliran selesai. Jika `stop_reason` adalah `error`, perlakukan seperti
        `api_error`; teks jawaban sebelumnya hanya sebagian.
      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: >-
        Giliran gagal setelah stream dimulai. Teks jawaban sebelumnya hanya
        sebagian.
      required:
        - type
        - error
      properties:
        type:
          type: string
          enum:
            - error
        error:
          $ref: '#/components/schemas/ErrorObject'
    PingEvent:
      type: object
      title: ping
      description: Sinyal heartbeat setiap 10 detik. Abaikan.
      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: Pihak yang mengajukan pertanyaan.
      properties:
        wallet:
          type: string
          minLength: 1
          maxLength: 128
          description: >-
            Alamat pengguna, sehingga "dompet saya" dan "saldo saya" dapat
            digunakan.
        address_kind:
          type: string
          minLength: 1
          maxLength: 32
          description: '`wallet` atau `token`: jenis dari `wallet`. Memerlukan `wallet`.'
        time_zone:
          type: string
          minLength: 1
          maxLength: 64
          description: >-
            Zona waktu IANA, seperti `America/New_York`, sehingga "hari ini"
            dapat digunakan.
        network:
          type: string
          enum:
            - mainnet
            - devnet
          default: mainnet
          description: Jaringan yang akan dicari.
    Attachment:
      type: object
      additionalProperties: false
      required:
        - url
        - kind
      properties:
        url:
          type: string
          format: uri
          description: URL gambar.
        kind:
          type: string
          enum:
            - image
          description: Selalu `image`.
    ImageBlock:
      type: object
      additionalProperties: false
      description: >-
        Gambar berdasarkan URL. Hanya untuk pesan `user`. Gambar Base64 tidak
        didukung.
      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: Jumlah detik untuk menunggu sebelum mencoba lagi.
      schema:
        type: integer
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-Api-Key
      description: Kunci API Helius Anda.
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Kunci API Helius Anda.

````

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