lana-thinking und 2.000 Credits für lana-fast. Siehe Preise.
Die API ist wie die Anthropic Messages API aufgebaut. Die Anthropic SDKs funktionieren damit jedoch nicht. Rufe sie wie in den folgenden Beispielen direkt über HTTP auf. Siehe Unterschiede zur Anthropic Messages API.
Lana nutzt die Claude-Modelle von Anthropic. Deine Fragen und die Konversation werden an Anthropic gesendet, um Antworten zu generieren.
Die Lana API befindet sich auf dem Gatekeeper (Beta)-endpoint
beta.helius-rpc.com in der Betaphase. Auf mainnet.helius-rpc.com ist sie noch nicht verfügbar. Während der Betaphase können neue Ereignisse und Felder hinzukommen.Was du Lana fragen kannst
Fragen, die deine Benutzer zu ihren Trades und den Wallets stellen können, mit denen sie interagieren:- „Warum ist meine letzte Transaktion fehlgeschlagen?“
- „Wie hoch war der Slippage bei diesem Swap?“
- „Welche Gebühren habe ich für diese Transaktion bezahlt?“
- „Woher hat dieses Wallet sein Guthaben und wohin hat es dieses gesendet?“
- „Ist dieses Wallet mit diesem anderen Wallet verbunden?“
- „Wer sind die größten Inhaber dieses Tokens?“
extensions.user_context.wallet, damit Fragen zu „meinem“ Wallet oder „meiner letzten Transaktion“ funktionieren.
Schnellstart
1
Get an API key
Kopiere einen API key aus dem Helius Dashboard.
2
Ask a question
Ersetze Mit
YOUR_API_KEY und führe Folgendes aus:cURL
-N gibt curl jedes Ereignis sofort nach dem Eintreffen aus. Bis zum ersten Ereignis können bis zu 10 Sekunden vergehen.3
Read the answer
Die response ist ein stream aus Ereignissen:Die Antwort besteht aus den
text_delta-Abschnitten in der richtigen Reihenfolge. lana-thinking kann auch thinking_delta-Abschnitte senden. Das sind Lanas Überlegungen. Zeige sie daher getrennt von der Antwort an oder überspringe sie.Den stream im Code lesen
Beide Beispiele prüfen den HTTP-Status, bevor sie den Body als stream lesen. Sie warten bei429 oder 503 auf Retry-After, geben die Antwort während des Streamings aus und stoppen, wenn die Runde fehlschlägt oder der stream vorzeitig endet.
Unterschiede zur Anthropic Messages API
- Die Modelle sind
lana-thinkingundlana-fast. - Lana führt eigene Tools aus.
tools,tool_choice,temperature,top_p,top_k,stop_sequencesundmetadatageben400zurück. systemwird zu Lanas Anweisungen hinzugefügt.max_tokensist optional (Standard und Maximum: 8.192) und Bilder müssen URLs sein.- Die Ereignisse unterscheiden sich. Es gibt kein
content_block_start,content_block_stop,message_deltaodermessage_stop. Der stream endet mitmessage_endodererror. usagefügttool_calls,prompt_tokensundcontext_windowhinzu.stop_reasonkannerrorsein.extensionsist nur für Lana verfügbar.
Endpoint und Authentifizierung
Authorization: Bearer funktioniert auf diesem endpoint nicht und gibt 401 zurück.
mainnet.helius-rpc.com stellt diese Route noch nicht bereit und gibt 503 zurück.
Sende Content-Type: application/json bei jedem request.
Request-Body
Der Body ist ein JSON-Objekt. Unbekannte Felder werden mit400 abgelehnt. Das gilt auch für unbekannte Felder innerhalb von extensions und Inhaltsblöcken.
lana-thinking oder lana-fast. Siehe Modelle.Die Konversation, beginnend mit der ältesten Nachricht. Sie muss mindestens eine Nachricht enthalten. Die letzte Nachricht muss
role: "user" enthalten. Siehe Nachrichten.Die maximale Anzahl an Ausgabe-Token, die Lana in einem Modellschritt schreiben kann: von
1 bis 8192. Eine Runde mit Abfragen umfasst mehrere Schritte. Daher kann der gesamte output_tokens-Wert der Runde über max_tokens liegen. Unter 2.048 führt lana-thinking keine Überlegungen aus.true streamt Ereignisse. false gibt nach dem Ende der Runde eine einzelne JSON-response zurück.Zusätzliche Anweisungen mit 1 bis 10.000 Zeichen, etwa „Antworte in drei Stichpunkten.“ Sie werden zu Lanas eigenen Anweisungen hinzugefügt und ersetzen diese nicht.
Optionen nur für Lana. Siehe Erweiterungen.
Modelle
lana-thinking führt nur Überlegungen aus, wenn max_tokens mindestens 2048 beträgt.
Nachrichten
Jede Nachricht hat ein Feldrole (user oder assistant) und ein Feld content:
assistant reicht der Text von Lanas Antwort aus:
extensions.user_context.wallet vorkommen.
content ist entweder ein nicht leerer String oder ein nicht leeres Array aus Blöcken:
Bilder müssen URLs sein. Base64-Bilder werden nicht unterstützt.
Du benötigst keine
tool_use- oder tool_result-Blöcke. Mit ihnen kannst du Abfragen aus einer früheren Runde so wiedergeben, wie Lana sie zurückgegeben hat. Lana kann diese Ergebnisse dann wiederverwenden. tool_result akzeptiert außerdem optional den booleschen Wert is_error.
Erweiterungen
Alle Erweiterungen sind optional.
Die
include_*-Optionen ermöglichen diese Ausgabe. Lana entscheidet, ob sie gesendet wird.
extensions akzeptiert außerdem progress_context und transaction_filter_context. Der Orb-Explorer verwendet sie. Du benötigst sie nicht.
Felder von user_context:
Streaming-Ereignisse
Mit"stream": true erhältst du den Status 200 und Content-Type: text/event-stream. Jedes Ereignis sieht wie folgt aus:
data ist eine einzelne JSON-Zeile. Der Wert von type entspricht dem Namen event.
200 und die ersten Ereignisse treffen ein, sobald Lana erstmals antwortet – mit Überlegungen, Antworttext, einer Abfrage oder einer Datei – oder spätestens nach 10 Sekunden. Bis dahin wird nichts gesendet. Ein request, der in diesem Zeitfenster fehlschlägt, erhält daher eine normale Fehler-response und wird nicht berechnet. Danach trifft alle 10 Sekunden ein ping ein, solange Lana arbeitet.
Setze den Lese-timeout deines HTTP-Clients auf mindestens 30 Sekunden. Ein Standardwert von 5 Sekunden, wie bei httpx, ist zu kurz. Der timeout kann vor dem ersten Byte oder zwischen zwei Ereignissen ablaufen.
Die Ereignisse treffen in dieser Reihenfolge ein:
message_start, immer zuerst.- Eine beliebige Kombination aus
content_block_delta,tool_use,tool_result,source,ui_block,document,progress_updateundping. ui_schema, höchstens einmal.follow_up, höchstens einmal.message_end, wenn die Runde abgeschlossen wurde, odererror, wenn sie fehlgeschlagen ist. Dies ist immer das letzte Ereignis.
Tipps zum Anzeigen eines streams:
- Verwende
tool_usenur für Fortschrittsanzeigen. Toolnamen und Eingaben können sich ändern. - Wandle bei einer
"markdown"-Ausgabe jede{{cite:N}}-Markierung in einen Link zumsourcemit dem entsprechendenindexum oder entferne sie. ui_blockundui_schemaenthalten dieselben Komponenten. Lana sendet möglicherweise nurui_schema. Zeige daherui_block-Ereignisse an, wenn sie eintreffen. Rendere andernfallsui_schema.- Websuchen senden ein
tool_resultmit dem TextWeb search completed.oderWeb fetch completed.. Die Seiten treffen alssource-Ereignisse ein.
Toolfehler
Eine fehlgeschlagene Abfrage lässt die Runde nicht fehlschlagen. Lana umgeht den Fehler und du musst den request nicht wiederholen.tool_result enthält is_error: true. content ist JSON mit einer kurzen Nachricht und einem code:
Tool error codes
Tool error codes
Neue Codes können hinzukommen. Behandle einen unbekannten Code wie
internal.Stoppgründe
stop_reason befindet sich in message_end und in der JSON-response:
Nutzung
Lanas eigene Anweisungen und Abfragetools belegen in jedem Modellschritt etwa 45.000 Token. Daher ist
input_tokens selbst bei einer kurzen Frage hoch. Die Abrechnung erfolgt pro request. Die Tokenanzahl ändert daher nicht deinen Preis.
Response ohne Streaming
Mit"stream": false erhältst du nach dem Ende der Runde ein einzelnes JSON-Objekt:
text-Blöcken, die in der richtigen Reihenfolge zusammengefügt werden. Überlegungen und progress_update sind nur beim Streaming verfügbar.
Diese Felder erscheinen nur, wenn sie einen Wert haben:
Fehler
Vor dem Start des streams
Ein request, der vor Beginn der response fehlschlägt, gibt einen anderen Status als200 mit einem normalen Fehler-Body zurück. Das gilt auch bei "stream": true. Es werden keine Ereignisse gesendet und dir entstehen keine Kosten. Prüfe den HTTP-Status, bevor du den Body als stream liest.
Bei "stream": true beginnt die response, sobald Lana erstmals antwortet, oder spätestens nach 10 Sekunden. Eine Runde, die vorher fehlschlägt, etwa weil das Modell überlastet oder die Konversation zu lang ist, fällt ebenfalls in diese Kategorie.
Die ersten beiden
429-Fehler stammen von deinem Tarif. Der response-Body gibt an, welcher davon aufgetreten ist. Der dritte stammt von Lana und hat einen JSON-Body.
Wenn 429 oder 503 ohne Retry-After-Header eintrifft, warte vor dem nächsten Versuch einige Sekunden.
Lanas eigene Fehler (400 bei einem ungültigen Body oder context_overflow, 429 mit rate_limit_error, 500, 502, 503, 504 und 529) haben einen JSON-Body. Fehler von Gatekeeper (401, 403, 400 bei einem zu großen Body und die tarifbedingten 429-Fehler) sind Klartext. Verzweige anhand von error.type, nicht anhand von message:
Nach dem Start des streams
Der Status ist bereits200. Bei einem Fehler endet der stream daher mit einem abschließenden error-Ereignis oder mit message_end und stop_reason: "error". Dieses message_end enthält kein error-Objekt. Behandle es wie api_error. Jeder zuvor gesendete Antworttext ist unvollständig. Kennzeichne ihn als unvollständig oder verwirf ihn.
Ohne Streaming
Mit"stream": false gibt eine fehlgeschlagene Runde eine der folgenden responses zurück:
200mitstop_reason: "error"und einemerror-Objekt, wenn die Runde Inhalte erzeugt hat, einschließlich Abfragen. Prüfe immerstop_reason.- Einen JSON-Fehler-Body, wenn die Runde nichts erzeugt hat. Der Status entspricht
error.type:400fürcontext_overflow,500fürapi_error,502fürtool_error,504fürtimeout_erroroder529füroverloaded_error. Letzteres ist der Status, den Anthropic bei einem überlasteten Modell verwendet. Einige HTTP-Clients erkennen ihn nicht. Behandle ihn daher wie503. Diese requests werden nicht berechnet. Behandle sie wie unter Fehlertypen beschrieben.
Fehlertypen
Behandle jeden anderen Typ wie
api_error.
Limits
Wenn sich eine Runde 5 Minuten nähert, beendet Lana die Abfragen und antwortet mit den vorhandenen Informationen. Lange Runden enden normalerweise mit einer Teilantwort, die angibt, was fehlt, und nicht mit einem timeout.
Setze beim Streaming den Lese-timeout deines HTTP-Clients auf mindestens 30 Sekunden. Bis zum ersten Byte können bis zu 10 Sekunden vergehen. Danach trifft alle 10 Sekunden ein
ping ein. Eine deutlich längere Pause bedeutet daher, dass die Verbindung abgebrochen ist. Ein Standardwert von 5 Sekunden, wie bei httpx, ist zu kurz. Ohne Streaming trifft bis zum Ende der Runde nichts ein. Setze den Lese-timeout daher auf mehr als 5 Minuten.
Wenn du die Verbindung trennst, beendet Lana die Runde. Ein request, dessen stream bereits begonnen hat, wird trotzdem berechnet.
Wenn Lana ausgelastet ist, erhalten neue requests 503, bevor etwas gestreamt wird. Sie werden nicht berechnet. Versuche es nach der im Retry-After-Header angegebenen Zeit erneut.
Preise
Jeder request kostet einen vom Modell abhängigen Festpreis:
Der Preis ist für requests mit und ohne Streaming sowie in jedem kostenpflichtigen Tarif (Developer und höher) gleich. Lana ist im Free-Tarif nicht verfügbar.
Die Credits stammen aus deinem Tarif. Siehe Credits.
Was berechnet wird
Jeder request mit dem HTTP-Status200 wird berechnet, unabhängig vom Streaming und davon, wie die Runde endet. requests, die vor Beginn der response fehlschlagen, erhalten einen anderen Status und sind kostenlos.
- Eine Streaming-Runde, die mit einem
error-Ereignis fehlschlägt oder deren Verbindung du nach dem Start trennst, wird berechnet. Der Status war bereits200. - Ein request, der vor Beginn der Runde abgelehnt wird (
400,401,403,429,503), ist kostenlos. - Eine Runde, die vor Beginn der response fehlschlägt (
400,5xx), ist mit und ohne Streaming kostenlos.
Weitere Beispiele
Tonalität und Wallet des Benutzers festlegen
cURL
Den vollständigen Verlauf eines Wallets scannen
cURL
UI-Komponenten, Folgefragen und eine CSV abrufen
cURL
Nächste Schritte
API Reference
Das request- und response-Schema mit einem Playground.
Rate Limits
Lanas tarifspezifische rate limits.
Credits
So verwenden Lana-requests die Credits deines Tarifs.
Contact Support
Erhalte Hilfe über Discord, Chat oder E-Mail.