Zum Hauptinhalt springen
POST
Jeder request kostet 10.000 Credits mit lana-thinking oder 2.000 Credits mit lana-fast. Erfordert einen kostenpflichtigen Tarif. Requests im kostenlosen Tarif geben 403 Forbidden zurück. Den Schnellstart, Streaming-Events und Informationen zur Fehlerbehandlung findest du im Lana API-Leitfaden.

Request-Parameter

string
erforderlich
lana-thinking für mehrstufige Analysen mit bis zu 20 Nachschlageschritten pro Durchlauf; kann Schlussfolgerungen streamen. lana-fast für schnelle Abfragen und einzelne Fakten mit bis zu 4 Nachschlageschritten pro Durchlauf.
  • lana-thinking
  • lana-fast
array
erforderlich
Die Unterhaltung, beginnend mit der ältesten Nachricht. Sie muss mindestens eine Nachricht enthalten, und die letzte muss role user enthalten. Die API speichert keine Unterhaltungen. Sende bei jedem request die gesamte Unterhaltung.
string
erforderlich
Wer die Nachricht verfasst hat.
  • user
  • assistant
any
erforderlich
Ein nicht leerer String oder ein nicht leeres Array mit Inhaltsblöcken. text ist für beide Rollen zulässig, image und tool_result nur in Nachrichten mit user und tool_use nur in Nachrichten mit assistant.
number
Standard:"8192"
Die maximale Anzahl an Ausgabe-token, die Lana in einem Modellschritt schreiben kann. Ein Durchlauf mit Abfragen umfasst mehrere Schritte, daher kann der gesamte output_tokens des Durchlaufs höher sein. Unter 2.048 führt lana-thinking keine Schlussfolgerungen aus.
boolean
Standard:"false"
true streamt serverseitig gesendete Events. false gibt nach Abschluss des Durchlaufs ein einzelnes JSON-Objekt zurück.
string
Zusätzliche Anweisungen wie „Antworte in drei Stichpunkten.“ Sie werden Lanas eigenen Anweisungen hinzugefügt und ersetzen sie nicht.
object
Optionen nur für Lana. Alle sind optional. Die Optionen für include_* ermöglichen die Ausgabe. Lana entscheidet, ob sie diese sendet.
boolean
Standard:"true"
Entfernt die Tools für Übertragungen, Swaps und token-Starts. Belasse den Wert auf true.
string
Standard:"markdown"
plain weist Lana an, kein Markdown zu verwenden, und entfernt {{cite:N}}-Markierungen. source-Events treffen weiterhin ein.
  • markdown
  • plain
boolean
Standard:"false"
Ermöglicht UI-Komponenten als ui_block- und ui_schema-Events.
boolean
Standard:"false"
Ermöglicht bis zu 3 vorgeschlagene Anschlussfragen.
boolean
Standard:"false"
Ermöglicht herunterladbare CSV-, JSON- oder Textdateien als document-Events.
boolean
Standard:"false"
Damit kann Lana bis zu 10.000 Transaktionen aus dem Verlauf einer Adresse lesen (50.000 für Anzahlen und Summen), mit bis zu 3 Scans pro Durchlauf. Nur Mainnet. Ohne diese Option liest Lana bis zu 100 Transaktionen pro Abfrage. Derselbe Pauschalpreis gilt.
object
Wer die Anfrage stellt.
string
Die Adresse des Benutzers, damit „meine Wallet“ und „mein Guthaben“ funktionieren.
string
wallet oder token: Gibt an, was wallet ist. Erfordert wallet.
string
Eine IANA-Zeitzone wie America/New_York, damit „heute“ funktioniert.
string
Standard:"mainnet"
Das abzufragende Netzwerk.
  • mainnet
  • devnet
array
Bis zu 8 Bilder, die der letzten Benutzernachricht hinzugefügt werden. image-Blöcke in messages zählen nicht zu diesem Limit.
string
erforderlich
Die URL des Bildes.
string
erforderlich
Immer image.
  • image
object
Wird vom Orb-Explorer verwendet. Du brauchst dieses Feld nicht.
object
Wird vom Orb-Explorer verwendet. Du brauchst dieses Feld nicht.

