メインコンテンツへスキップ
POST
各リクエストには、lana-thinking の場合は 10,000 クレジット、lana-fast の場合は 2,000 クレジットが必要です。 有料プランが必要です。無料プランのリクエストでは 403 Forbidden が返されます。 クイックスタート、ストリーミングイベント、エラー処理については、Lana API ガイドを参照してください。

リクエストパラメータ

string
必須
複数ステップの分析には lana-thinking を使用します。1 ターンあたり最大 20 回の検索ステップを実行でき、推論をストリーミングできます。簡単な検索や単一の事実の確認には lana-fast を使用します。1 ターンあたり最大 4 回の検索ステップを実行できます。
  • lana-thinking
  • lana-fast
array
必須
古いものから順に並べた会話です。少なくとも 1 件のメッセージが必要で、最後のメッセージには role user が必要です。API は会話を保存しないため、リクエストのたびに会話全体を送信してください。
string
必須
メッセージの作成者です。
  • user
  • assistant
any
必須
空でない文字列、または空でないコンテンツブロックの配列です。text は両方のロールで使用できます。image と tool_result は user メッセージでのみ、tool_use は assistant メッセージでのみ使用できます。
number
デフォルト:"8192"
1 回のモデルステップで Lana が出力できるトークンの最大数です。検索を伴うターンでは複数のステップが実行されるため、ターン全体の output_tokens はこれより多くなる場合があります。2,048 未満では、lana-thinking は推論を行いません。
boolean
デフォルト:"false"
true はサーバー送信イベントをストリーミングします。false はターンの終了時に 1 つの JSON オブジェクトを返します。
string
「3 つの箇条書きで回答してください。」などの追加指示です。これらは Lana 独自の指示に追加されるものであり、その代わりに使用されるものではありません。
object
Lana 専用のオプションです。すべて任意です。include_* オプションを指定すると出力が可能になりますが、送信するかどうかは Lana が判断します。
boolean
デフォルト:"true"
送金、スワップ、トークンローンチのツールを削除します。true のままにしてください。
string
デフォルト:"markdown"
plain を指定すると、Lana は Markdown を使用せず、{{cite:N}} マーカーも削除します。source イベントは引き続き受信されます。
  • markdown
  • plain
boolean
デフォルト:"false"
ui_block および ui_schema イベントとして UI コンポーネントを送信できるようにします。
boolean
デフォルト:"false"
提案されるフォローアップ質問を最大 3 件まで送信できるようにします。
boolean
デフォルト:"false"
ダウンロード可能な CSV、JSON、またはテキストファイルを document イベントとして送信できるようにします。
boolean
デフォルト:"false"
Lana がアドレスの履歴から最大 10,000 件のトランザクション(件数と合計値の場合は 50,000 件)を読み取れるようにします。1 ターンあたり最大 3 回スキャンできます。メインネットでのみ使用できます。これを指定しない場合、Lana は 1 回の検索につき最大 100 件のトランザクションを読み取ります。料金は同じ固定価格です。
object
質問者の情報です。
string
ユーザーのアドレスです。これにより、「私のウォレット」や「私の残高」を使用できます。
string
wallet または token:wallet が何であるかを指定します。wallet が必要です。
string
America/New_York などの IANA タイムゾーンです。これにより、「今日」を使用できます。
string
デフォルト:"mainnet"
検索対象のネットワークです。
  • mainnet
  • devnet
array
最後のユーザーメッセージに追加する画像です。最大 8 枚まで指定できます。messages 内の image ブロックは、この上限にはカウントされません。
string
必須
画像の URL です。
string
必須
常に image です。
  • image
object
Orb エクスプローラーで使用されます。指定する必要はありません。
object
Orb エクスプローラーで使用されます。指定する必要はありません。

承認

X-Api-Key
string
header
必須

Helius API キーです。

ボディ

application/json
model
enum<string>
必須

複数ステップの分析には lana-thinking を使用します。ターンごとに最大 20 回の検索ステップを実行でき、推論をストリーミングできます。簡単な検索や単一の事実には lana-fast を使用します。ターンごとに最大 4 回の検索ステップを実行できます。

利用可能なオプション:
lana-thinking,
lana-fast
例:

"lana-thinking"

messages
object[]
必須

古い順に並べた会話です。少なくとも 1 件のメッセージが必要で、最後のメッセージの role は user でなければなりません。API は会話を保存しないため、リクエストごとに会話全体を送信してください。

Minimum array length: 1
max_tokens
integer
デフォルト:8192

1 回のモデルステップで Lana が生成できる出力トークンの最大数です。検索を伴うターンは複数のステップを実行するため、ターン全体の output_tokens はこれを上回る場合があります。2,048 未満では、lana-thinking は推論しません。

必須範囲: 1 <= x <= 8192
stream
boolean
デフォルト:false

true の場合、サーバー送信イベントをストリーミングします。false の場合、ターンの終了時に 1 つの JSON オブジェクトを返します。

system
string

「3 つの箇条書きで回答してください。」などの追加指示です。Lana 独自の指示を置き換えるのではなく、それらに追加されます。

Required string length: 1 - 10000
extensions
object

Lana 専用のオプションです。すべて任意です。include_* オプションは出力を可能にしますが、送信するかどうかは Lana が判断します。

レスポンス

ターンが実行されました。"stream": false の場合は 1 つの JSON オブジェクトです。stop_reason を確認してください。 コンテンツの生成後に失敗したターンでも 200 が返され、stop_reason: "error" と error オブジェクトが含まれます。

"stream": true の場合は、サーバー送信イベントのストリームです。各イベントは event: <type> 行と data: <json> 行で構成され、その後に空行が続きます。ストリームは message_start で始まり、必ず message_end または error で終了します。新しいイベントの 種類やフィールドが追加される可能性があります。認識できないものは無視してください。

非ストリーミングレスポンスです。回答は text ブロックを順番に連結したものです。

id
string
必須
例:

"msg_3f9c..."

type
enum<string>
必須
利用可能なオプション:
message
role
enum<string>
必須
利用可能なオプション:
assistant
model
enum<string>
必須
利用可能なオプション:
lana-thinking,
lana-fast
content
object[]
必須
stop_reason
enum<string>
必須
  • end_turn: Lana が回答を完了しました。
  • max_tokens: 回答が max_tokens に達し、途中で切れている可能性があります。
  • tool_use: ターンが検索ステップで終了しました。通常はステップ上限に達したためです。
  • error: ターンが失敗しました。回答は不完全です。
利用可能なオプション:
end_turn,
max_tokens,
tool_use,
error
usage
object
必須
ui_schema
object

すべての UI コンポーネントを 1 つのツリーとして表します。include_ui_schema が有効で、表示するものがある場合に存在します。

documents
object[]

include_documents が有効で、Lana がファイルを作成した場合に存在します。

follow_up
string[]

include_followups が有効で、Lana が質問を提案した場合に存在します。

sources
object[]

Lana がウェブページを使用した場合に存在します。

error
object