Passer au contenu principal
POST
Chaque requête coûte 10 000 crédits avec lana-thinking ou 2 000 crédits avec lana-fast. Nécessite une offre payante. Les requêtes avec l’offre gratuite renvoient 403 Forbidden. Pour consulter le guide de démarrage rapide, la diffusion d’événements et la gestion des erreurs, reportez-vous au guide de l’API Lana.

Paramètres de la requête

string
requis
lana-thinking pour une analyse en plusieurs étapes, avec jusqu’à 20 étapes de recherche par échange ; ce modèle peut diffuser son raisonnement. lana-fast pour les recherches rapides et les faits isolés, avec jusqu’à 4 étapes de recherche par échange.
  • lana-thinking
  • lana-fast
array
requis
La conversation, du message le plus ancien au plus récent. Elle doit contenir au moins un message, et le dernier doit avoir role user. L’API ne stocke pas les conversations ; envoyez la conversation complète avec chaque requête.
string
requis
L’auteur du message.
  • user
  • assistant
any
requis
Une chaîne non vide ou un tableau non vide de blocs de contenu. text est autorisé pour les deux rôles, image et tool_result uniquement dans les messages user, et tool_use uniquement dans les messages assistant.
number
défaut:"8192"
Le nombre maximal de tokens de sortie que Lana peut générer au cours d’une étape du modèle. Un échange comprenant des recherches nécessite plusieurs étapes ; son output_tokens total peut donc être supérieur. En dessous de 2 048, lana-thinking n’effectue aucun raisonnement.
boolean
défaut:"false"
true diffuse des événements envoyés par le serveur. false renvoie un seul objet JSON à la fin de l’échange.
string
Des instructions supplémentaires, comme « Répondez en trois points. » Elles s’ajoutent aux propres instructions de Lana et ne les remplacent pas.
object
Options propres à Lana. Elles sont toutes facultatives. Les options include_* permettent de produire une sortie ; Lana décide de l’envoyer ou non.
boolean
défaut:"true"
Supprime les outils de transfert, d’échange et de lancement de jetons. Laissez la valeur true.
string
défaut:"markdown"
plain indique à Lana de ne pas utiliser Markdown et supprime les marqueurs {{cite:N}}. Les événements source sont toujours reçus.
  • markdown
  • plain
boolean
défaut:"false"
Autorise les composants d’interface utilisateur sous forme d’événements ui_block et ui_schema.
boolean
défaut:"false"
Autorise jusqu’à 3 suggestions de questions complémentaires.
boolean
défaut:"false"
Autorise les fichiers CSV, JSON ou texte téléchargeables sous forme d’événements document.
boolean
défaut:"false"
Permet à Lana de lire jusqu’à 10 000 transactions dans l’historique d’une adresse (50 000 pour les comptages et les totaux), avec jusqu’à 3 analyses par échange. Réseau principal uniquement. Sans cette option, Lana lit jusqu’à 100 transactions par recherche. Le tarif forfaitaire reste identique.
object
Identité de la personne qui pose la question.
string
L’adresse de l’utilisateur, afin que « mon portefeuille » et « mon solde » fonctionnent.
string
wallet ou token : ce que représente wallet. Nécessite wallet.
string
Un fuseau horaire IANA, tel que America/New_York, afin que « aujourd’hui » fonctionne.
string
défaut:"mainnet"
Le réseau dans lequel effectuer la recherche.
  • mainnet
  • devnet
array
Jusqu’à 8 images ajoutées au dernier message de l’utilisateur. Les blocs image dans messages ne sont pas pris en compte dans cette limite.
string
requis
L’URL de l’image.
string
requis
Toujours image.
  • image
object
Utilisé par l’explorateur Orb. Vous n’en avez pas besoin.
object
Utilisé par l’explorateur Orb. Vous n’en avez pas besoin.

Autorisations

X-Api-Key
string
header
requis

Your Helius API key.

Corps

application/json
model
enum<string>
requis

lana-thinking for multi-step analysis, with up to 20 lookup steps per turn; it can stream reasoning. lana-fast for quick lookups and single facts, with up to 4 lookup steps per turn.

Options disponibles:
lana-thinking,
lana-fast
Exemple:

"lana-thinking"

messages
object[]
requis

The conversation, oldest first. It needs at least one message, and the last one must have role user. The API doesn't store conversations; send the whole conversation on every request.

Minimum array length: 1
max_tokens
integer
défaut:8192

The most output tokens Lana can write in one model step. A turn with lookups takes several steps, so the turn's total output_tokens can be higher. Below 2,048, lana-thinking doesn't reason.

Plage requise: 1 <= x <= 8192
stream
boolean
défaut:false

true streams server-sent events. false returns one JSON object when the turn ends.

system
string

Extra instructions, such as "Answer in three bullet points." They're added to Lana's own instructions, not used in place of them.

Required string length: 1 - 10000
extensions
object

Lana-only options. All are optional. The include_* options make output possible; Lana decides whether to send it.

Réponse

The turn ran. With "stream": false, one JSON object. Check stop_reason: a turn that fails after producing content still returns 200, with stop_reason: "error" and an error object.

With "stream": true, a stream of server-sent events. Each event is an event: <type> line and a data: <json> line, followed by a blank line. The stream starts with message_start and always ends with message_end or error. New event types and fields can be added; ignore any you don't recognize.

The non-streaming response. The answer is the text blocks, joined in order.

id
string
requis
Exemple:

"msg_3f9c..."

type
enum<string>
requis
Options disponibles:
message
role
enum<string>
requis
Options disponibles:
assistant
model
enum<string>
requis
Options disponibles:
lana-thinking,
lana-fast
content
object[]
requis
stop_reason
enum<string>
requis
  • end_turn: Lana finished its answer.
  • max_tokens: the answer hit max_tokens and may be cut off.
  • tool_use: the turn ended on a lookup step, usually at the step limit.
  • error: the turn failed. The answer is incomplete.
Options disponibles:
end_turn,
max_tokens,
tool_use,
error
usage
object
requis
ui_schema
object

All UI components as one tree. Present when include_ui_schema is on and there's something to show.

documents
object[]

Present when include_documents is on and Lana made files.

follow_up
string[]

Present when include_followups is on and Lana suggested questions.

sources
object[]

Present when Lana used web pages.

error
object