API Lana
Créer un message Lana
Posez une question à Lana, un agent d’IA Solana, et obtenez la réponse sous forme de flux d’événements ou d’une réponse JSON unique.
POST
/
v1
/
lana
/
messages
curl --request POST \
--url https://beta.helius-rpc.com/v1/lana/messages \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"model": "lana-thinking",
"messages": [
{
"role": "user",
"content": "What is the current price of SOL?"
}
],
"extensions": {
"read_only": true
}
}
'{
"id": "msg_3f9c...",
"type": "message",
"role": "assistant",
"model": "lana-thinking",
"content": [
{
"type": "tool_use",
"id": "toolu_01...",
"name": "...",
"input": {
"mint": "So11111111111111111111111111111111111111112"
}
},
{
"type": "tool_result",
"tool_use_id": "toolu_01...",
"content": "{\"price\":..."
},
{
"type": "text",
"text": "SOL is trading at ..."
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 90800,
"output_tokens": 96,
"tool_calls": 1,
"prompt_tokens": 45600,
"context_window": 200000
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "max_tokens: max_tokens must be <= 8192"
}
}<string><string>{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}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
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-thinkinglana-fast
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.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.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.true diffuse des événements envoyés par le serveur. false renvoie un seul objet JSON à la fin de l’échange.Des instructions supplémentaires, comme « Répondez en trois points. » Elles s’ajoutent aux propres instructions de Lana et ne les remplacent pas.
Options propres à Lana. Elles sont toutes facultatives. Les options
include_* permettent de produire une sortie ; Lana décide de l’envoyer ou non.Supprime les outils de transfert, d’échange et de lancement de jetons. Laissez la valeur
true.plain indique à Lana de ne pas utiliser Markdown et supprime les marqueurs {{cite:N}}. Les événements source sont toujours reçus.markdownplain
Autorise les composants d’interface utilisateur sous forme d’événements
ui_block et ui_schema.Autorise les fichiers CSV, JSON ou texte téléchargeables sous forme d’événements
document.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.
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.Corps
application/json
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.
end_turn: Lana finished its answer.max_tokens: the answer hitmax_tokensand 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 Cette page vous a-t-elle été utile ?
⌘I
curl --request POST \
--url https://beta.helius-rpc.com/v1/lana/messages \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"model": "lana-thinking",
"messages": [
{
"role": "user",
"content": "What is the current price of SOL?"
}
],
"extensions": {
"read_only": true
}
}
'{
"id": "msg_3f9c...",
"type": "message",
"role": "assistant",
"model": "lana-thinking",
"content": [
{
"type": "tool_use",
"id": "toolu_01...",
"name": "...",
"input": {
"mint": "So11111111111111111111111111111111111111112"
}
},
{
"type": "tool_result",
"tool_use_id": "toolu_01...",
"content": "{\"price\":..."
},
{
"type": "text",
"text": "SOL is trading at ..."
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 90800,
"output_tokens": 96,
"tool_calls": 1,
"prompt_tokens": 45600,
"context_window": 200000
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "max_tokens: max_tokens must be <= 8192"
}
}<string><string>{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}