メインコンテンツへスキップ
Lana API は、HTTP 経由で呼び出す Solana AI エージェントです。平易な英語で質問を送信すると、ウォレット、トークン、トランザクション、価格を検索し、回答をストリームで返します。 Lana はすべての検索を Helius 側で実行するため、ツールを定義または実行する必要はありません。有料の Helius プラン(Developer 以上)で利用でき、リクエストごとの固定料金は lana-thinking が 10,000 クレジット、lana-fast が 2,000 クレジットです。料金を参照してください。 この API は Anthropic Messages API に似た形式ですが、Anthropic SDK は使用できません。以下の例のように、通常の HTTP 経由で呼び出してください。Anthropic Messages API との違いを参照してください。 Lana は Anthropic の Claude モデル上で動作します。回答を生成するため、質問と会話が Anthropic に送信されます。
Lana API は Gatekeeper(ベータ)エンドポイント beta.helius-rpc.com でベータ版として提供されています。mainnet.helius-rpc.com ではまだ利用できません。ベータ期間中に新しいイベントやフィールドが追加される場合があります。

Lana に質問できること

ユーザーは、自分の取引や取引相手のウォレットについて次のように質問できます。
  • 「最後のトランザクションが失敗したのはなぜですか?」
  • 「このスワップのスリッページはいくらでしたか?」
  • 「このトランザクションで支払った手数料はいくらですか?」
  • 「このウォレットはどこから資金を受け取り、どこへ送金しましたか?」
  • 「このウォレットは別のこのウォレットと関連していますか?」
  • 「このトークンの最大保有者は誰ですか?」
「自分の」ウォレットや「自分の最後のトランザクション」についての質問が機能するように、ユーザーのウォレットを extensions.user_context.wallet で渡してください。

クイックスタート

1

Get an API key

Helius Dashboard から API キーをコピーします。
2

Ask a question

YOUR_API_KEY を置き換えて実行します。
cURL
-N を指定すると、各イベントが到着した時点で curl が出力します。最初のイベントが届くまで最大 10 秒かかる場合があります。
3

Read the answer

レスポンスはイベントのストリームです。
回答は、順番に並んだ text_delta チャンクです。lana-thinking は thinking_delta チャンクも送信できます。これは Lana の推論なので、回答とは分けて表示するか、スキップしてください。

コードでストリームを読み取る

どちらの例も、本文をストリームとして読み取る前に HTTP ステータスを確認し、429 または 503 の場合は Retry-After を待ち、ストリームされる回答を出力し、ターンが失敗するかストリームが途中で終了した場合は停止します。

Anthropic Messages API との違い

  • モデルは lana-thinking と lana-fast です。
  • Lana は独自のツールを実行します。tools、tool_choice、temperature、top_p、top_k、stop_sequences、metadata は 400 を返します。
  • system は Lana の指示に追加されます。
  • max_tokens は任意です(デフォルト値と最大値は 8,192)。画像には URL を使用する必要があります。
  • イベントは異なります。content_block_start、content_block_stop、message_delta、message_stop はありません。ストリームは message_end または error で終了します。
  • usage には tool_calls、prompt_tokens、context_window が追加されます。stop_reason は error になる場合があります。
  • extensions は Lana 専用です。

エンドポイントと認証

Helius API キーを次のいずれかの方法で送信します。 Authorization: Bearer はこのエンドポイントでは機能せず、401 を返します。 mainnet.helius-rpc.com はまだこのルートを提供しておらず、503 を返します。 すべてのリクエストで Content-Type: application/json を送信してください。
API キーを使用すると、プランのクレジットが消費されます。Lana は、ブラウザやユーザーに配布するアプリからではなく、サーバーから呼び出してください。

リクエスト本文

本文は JSON オブジェクトです。extensions 内やコンテンツブロック内の不明なフィールドを含め、不明なフィールドは 400 で拒否されます。
string
必須
lana-thinking または lana-fast です。モデルを参照してください。
object[]
必須
古いものから順に並べた会話です。少なくとも 1 件のメッセージが必要で、最後のメッセージには role: "user" が必要です。メッセージを参照してください。
integer
デフォルト:"8192"
Lana が 1 回のモデルステップで出力できるトークンの最大数です。範囲は 1 から 8192 です。検索を伴うターンは複数のステップを使用するため、ターン全体の output_tokens が max_tokens を上回る場合があります。2,048 未満では、lana-thinking は推論しません。
boolean
デフォルト:"false"
true はイベントをストリームします。false はターンの終了時に 1 件の JSON レスポンスを返します。
string
1~10,000 文字の追加指示です。たとえば「3 つの箇条書きで回答してください。」と指定できます。これは Lana 独自の指示に追加され、その代わりに使用されるわけではありません。
object
Lana 専用のオプションです。拡張機能を参照してください。

