lana-thinking et 2 000 crédits pour lana-fast. Consultez la section Tarification.
L’API reprend la structure de l’API Messages d’Anthropic, mais les SDK Anthropic ne fonctionnent pas avec elle. Appelez-la directement via HTTP, comme dans les exemples ci-dessous. Consultez la section Différences avec l’API Messages d’Anthropic.
Lana utilise les modèles Claude d’Anthropic. Vos questions et la conversation sont envoyées à Anthropic pour générer les réponses.
L’API Lana est disponible en version bêta sur l’endpoint Gatekeeper (Beta),
beta.helius-rpc.com. Elle n’est pas encore disponible sur mainnet.helius-rpc.com. De nouveaux événements et champs peuvent être ajoutés pendant la bêta.Ce que vous pouvez demander à Lana
Questions que vos utilisateurs peuvent poser sur leurs transactions et les portefeuilles avec lesquels ils interagissent :- « Pourquoi ma dernière transaction a-t-elle échoué ? »
- « Quel slippage ai-je subi sur ce swap ? »
- « Quels frais ai-je payés pour cette transaction ? »
- « D’où ce portefeuille a-t-il reçu ses fonds, et où les a-t-il envoyés ? »
- « Ce portefeuille est-il lié à cet autre portefeuille ? »
- « Qui sont les principaux détenteurs de ce token ? »
extensions.user_context.wallet pour que les questions concernant « mon » portefeuille ou « ma dernière transaction » fonctionnent.
Démarrage rapide
1
Get an API key
Copiez une clé API depuis le tableau de bord Helius.
2
Ask a question
Remplacez
YOUR_API_KEY et exécutez :cURL
-N permet à curl d’afficher chaque événement dès son arrivée. Le premier événement peut prendre jusqu’à 10 secondes.3
Read the answer
La réponse est un flux d’événements :La réponse correspond aux fragments
text_delta, dans l’ordre. lana-thinking peut aussi envoyer des fragments thinking_delta : il s’agit du raisonnement de Lana. Affichez-le séparément de la réponse ou ignorez-le.Lire le flux dans le code
Les deux exemples vérifient le statut HTTP avant de lire le corps comme un flux, attendentRetry-After lors d’un 429 ou 503, affichent la réponse à mesure qu’elle arrive et s’arrêtent si le tour échoue ou si le flux se termine prématurément.
Différences avec l’API Messages d’Anthropic
- Les modèles sont
lana-thinkingetlana-fast. - Lana exécute ses propres outils.
tools,tool_choice,temperature,top_p,top_k,stop_sequencesetmetadatarenvoient400. systemest ajouté aux instructions de Lana.max_tokensest facultatif (valeur par défaut et maximale : 8 192), et les images doivent être des URL.- Les événements sont différents. Il n’existe aucun
content_block_start,content_block_stop,message_deltaoumessage_stop. Le flux se termine parmessage_endouerror. usageajoutetool_calls,prompt_tokensetcontext_window.stop_reasonpeut êtreerror.extensionsest propre à Lana.
Endpoint et authentification
Authorization: Bearer ne fonctionne pas sur cet endpoint et renvoie 401.
mainnet.helius-rpc.com ne dessert pas encore cette route et renvoie 503.
Envoyez Content-Type: application/json avec chaque requête.
Corps de la requête
Le corps est un objet JSON. Les champs inconnus sont rejetés avec400, y compris ceux qui se trouvent dans extensions et dans les blocs de contenu.
lana-thinking ou lana-fast. Consultez la section Modèles.La conversation, de la plus ancienne à la plus récente. Elle doit contenir au moins un message, et le dernier doit avoir
role: "user". Consultez la section Messages.Nombre maximal de tokens de sortie que Lana peut écrire en une étape de modèle, de
1 à 8192. Un tour avec des recherches comporte plusieurs étapes. Le output_tokens total du tour peut donc être supérieur à max_tokens. En dessous de 2 048, lana-thinking ne raisonne pas.true diffuse les événements. false renvoie une seule réponse JSON à la fin du tour.Instructions supplémentaires de 1 à 10 000 caractères, par exemple « Répondez en trois points. » Elles sont ajoutées aux instructions propres à Lana et ne les remplacent pas.
Options propres à Lana. Consultez la section Extensions.
Modèles
lana-thinking ne raisonne que lorsque max_tokens est supérieur ou égal à 2048.
Messages
Chaque message possède unrole (user ou assistant) et un content :
assistant :
extensions.user_context.wallet.
content est une chaîne non vide ou un tableau non vide de blocs :
Les images doivent être des URL. Les images en Base64 ne sont pas prises en charge.
Vous n’avez pas besoin des blocs
tool_use ou tool_result. Ils permettent de rejouer les recherches d’un tour précédent telles que Lana les a renvoyées, afin qu’elle puisse réutiliser ces résultats. tool_result accepte également un booléen facultatif is_error.
Extensions
Toutes les extensions sont facultatives.
Les options
include_* rendent la sortie possible. Lana décide de l’envoyer ou non.
extensions accepte également progress_context et transaction_filter_context. L’explorateur Orb les utilise, mais vous n’en avez pas besoin.
Champs de user_context :
Événements en streaming
Avec"stream": true, vous obtenez le statut 200 et Content-Type: text/event-stream. Chaque événement se présente ainsi :
data correspond à une ligne de JSON. Son type correspond au nom event.
Le 200 et les premiers événements arrivent lorsque Lana répond pour la première fois (raisonnement, texte de réponse, recherche ou fichier), ou après 10 secondes au maximum. Rien n’est envoyé avant cela. Une requête qui échoue pendant cette période reçoit donc une réponse d’erreur normale et n’est pas facturée. Ensuite, un ping arrive toutes les 10 secondes pendant que Lana travaille.
Définissez le délai d’expiration de lecture de votre client HTTP sur au moins 30 secondes. Une valeur par défaut de 5 secondes, comme dans httpx, est trop courte : le délai peut expirer avant le premier octet ou entre deux événements.
Les événements arrivent dans cet ordre :
message_start, toujours en premier.- Toute combinaison de
content_block_delta,tool_use,tool_result,source,ui_block,document,progress_updateetping. ui_schema, au plus une fois.follow_up, au plus une fois.message_endsi le tour s’est terminé, ouerrors’il a échoué. Il s’agit toujours du dernier événement.
Conseils pour afficher un flux :
- Utilisez
tool_useuniquement pour les indicateurs de progression. Les noms et les entrées des outils peuvent changer. - Avec la sortie
"markdown", transformez chaque{{cite:N}}en lien vers lesourceportant ceindex, ou supprimez-le. ui_blocketui_schematransportent les mêmes composants. Lana peut n’envoyer queui_schema. Affichez donc les événementsui_blocks’ils arrivent ; sinon, affichezui_schema.- Les recherches web envoient un
tool_resultavec le texteWeb search completed.ouWeb fetch completed.. Les pages arrivent sous forme d’événementssource.
Erreurs d’outil
L’échec d’une recherche ne fait pas échouer le tour. Lana le contourne et vous n’avez pas besoin de réessayer. Letool_result contient is_error: true, et content est un objet JSON comportant un court message et un code :
Tool error codes
Tool error codes
De nouveaux codes peuvent être ajoutés. Traitez tout code inconnu comme
internal.Motifs d’arrêt
stop_reason figure dans message_end et dans la réponse JSON :
Utilisation
Les instructions et les outils de recherche propres à Lana occupent environ 45 000 tokens à chaque étape du modèle.
input_tokens est donc élevé même pour une courte question. La tarification s’effectue par requête : le nombre de tokens ne modifie pas le prix payé.
Réponse sans streaming
Avec"stream": false, vous recevez un objet JSON à la fin du tour :
text, concaténés dans l’ordre. Le raisonnement et progress_update sont disponibles uniquement en streaming.
Ces champs apparaissent uniquement lorsqu’ils ont une valeur :
Erreurs
Avant le démarrage du flux
Une requête qui échoue avant le début de la réponse renvoie un statut différent de200 avec un corps d’erreur normal, même avec "stream": true. Aucun événement n’est envoyé et la requête n’est pas facturée. Vérifiez le statut HTTP avant de lire le corps comme un flux.
Avec "stream": true, la réponse commence lorsque Lana répond pour la première fois, ou après 10 secondes au maximum. Un tour qui échoue avant cela, par exemple parce que le modèle est surchargé ou que la conversation est trop longue, relève également de ce cas.
Les deux premiers
429 proviennent de votre offre, et le corps de la réponse indique lequel vous avez rencontré. Le troisième provient de Lana et possède un corps JSON.
Si un 429 ou 503 arrive sans en-tête Retry-After, attendez quelques secondes avant de réessayer.
Les erreurs propres à Lana (400 pour un corps non valide ou context_overflow, 429 avec rate_limit_error, 500, 502, 503, 504 et 529) possèdent un corps JSON. Les erreurs de Gatekeeper (401, 403, 400 pour un corps trop volumineux et les 429 de l’offre) sont en texte brut. Effectuez le branchement selon error.type, et non selon message :
Après le démarrage du flux
Le statut est déjà200. Un échec termine donc le flux par un événement final error, ou par message_end avec stop_reason: "error". Ce message_end ne contient aucun objet error ; traitez-le comme un api_error. Tout texte de réponse qui le précède est partiel. Affichez-le comme incomplet ou supprimez-le.
Sans streaming
Avec"stream": false, un tour qui échoue renvoie l’un des résultats suivants :
200avecstop_reason: "error"et un objeterror, lorsque le tour a produit du contenu, y compris des recherches. Vérifiez toujoursstop_reason.- Un corps d’erreur JSON, lorsque le tour n’a rien produit. Le statut correspond à
error.type:400pourcontext_overflow,500pourapi_error,502pourtool_error,504pourtimeout_errorou529pouroverloaded_error(le statut utilisé par Anthropic pour un modèle surchargé ; certains clients HTTP ne le reconnaissent pas, traitez-le donc comme503). Ces requêtes ne sont pas facturées. Gérez-les comme indiqué dans Types d’erreurs.
Types d’erreurs
Traitez tout autre type comme
api_error.
Limites
Lorsqu’un tour approche des 5 minutes, Lana arrête les recherches et répond avec les informations dont elle dispose. Les longs tours se terminent généralement par une réponse partielle qui indique les éléments manquants, et non par une expiration du délai.
En streaming, définissez le délai d’expiration de lecture de votre client HTTP sur au moins 30 secondes. Le premier octet peut prendre jusqu’à 10 secondes, puis un
ping arrive toutes les 10 secondes. Un intervalle beaucoup plus long indique donc que la connexion a été interrompue. Une valeur par défaut de 5 secondes, comme dans httpx, est trop courte. Sans streaming, rien n’arrive avant la fin du tour. Définissez donc le délai d’expiration de lecture sur plus de 5 minutes.
Si vous vous déconnectez, Lana arrête le tour. Une requête dont le flux a déjà commencé reste facturée.
Lorsque Lana a atteint sa capacité maximale, les nouvelles requêtes reçoivent 503 avant le début du flux. Elles ne sont pas facturées. Réessayez après la durée indiquée par l’en-tête Retry-After.
Tarification
Chaque requête coûte un prix fixe qui dépend du modèle :
Le prix est identique pour les requêtes avec ou sans streaming et pour toutes les offres payantes (Developer et supérieures). Lana n’est pas disponible avec l’offre Free.
Les crédits proviennent de votre offre. Consultez la section Crédits.
Ce qui est facturé
Chaque requête qui reçoit le statut HTTP200 est facturée, avec ou sans streaming, quelle que soit l’issue du tour. Les requêtes qui échouent avant le début de la réponse reçoivent un autre statut et sont gratuites.
- Un tour en streaming qui échoue avec un événement
error, ou dont vous vous déconnectez après son démarrage, est facturé : le statut était déjà200. - Une requête rejetée avant le début du tour (
400,401,403,429,503) est gratuite. - Un tour qui échoue avant le début de la réponse (
400,5xx), avec ou sans streaming, est gratuit.
Autres exemples
Définir le ton et le portefeuille de l’utilisateur
cURL
Analyser tout l’historique d’un portefeuille
cURL
Obtenir des composants d’interface, des questions complémentaires et un fichier CSV
cURL
Étapes suivantes
API Reference
Schéma de la requête et de la réponse, avec un espace de test.
Rate Limits
Limites de débit de Lana pour chaque offre.
Credits
Comment les requêtes Lana utilisent les crédits de votre offre.
Contact Support
Obtenez de l’aide via Discord, le chat ou l’e-mail.