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 専用です。
エンドポイントと認証
Authorization: Bearer はこのエンドポイントでは機能せず、401 を返します。
mainnet.helius-rpc.com はまだこのルートを提供しておらず、503 を返します。
すべてのリクエストで Content-Type: application/json を送信してください。
リクエスト本文
本文は JSON オブジェクトです。extensions 内やコンテンツブロック内の不明なフィールドを含め、不明なフィールドは 400 で拒否されます。
lana-thinking または lana-fast です。モデルを参照してください。古いものから順に並べた会話です。少なくとも 1 件のメッセージが必要で、最後のメッセージには
role: "user" が必要です。メッセージを参照してください。Lana が 1 回のモデルステップで出力できるトークンの最大数です。範囲は
1 から 8192 です。検索を伴うターンは複数のステップを使用するため、ターン全体の output_tokens が max_tokens を上回る場合があります。2,048 未満では、lana-thinking は推論しません。true はイベントをストリームします。false はターンの終了時に 1 件の JSON レスポンスを返します。Lana 専用のオプションです。拡張機能を参照してください。
モデル
lana-thinking は、max_tokens が 2048 以上の場合にのみ推論します。
メッセージ
各メッセージにはrole(user または assistant)と content があります。
assistant ターンには 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 つのイベントの間に期限切れになる可能性があります。
イベントは次の順序で到着します。
message_start。常に最初です。content_block_delta、tool_use、tool_result、source、ui_block、document、progress_update、pingの任意の組み合わせ。ui_schema。最大 1 回です。follow_up。最大 1 回です。- ターンが完了した場合は
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 です。
Tool error codes
Tool error codes
新しいコードが追加される場合があります。不明なコードは
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 を利用できません。
クレジットはプランから消費されます。クレジットを参照してください。
課金対象
ストリーミングの有無やターンの終了方法にかかわらず、HTTP200 を受け取ったすべてのリクエストに課金されます。レスポンス開始前に失敗したリクエストは別のステータスを受け取り、無料です。
errorイベントで失敗したストリーミングターンや、開始後に接続を切断したストリーミングターンには課金されます。ステータスがすでに200であるためです。- ターン開始前に拒否されたリクエスト(
400、401、403、429、503)は無料です。 - ストリーミングの有無にかかわらず、レスポンス開始前に失敗したターン(
400、5xx)は無料です。
その他の例
口調とユーザーのウォレットを設定する
cURL
ウォレットの全履歴をスキャンする
cURL
UI コンポーネント、追加質問、CSV を取得する
cURL
次のステップ
API Reference
プレイグラウンド付きのリクエストおよびレスポンススキーマです。
Rate Limits
Lana のプラン別レート制限です。
Credits
Lana のリクエストがプランのクレジットをどのように使用するかを説明します。
Contact Support
Discord、チャット、またはメールでサポートを受けられます。