Langsung ke konten utama
Lana API adalah agen AI Solana yang Anda panggil melalui HTTP. Anda mengirimkan pertanyaan dalam bahasa Inggris biasa, lalu Lana mencari dompet, token, transaksi, dan harga untuk Anda, kemudian mengalirkan kembali jawabannya. Lana menjalankan setiap pencarian di sisi Helius, sehingga Anda tidak perlu menentukan atau menjalankan alat apa pun. Lana tersedia dalam paket Helius berbayar (Developer dan yang lebih tinggi), dengan harga tetap per permintaan: 10.000 kredit untuk lana-thinking dan 2.000 kredit untuk lana-fast. Lihat Harga. Struktur API ini menyerupai Anthropic Messages API, tetapi SDK Anthropic tidak dapat digunakan dengannya. Panggil API melalui HTTP biasa, seperti dalam contoh di bawah. Lihat Perbedaan dari Anthropic Messages API. Lana berjalan pada model Claude milik Anthropic. Pertanyaan dan percakapan Anda dikirimkan ke Anthropic untuk menghasilkan jawaban.
Lana API tersedia dalam versi beta pada endpoint Gatekeeper (Beta), beta.helius-rpc.com. API ini belum tersedia di mainnet.helius-rpc.com. Peristiwa dan bidang baru dapat ditambahkan selama versi beta.

Hal yang dapat Anda tanyakan kepada Lana

Pertanyaan yang dapat diajukan pengguna Anda tentang perdagangan mereka dan dompet yang berinteraksi dengan mereka:
  • “Mengapa transaksi terakhir saya gagal?”
  • “Berapa slippage yang saya alami pada swap ini?”
  • “Biaya apa saja yang saya bayar untuk transaksi ini?”
  • “Dari mana dompet ini mendapatkan dananya, dan ke mana dana tersebut dikirim?”
  • “Apakah dompet ini terhubung dengan dompet lain ini?”
  • “Siapa pemegang terbesar token ini?”
Teruskan dompet pengguna di extensions.user_context.wallet agar pertanyaan tentang dompet “saya” atau “transaksi terakhir saya” dapat berfungsi.

Panduan memulai cepat

1

Dapatkan kunci API

Salin kunci API dari Dasbor Helius.
2

Ajukan pertanyaan

Ganti YOUR_API_KEY dan jalankan:
cURL
-N membuat curl mencetak setiap peristiwa segera setelah peristiwa tersebut tiba. Peristiwa pertama dapat memerlukan waktu hingga 10 detik.
3

Baca jawaban

Responsnya berupa aliran peristiwa:
Jawabannya adalah potongan text_delta, secara berurutan. lana-thinking juga dapat mengirimkan potongan thinking_delta: itu adalah penalaran Lana, jadi tampilkan secara terpisah dari jawaban atau lewati.

Baca aliran dalam kode

Kedua contoh memeriksa status HTTP sebelum membaca isi sebagai aliran, menunggu Retry-After pada 429 atau 503, mencetak jawaban saat dialirkan, dan berhenti jika giliran gagal atau aliran berakhir lebih awal.

Perbedaan dari Anthropic Messages API

  • Modelnya adalah lana-thinking dan lana-fast.
  • Lana menjalankan alatnya sendiri. tools, tool_choice, temperature, top_p, top_k, stop_sequences, dan metadata mengembalikan 400.
  • system ditambahkan ke instruksi Lana.
  • max_tokens bersifat opsional (nilai default dan maksimum 8.192), dan gambar harus berupa URL.
  • Peristiwanya berbeda. Tidak ada content_block_start, content_block_stop, message_delta, atau message_stop. Aliran berakhir dengan message_end atau error.
  • usage menambahkan tool_calls, prompt_tokens, dan context_window. stop_reason dapat berupa error.
  • extensions hanya tersedia untuk Lana.

Endpoint dan autentikasi

Kirimkan kunci API Helius Anda melalui salah satu cara berikut: Authorization: Bearer tidak berfungsi pada endpoint ini dan mengembalikan 401. mainnet.helius-rpc.com belum melayani rute ini dan mengembalikan 503. Kirimkan Content-Type: application/json pada setiap permintaan.
Kunci API Anda menggunakan kredit paket Anda. Panggil Lana dari server Anda, bukan dari browser atau aplikasi yang Anda distribusikan kepada pengguna.

Isi permintaan

Isinya adalah objek JSON. Bidang yang tidak dikenal ditolak dengan 400, termasuk bidang yang tidak dikenal di dalam extensions dan blok konten.
string
wajib
lana-thinking atau lana-fast. Lihat Model.
object[]
wajib
Percakapan, dimulai dari yang paling lama. Percakapan memerlukan setidaknya satu pesan, dan pesan terakhir harus memiliki role: "user". Lihat Pesan.
integer
default:"8192"
Jumlah maksimum token keluaran yang dapat ditulis Lana dalam satu langkah model, dari 1 hingga 8192. Giliran dengan pencarian memerlukan beberapa langkah, sehingga total output_tokens giliran tersebut dapat lebih tinggi daripada max_tokens. Di bawah 2.048, lana-thinking tidak melakukan penalaran.
boolean
default:"false"
true mengalirkan peristiwa. false mengembalikan satu respons JSON saat giliran berakhir.
string
Instruksi tambahan, dari 1 hingga 10.000 karakter, seperti “Jawab dalam tiga poin berpoin.” Instruksi tersebut ditambahkan ke instruksi Lana sendiri, bukan digunakan untuk menggantikannya.
object
Opsi khusus Lana. Lihat Ekstensi.