モデル

lana-thinking は、max_tokens が 2048 以上の場合にのみ推論します。

メッセージ

各メッセージには role(user または assistant)と content があります。
API は会話を保存しません。追加の質問をするには、新しい質問を末尾に追加し、会話全体を再送信してください。assistant ターンには Lana の回答テキストだけで十分です。
Lana が検索するのは、会話内、独自の検索結果内、または extensions.user_context.wallet に出現するアドレスだけです。 content は、空でない文字列または空でないブロック配列です。 画像には URL を使用する必要があります。Base64 画像はサポートされていません。 tool_use または tool_result ブロックは必須ではありません。これらを使用すると、Lana が以前のターンで返した検索を再現し、その結果を再利用できます。tool_result は、任意のブール値 is_error も受け取ります。

拡張機能

すべての拡張機能は任意です。 include_* オプションは、出力を可能にします。送信するかどうかは Lana が決定します。 extensions は progress_context と transaction_filter_context も受け取ります。Orb エクスプローラーで使用されていますが、これらは不要です。 user_context のフィールド:

ストリーミングイベント

"stream": true を使用すると、ステータス 200 と Content-Type: text/event-stream を受け取ります。各イベントは次の形式です。
data は 1 行の JSON です。その type は event 名と一致します。 200 と最初のイベントは、Lana が最初に応答したとき(推論、回答テキスト、検索、またはファイル)、遅くとも 10 秒後に到着します。それまでは何も送信されないため、その間に失敗したリクエストは通常のエラーレスポンスを受け取り、課金されません。その後、Lana の処理中は 10 秒ごとに ping が到着します。 HTTP クライアントの読み取りタイムアウトを 30 秒以上に設定してください。httpx のようなデフォルトの 5 秒では短すぎます。最初のバイトが届く前や、2 つのイベントの間に期限切れになる可能性があります。 イベントは次の順序で到着します。
  1. message_start。常に最初です。
  2. content_block_delta、tool_use、tool_result、source、ui_block、document、progress_update、ping の任意の組み合わせ。
  3. ui_schema。最大 1 回です。
  4. follow_up。最大 1 回です。
  5. ターンが完了した場合は message_end、失敗した場合は error。これは常に最後のイベントです。
新しいイベントタイプやフィールドが追加される場合があります。認識できないものは無視してください。 ストリームを表示する際のヒント:
  • tool_use は進行状況の表示にのみ使用してください。ツール名と入力は変更される可能性があります。
  • "markdown" 出力では、各 {{cite:N}} を、その index を持つ source へのリンクに変換するか、削除してください。
  • ui_block と ui_schema には同じコンポーネントが含まれます。Lana が ui_schema のみを送信する場合があるため、ui_block イベントが到着した場合はそれを表示し、それ以外の場合は ui_schema をレンダリングしてください。
  • Web 検索は、テキスト Web search completed. または Web fetch completed. を含む tool_result を送信します。ページは source イベントとして到着します。

ツールエラー

検索が失敗しても、ターン全体は失敗しません。Lana が回避処理を行うため、再試行する必要はありません。tool_result には is_error: true があり、content は短いメッセージと code を含む JSON です。
新しいコードが追加される場合があります。不明なコードは internal として扱ってください。

停止理由

stop_reason は message_end と JSON レスポンスに含まれます。

使用量

Lana 独自の指示と検索ツールは、各モデルステップで約 45,000 トークンを使用するため、短い質問でも input_tokens は大きくなります。料金はリクエスト単位なので、トークン数によって支払額は変わりません。

非ストリーミングレスポンス

"stream": false を使用すると、ターン終了時に 1 つの JSON オブジェクトを受け取ります。
回答は、text ブロックを順番に連結したものです。推論と progress_update はストリーミングでのみ利用できます。 次のフィールドは、値がある場合にのみ表示されます。

エラー

ストリーム開始前

