Passer au contenu principal
L’API Lana est un agent IA Solana que vous appelez via HTTP. Vous lui envoyez une question en langage naturel, et elle recherche pour vous des portefeuilles, des tokens, des transactions et des prix, puis renvoie une réponse en streaming. Lana exécute chaque recherche côté Helius. Vous n’avez donc aucun outil à définir ni à exécuter. Elle est disponible avec les offres Helius payantes (Developer et supérieures), à un prix fixe par requête : 10 000 crédits pour 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 ? »
Transmettez le portefeuille de l’utilisateur dans 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, attendent Retry-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-thinking et lana-fast.
  • Lana exécute ses propres outils. tools, tool_choice, temperature, top_p, top_k, stop_sequences et metadata renvoient 400.
  • system est ajouté aux instructions de Lana.
  • max_tokens est 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_delta ou message_stop. Le flux se termine par message_end ou error.
  • usage ajoute tool_calls, prompt_tokens et context_window. stop_reason peut être error.
  • extensions est propre à Lana.

Endpoint et authentification

Envoyez votre clé API Helius de l’une des manières suivantes : 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.
Votre clé API consomme les crédits de votre offre. Appelez Lana depuis votre serveur, et non depuis un navigateur ou une application distribuée aux utilisateurs.

Corps de la requête

Le corps est un objet JSON. Les champs inconnus sont rejetés avec 400, y compris ceux qui se trouvent dans extensions et dans les blocs de contenu.
string
requis
lana-thinking ou lana-fast. Consultez la section Modèles.
object[]
requis
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.
integer
défaut:"8192"
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.
boolean
défaut:"false"
true diffuse les événements. false renvoie une seule réponse JSON à la fin du tour.
string
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.
object
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 un role (user ou assistant) et un content :
L’API ne stocke pas les conversations. Pour poser une question complémentaire, renvoyez toute la conversation en ajoutant la nouvelle question à la fin. Le texte de la réponse de Lana suffit pour les tours assistant :
Lana recherche uniquement les adresses qui apparaissent dans la conversation, dans ses propres résultats de recherche ou dans 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 :
  1. message_start, toujours en premier.
  2. Toute combinaison de content_block_delta, tool_use, tool_result, source, ui_block, document, progress_update et ping.
  3. ui_schema, au plus une fois.
  4. follow_up, au plus une fois.
  5. message_end si le tour s’est terminé, ou error s’il a échoué. Il s’agit toujours du dernier événement.
De nouveaux types d’événements et champs peuvent être ajoutés. Ignorez ceux que vous ne reconnaissez pas. Conseils pour afficher un flux :
  • Utilisez tool_use uniquement 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 le source portant ce index, ou supprimez-le.
  • ui_block et ui_schema transportent les mêmes composants. Lana peut n’envoyer que ui_schema. Affichez donc les événements ui_block s’ils arrivent ; sinon, affichez ui_schema.
  • Les recherches web envoient un tool_result avec le texte Web search completed. ou Web fetch completed.. Les pages arrivent sous forme d’événements source.

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. Le tool_result contient is_error: true, et content est un objet JSON comportant un court message et un code :
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 :
La réponse correspond aux blocs 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 de 200 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 :
  • 200 avec stop_reason: "error" et un objet error, lorsque le tour a produit du contenu, y compris des recherches. Vérifiez toujours stop_reason.
  • Un corps d’erreur JSON, lorsque le tour n’a rien produit. Le statut correspond à error.type : 400 pour context_overflow, 500 pour api_error, 502 pour tool_error, 504 pour timeout_error ou 529 pour overloaded_error (le statut utilisé par Anthropic pour un modèle surchargé ; certains clients HTTP ne le reconnaissent pas, traitez-le donc comme 503). 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 HTTP 200 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.