Model

lana-thinking hanya melakukan penalaran jika max_tokens bernilai 2048 atau lebih tinggi.

Pesan

Setiap pesan memiliki role (user atau assistant) dan content:
API tidak menyimpan percakapan. Untuk mengajukan pertanyaan lanjutan, kirimkan kembali seluruh percakapan dengan pertanyaan baru di bagian akhir. Teks jawaban Lana sudah cukup untuk giliran assistant:
Lana hanya mencari alamat yang muncul dalam percakapan, dalam hasil pencariannya sendiri, atau di extensions.user_context.wallet. content adalah string yang tidak kosong atau array blok yang tidak kosong: Gambar harus berupa URL. Gambar Base64 tidak didukung. Anda tidak memerlukan blok tool_use atau tool_result. Blok tersebut memungkinkan Anda memutar ulang pencarian dari giliran sebelumnya, sebagaimana dikembalikan Lana, agar Lana dapat menggunakan kembali hasil tersebut. tool_result juga menerima boolean is_error opsional.

Ekstensi

Semua ekstensi bersifat opsional. Opsi include_* memungkinkan keluaran tersebut. Lana menentukan apakah akan mengirimkannya. extensions juga menerima progress_context dan transaction_filter_context. Penjelajah Orb menggunakannya, dan Anda tidak memerlukannya. Bidang user_context:

Peristiwa streaming

Dengan "stream": true, Anda mendapatkan status 200 dan Content-Type: text/event-stream. Setiap peristiwa terlihat seperti ini:
data adalah satu baris JSON. type miliknya cocok dengan nama event. 200 dan peristiwa pertama tiba saat Lana pertama kali merespons (penalaran, teks jawaban, pencarian, atau file), atau paling lambat setelah 10 detik. Hingga saat itu, tidak ada yang dikirim, sehingga permintaan yang gagal dalam jangka waktu tersebut mendapatkan respons kesalahan normal dan tidak dikenai biaya. Setelah itu, ping tiba setiap 10 detik selama Lana bekerja. Atur batas waktu baca klien HTTP Anda menjadi 30 detik atau lebih. Nilai default 5 detik, seperti pada httpx, terlalu singkat: batas waktu dapat berakhir sebelum byte pertama atau di antara dua peristiwa. Peristiwa tiba dalam urutan berikut:
  1. message_start, selalu pertama.
  2. Campuran 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. Ini selalu menjadi peristiwa terakhir.
Jenis peristiwa dan bidang baru dapat ditambahkan. Abaikan yang tidak Anda kenali. Kiat untuk menampilkan aliran:
  • Gunakan tool_use hanya untuk indikator progres. Nama dan masukan alat dapat berubah.
  • Dengan keluaran "markdown", ubah setiap {{cite:N}} menjadi tautan ke source dengan index tersebut, atau hapus.
  • ui_block dan ui_schema membawa komponen yang sama. Lana mungkin hanya mengirimkan ui_schema, jadi tampilkan peristiwa ui_block jika tiba dan jika tidak, render ui_schema.
  • Pencarian web mengirimkan tool_result dengan teks Web search completed. atau Web fetch completed. Halaman tiba sebagai peristiwa source.

Kesalahan alat

Pencarian yang gagal tidak menggagalkan giliran. Lana mengatasinya, dan Anda tidak perlu mencoba lagi. tool_result memiliki is_error: true, dan content adalah JSON dengan pesan singkat dan code:
Kode baru dapat ditambahkan. Perlakukan kode yang tidak dikenal sebagai internal.

Alasan berhenti

stop_reason terdapat pada message_end dan dalam respons JSON:

Penggunaan

Instruksi dan alat pencarian milik Lana menggunakan sekitar 45.000 token pada setiap langkah model, sehingga input_tokens tetap tinggi bahkan untuk pertanyaan singkat. Harga ditetapkan per permintaan, sehingga jumlah token tidak mengubah biaya yang Anda bayar.

Respons non-streaming

Dengan "stream": false, Anda mendapatkan satu objek JSON saat giliran berakhir:
Jawabannya adalah blok text, yang digabungkan secara berurutan. Penalaran dan progress_update hanya tersedia dalam streaming. Bidang berikut hanya muncul jika memiliki nilai:

Kesalahan

Sebelum aliran dimulai

