Zum Hauptinhalt springen
Die Lana API ist ein Solana-KI-Agent, den du über HTTP aufrufst. Du stellst eine Frage in natürlicher Sprache. Lana sucht dann Wallets, Token, Transaktionen und Preise für dich nach und gibt die Antwort als stream zurück. Lana führt jede Abfrage auf der Helius-Seite aus. Du musst daher keine Tools definieren oder ausführen. Lana ist in kostenpflichtigen Helius-Tarifen (Developer und höher) zu einem Festpreis pro request verfügbar: 10.000 Credits für 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?“
Übergib das Wallet des Benutzers in 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 YOUR_API_KEY und führe Folgendes aus:
cURL
Mit -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 bei 429 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-thinking und lana-fast.
  • Lana führt eigene Tools aus. tools, tool_choice, temperature, top_p, top_k, stop_sequences und metadata geben 400 zurück.
  • system wird zu Lanas Anweisungen hinzugefügt.
  • max_tokens ist 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_delta oder message_stop. Der stream endet mit message_end oder error.
  • usage fügt tool_calls, prompt_tokens und context_window hinzu. stop_reason kann error sein.
  • extensions ist nur für Lana verfügbar.

Endpoint und Authentifizierung

Sende deinen Helius API key auf eine der folgenden Arten: 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.
Dein API key verbraucht die Credits deines Tarifs. Rufe Lana von deinem Server aus auf, nicht über einen Browser oder eine App, die du an Benutzer auslieferst.

Request-Body

Der Body ist ein JSON-Objekt. Unbekannte Felder werden mit 400 abgelehnt. Das gilt auch für unbekannte Felder innerhalb von extensions und Inhaltsblöcken.
string
erforderlich
lana-thinking oder lana-fast. Siehe Modelle.
object[]
erforderlich
Die Konversation, beginnend mit der ältesten Nachricht. Sie muss mindestens eine Nachricht enthalten. Die letzte Nachricht muss role: "user" enthalten. Siehe Nachrichten.
integer
Standard:"8192"
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.
boolean
Standard:"false"
true streamt Ereignisse. false gibt nach dem Ende der Runde eine einzelne JSON-response zurück.
string
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.
object
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 Feld role (user oder assistant) und ein Feld content:
Die API speichert keine Konversationen. Sende für eine Folgefrage die gesamte Konversation erneut und füge die neue Frage am Ende hinzu. Für Runden mit assistant reicht der Text von Lanas Antwort aus:
Lana sucht nur Adressen nach, die in der Konversation, in den eigenen Abfrageergebnissen oder in 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:
  1. message_start, immer zuerst.
  2. Eine beliebige Kombination 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 die Runde abgeschlossen wurde, oder error, wenn sie fehlgeschlagen ist. Dies ist immer das letzte Ereignis.
Neue Ereignistypen und Felder können hinzukommen. Ignoriere alle, die du nicht kennst. Tipps zum Anzeigen eines streams:
  • Verwende tool_use nur für Fortschrittsanzeigen. Toolnamen und Eingaben können sich ändern.
  • Wandle bei einer "markdown"-Ausgabe jede {{cite:N}}-Markierung in einen Link zum source mit dem entsprechenden index um oder entferne sie.
  • ui_block und ui_schema enthalten dieselben Komponenten. Lana sendet möglicherweise nur ui_schema. Zeige daher ui_block-Ereignisse an, wenn sie eintreffen. Rendere andernfalls ui_schema.
  • Websuchen senden ein tool_result mit dem Text Web search completed. oder Web fetch completed.. Die Seiten treffen als source-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:
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:
Die Antwort besteht aus den 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 als 200 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 bereits 200. 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:
  • 200 mit stop_reason: "error" und einem error-Objekt, wenn die Runde Inhalte erzeugt hat, einschließlich Abfragen. Prüfe immer stop_reason.
  • Einen JSON-Fehler-Body, wenn die Runde nichts erzeugt hat. Der Status entspricht error.type: 400 für context_overflow, 500 für api_error, 502 für tool_error, 504 für timeout_error oder 529 für overloaded_error. Letzteres ist der Status, den Anthropic bei einem überlasteten Modell verwendet. Einige HTTP-Clients erkennen ihn nicht. Behandle ihn daher wie 503. 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-Status 200 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 bereits 200.
  • 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.