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?”
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, menungguRetry-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-thinkingdanlana-fast. - Lana menjalankan alatnya sendiri.
tools,tool_choice,temperature,top_p,top_k,stop_sequences, danmetadatamengembalikan400. systemditambahkan ke instruksi Lana.max_tokensbersifat opsional (nilai default dan maksimum 8.192), dan gambar harus berupa URL.- Peristiwanya berbeda. Tidak ada
content_block_start,content_block_stop,message_delta, ataumessage_stop. Aliran berakhir denganmessage_endatauerror. usagemenambahkantool_calls,prompt_tokens, dancontext_window.stop_reasondapat berupaerror.extensionshanya tersedia untuk Lana.
Endpoint dan autentikasi
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.
Isi permintaan
Isinya adalah objek JSON. Bidang yang tidak dikenal ditolak dengan400, termasuk bidang yang tidak dikenal di dalam extensions dan blok konten.
lana-thinking atau lana-fast. Lihat Model.Percakapan, dimulai dari yang paling lama. Percakapan memerlukan setidaknya satu pesan, dan pesan terakhir harus memiliki
role: "user". Lihat Pesan.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.true mengalirkan peristiwa. false mengembalikan satu respons JSON saat giliran berakhir.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.
Opsi khusus Lana. Lihat Ekstensi.
Model
lana-thinking hanya melakukan penalaran jika max_tokens bernilai 2048 atau lebih tinggi.
Pesan
Setiap pesan memilikirole (user atau assistant) dan content:
assistant:
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:
message_start, selalu pertama.- Campuran apa pun dari
content_block_delta,tool_use,tool_result,source,ui_block,document,progress_update, danping. ui_schema, paling banyak satu kali.follow_up, paling banyak satu kali.message_endjika giliran selesai, atauerrorjika gagal. Ini selalu menjadi peristiwa terakhir.
Kiat untuk menampilkan aliran:
- Gunakan
tool_usehanya untuk indikator progres. Nama dan masukan alat dapat berubah. - Dengan keluaran
"markdown", ubah setiap{{cite:N}}menjadi tautan kesourcedenganindextersebut, atau hapus. ui_blockdanui_schemamembawa komponen yang sama. Lana mungkin hanya mengirimkanui_schema, jadi tampilkan peristiwaui_blockjika tiba dan jika tidak, renderui_schema.- Pencarian web mengirimkan
tool_resultdengan teksWeb search completed.atauWeb fetch completed.Halaman tiba sebagai peristiwasource.
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 kesalahan alat
Kode kesalahan alat
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:
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 selain200 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 berupa200, 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:
200denganstop_reason: "error"dan objekerror, jika giliran menghasilkan konten apa pun, termasuk pencarian. Selalu periksastop_reason.- Isi kesalahan JSON, jika giliran tidak menghasilkan apa pun. Statusnya cocok dengan
error.type:400untukcontext_overflow,500untukapi_error,502untuktool_error,504untuktimeout_error, atau529untukoverloaded_error(status yang digunakan Anthropic untuk model yang kelebihan beban; beberapa klien HTTP tidak mengenalinya, jadi tangani seperti503). 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 HTTP200, 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 berupa200. - 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.