レスポンス開始前に失敗したリクエストは、"stream": true を指定していても、200 以外のステータスと通常のエラー本文を返します。イベントは送信されず、課金もされません。本文をストリームとして読み取る前に HTTP ステータスを確認してください。 "stream": true を使用すると、Lana が最初に応答した時点、遅くとも 10 秒後にレスポンスが開始します。モデルの過負荷や会話が長すぎるなどの理由で、それ以前に失敗したターンもここに該当します。 最初の 2 種類の 429 はプランに由来し、レスポンス本文にどちらに該当したかが示されます。3 つ目は Lana に由来し、JSON 本文を持ちます。 429 または 503 に Retry-After ヘッダーがない場合は、数秒待ってから再試行してください。 Lana 独自のエラー(無効な本文または context_overflow に対する 400、rate_limit_error を伴う 429、500、502、503、504、529)には JSON 本文があります。Gatekeeper からのエラー(401、403、本文超過の 400、プラン由来の 429)はプレーンテキストです。message ではなく error.type で分岐してください。

ストリーム開始後

ステータスはすでに 200 であるため、失敗時には最後の error イベント、または stop_reason: "error" を伴う message_end でストリームが終了します。この message_end には error オブジェクトがありません。api_error と同様に扱ってください。それ以前の回答テキストは部分的なものです。不完全な回答として表示するか、破棄してください。

ストリーミングを使用しない場合

"stream": false を使用した場合、失敗したターンは次のいずれかを返します。
  • ターンが検索を含む何らかのコンテンツを生成した場合は、stop_reason: "error" と error オブジェクトを伴う 200。必ず stop_reason を確認してください。
  • ターンが何も生成しなかった場合は、JSON エラー本文。ステータスは error.type と一致します。context_overflow の場合は 400、api_error の場合は 500、tool_error の場合は 502、timeout_error の場合は 504、overloaded_error の場合は 529 です(これはモデル過負荷時に Anthropic が使用するステータスです。一部の HTTP クライアントは認識しないため、503 と同様に処理してください)。これらは課金されません。エラータイプの説明に従って処理してください。

エラータイプ

その他のタイプはすべて api_error と同様に扱ってください。

制限

ターンが 5 分に近づくと、Lana は検索を停止し、それまでに取得した情報で回答します。長いターンは通常、タイムアウトではなく、不足している情報を示す部分的な回答で終了します。 ストリーミング時は、HTTP クライアントの読み取りタイムアウトを 30 秒以上に設定してください。最初のバイトが届くまで最大 10 秒かかり、その後は 10 秒ごとに ping が到着します。そのため、これより大幅に長い間隔が空いた場合は接続が切断されています。httpx のようなデフォルトの 5 秒では短すぎます。ストリーミングを使用しない場合、ターンが終了するまで何も届かないため、読み取りタイムアウトを 5 分より長く設定してください。 接続を切断すると、Lana はターンを停止します。ストリームがすでに開始されているリクエストには引き続き課金されます。 Lana が処理上限に達している場合、新しいリクエストはストリームが始まる前に 503 を受け取ります。これらは課金されません。Retry-After ヘッダーの時間が経過した後に再試行してください。

料金

各リクエストには、モデルに応じた固定料金がかかります。 ストリーミングと非ストリーミングのリクエストで料金は同じで、すべての有料プラン(Developer 以上)でも同一です。Free プランでは Lana を利用できません。 クレジットはプランから消費されます。クレジットを参照してください。

課金対象

ストリーミングの有無やターンの終了方法にかかわらず、HTTP 200 を受け取ったすべてのリクエストに課金されます。レスポンス開始前に失敗したリクエストは別のステータスを受け取り、無料です。
  • error イベントで失敗したストリーミングターンや、開始後に接続を切断したストリーミングターンには課金されます。ステータスがすでに 200 であるためです。
  • ターン開始前に拒否されたリクエスト(400、401、403、429、503)は無料です。
  • ストリーミングの有無にかかわらず、レスポンス開始前に失敗したターン(400、5xx)は無料です。

その他の例

口調とユーザーのウォレットを設定する

cURL

ウォレットの全履歴をスキャンする

cURL

UI コンポーネント、追加質問、CSV を取得する

cURL

次のステップ

API Reference

プレイグラウンド付きのリクエストおよびレスポンススキーマです。

Rate Limits

Lana のプラン別レート制限です。

Credits

Lana のリクエストがプランのクレジットをどのように使用するかを説明します。

Contact Support

Discord、チャット、またはメールでサポートを受けられます。