Permintaan yang gagal sebelum respons dimulai mengembalikan status selain 200 dengan isi kesalahan normal, bahkan dengan "stream": true. Tidak ada peristiwa yang dikirim dan Anda tidak dikenai biaya. Periksa status HTTP sebelum membaca isi sebagai aliran. Dengan "stream": true, respons dimulai saat Lana pertama kali merespons, atau paling lambat setelah 10 detik. Giliran yang gagal sebelum itu, misalnya karena model kelebihan beban atau percakapan terlalu panjang, juga masuk ke kategori ini. Dua 429 pertama berasal dari paket Anda, dan isi respons menunjukkan mana yang terjadi. Yang ketiga berasal dari Lana dan memiliki isi JSON. Jika 429 atau 503 tiba tanpa header Retry-After, tunggu beberapa detik sebelum mencoba lagi. Kesalahan milik Lana (400 untuk isi yang tidak valid atau context_overflow, 429 dengan rate_limit_error, 500, 502, 503, 504, dan 529) memiliki isi JSON. Kesalahan dari Gatekeeper (401, 403, 400 untuk isi berukuran terlalu besar, dan 429 paket) berupa teks biasa. Buat percabangan berdasarkan error.type, bukan message:

Setelah aliran dimulai

Status sudah berupa 200, sehingga kegagalan mengakhiri aliran dengan peristiwa error terakhir, atau dengan message_end dan stop_reason: "error". message_end tersebut tidak memiliki objek error; perlakukan seperti api_error. Semua teks jawaban sebelumnya bersifat parsial. Tampilkan sebagai tidak lengkap atau buang.

Tanpa streaming

Dengan "stream": false, giliran yang gagal mengembalikan salah satu dari:
  • 200 dengan stop_reason: "error" dan objek error, jika giliran menghasilkan konten apa pun, termasuk pencarian. Selalu periksa stop_reason.
  • Isi kesalahan JSON, jika giliran tidak menghasilkan apa pun. Statusnya cocok dengan error.type: 400 untuk context_overflow, 500 untuk api_error, 502 untuk tool_error, 504 untuk timeout_error, atau 529 untuk overloaded_error (status yang digunakan Anthropic untuk model yang kelebihan beban; beberapa klien HTTP tidak mengenalinya, jadi tangani seperti 503). Permintaan ini tidak dikenai biaya. Tangani seperti dalam Jenis kesalahan.

Jenis kesalahan

Perlakukan jenis lainnya seperti api_error.

Batas

Saat giliran mendekati 5 menit, Lana berhenti melakukan pencarian dan menjawab dengan informasi yang dimilikinya. Giliran panjang biasanya berakhir dengan jawaban parsial yang menjelaskan informasi yang belum tersedia, bukan dengan batas waktu habis. Saat melakukan streaming, atur batas waktu baca klien HTTP Anda menjadi 30 detik atau lebih. Byte pertama dapat memerlukan waktu hingga 10 detik dan ping tiba setiap 10 detik setelah itu, sehingga jeda yang jauh lebih lama berarti koneksi terputus. Nilai default 5 detik, seperti pada httpx, terlalu singkat. Tanpa streaming, tidak ada yang tiba hingga giliran berakhir, jadi atur batas waktu baca di atas 5 menit. Jika Anda memutuskan koneksi, Lana menghentikan giliran. Permintaan yang alirannya sudah dimulai tetap dikenai biaya. Saat Lana mencapai kapasitas, permintaan baru menerima 503 sebelum apa pun dialirkan. Permintaan tersebut tidak dikenai biaya. Coba lagi setelah waktu dalam header Retry-After.

Harga

Setiap permintaan dikenai harga tetap yang bergantung pada model: Harganya sama untuk permintaan streaming dan non-streaming serta pada setiap paket berbayar (Developer dan yang lebih tinggi). Lana tidak tersedia dalam paket Free. Kredit berasal dari paket Anda. Lihat Kredit.

Hal yang dikenai biaya

Anda dikenai biaya untuk setiap permintaan yang mendapatkan HTTP 200, baik streaming maupun tidak, terlepas dari bagaimana giliran berakhir. Permintaan yang gagal sebelum respons dimulai mendapatkan status lain dan tidak dikenai biaya.
  • Giliran streaming yang gagal dengan peristiwa error, atau yang koneksinya Anda putus setelah dimulai, dikenai biaya: statusnya sudah berupa 200.
  • Permintaan yang ditolak sebelum giliran dimulai (400, 401, 403, 429, 503) tidak dikenai biaya.
  • Giliran yang gagal sebelum respons dimulai (400, 5xx), baik streaming maupun tidak, tidak dikenai biaya.

Contoh lainnya

Atur nada dan dompet pengguna

cURL

Pindai seluruh riwayat dompet

cURL

Dapatkan komponen UI, tindak lanjut, dan CSV

cURL

Langkah berikutnya

Referensi API

Skema permintaan dan respons, dengan playground.

Batas Laju

Batas laju Lana untuk setiap paket.

Kredit

Cara permintaan Lana menggunakan kredit paket Anda.

Hubungi Dukungan

Dapatkan bantuan melalui Discord, obrolan, atau email.