Autorisierungen

X-Api-Key
string
header
erforderlich

Dein Helius API key.

Body

application/json
model
enum<string>
erforderlich

Verwende lana-thinking für mehrstufige Analysen mit bis zu 20 Suchschritten pro Durchlauf. Es kann Schlussfolgerungen streamen. Verwende lana-fast für schnelle Suchen und einzelne Fakten mit bis zu 4 Suchschritten pro Durchlauf.

Verfügbare Optionen:
lana-thinking,
lana-fast
Beispiel:

"lana-thinking"

messages
object[]
erforderlich

Die Unterhaltung, beginnend mit der ältesten Nachricht. Sie muss mindestens eine Nachricht enthalten und die letzte Nachricht muss die role user haben. Die API speichert keine Unterhaltungen. Sende bei jedem request die gesamte Unterhaltung.

Minimum array length: 1
max_tokens
integer
Standard:8192

Die maximale Anzahl an Ausgabe-Token, die Lana in einem Modellschritt schreiben kann. Ein Durchlauf mit Suchen umfasst mehrere Schritte. Daher kann die Gesamtzahl der output_tokens des Durchlaufs höher sein. Unter 2.048 führt lana-thinking keine Schlussfolgerungen aus.

Erforderlicher Bereich: 1 <= x <= 8192
stream
boolean
Standard:false

true streamt serverseitig gesendete Events. false gibt nach Abschluss des Durchlaufs ein JSON-Objekt zurück.

system
string

Zusätzliche Anweisungen wie „Antworte in drei Stichpunkten.“ Sie ergänzen Lanas eigene Anweisungen und ersetzen sie nicht.

Required string length: 1 - 10000
extensions
object

Nur für Lana verfügbare Optionen. Alle sind optional. Die include_*-Optionen ermöglichen die Ausgabe. Lana entscheidet, ob sie diese sendet.

Antwort

Der Durchlauf wurde ausgeführt. Mit "stream": false erhältst du ein JSON-Objekt. Prüfe stop_reason: Ein Durchlauf, der nach der Ausgabe von Inhalten fehlschlägt, gibt weiterhin 200 zurück, mit stop_reason: "error" und einem error-Objekt.

Mit "stream": true erhältst du einen stream serverseitig gesendeter Events. Jedes Event besteht aus einer Zeile event: <type> und einer Zeile data: <json>, gefolgt von einer Leerzeile. Der stream beginnt mit message_start und endet immer mit message_end oder error. Neue Event-Typen und Felder können hinzukommen. Ignoriere alle, die du nicht kennst.

Die response ohne Streaming. Die Antwort besteht aus den der Reihe nach verbundenen text-Blöcken.

id
string
erforderlich
Beispiel:

"msg_3f9c..."

type
enum<string>
erforderlich
Verfügbare Optionen:
message
role
enum<string>
erforderlich
Verfügbare Optionen:
assistant
model
enum<string>
erforderlich
Verfügbare Optionen:
lana-thinking,
lana-fast
content
object[]
erforderlich
stop_reason
enum<string>
erforderlich
  • end_turn: Lana hat ihre Antwort abgeschlossen.
  • max_tokens: Die Antwort hat max_tokens erreicht und wurde möglicherweise abgeschnitten.
  • tool_use: Der Durchlauf endete bei einem Suchschritt, normalerweise am Schrittlimit.
  • error: Der Durchlauf ist fehlgeschlagen. Die Antwort ist unvollständig.
Verfügbare Optionen:
end_turn,
max_tokens,
tool_use,
error
usage
object
erforderlich
ui_schema
object

Alle UI-Komponenten als ein Baum. Vorhanden, wenn include_ui_schema aktiviert ist und es etwas anzuzeigen gibt.

documents
object[]

Vorhanden, wenn include_documents aktiviert ist und Lana Dateien erstellt hat.

follow_up
string[]

Vorhanden, wenn include_followups aktiviert ist und Lana Fragen vorgeschlagen hat.

sources
object[]

Vorhanden, wenn Lana Webseiten verwendet hat.

error
object