Lana API
Lana メッセージを作成する
Solana AI エージェントの Lana に質問し、イベントのストリームまたは単一の JSON レスポンスとして回答を取得します。
POST
/
v1
/
lana
/
messages
curl --request POST \
--url https://beta.helius-rpc.com/v1/lana/messages \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"model": "lana-thinking",
"messages": [
{
"role": "user",
"content": "現在の SOL の価格はいくらですか?"
}
],
"extensions": {
"read_only": true
}
}
'{
"id": "msg_3f9c...",
"type": "message",
"role": "assistant",
"model": "lana-thinking",
"content": [
{
"type": "tool_use",
"id": "toolu_01...",
"name": "...",
"input": {
"mint": "So11111111111111111111111111111111111111112"
}
},
{
"type": "tool_result",
"tool_use_id": "toolu_01...",
"content": "{\"price\":..."
},
{
"type": "text",
"text": "SOL は ... で取引されています"
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 90800,
"output_tokens": 96,
"tool_calls": 1,
"prompt_tokens": 45600,
"context_window": 200000
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "max_tokens: max_tokens must be <= 8192"
}
}<string><string>{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}各リクエストには、
lana-thinking の場合は 10,000 クレジット、lana-fast の場合は 2,000 クレジットが必要です。
有料プランが必要です。無料プランのリクエストでは 403 Forbidden が返されます。
クイックスタート、ストリーミングイベント、エラー処理については、Lana API ガイドを参照してください。
リクエストパラメータ
複数ステップの分析には
lana-thinking を使用します。1 ターンあたり最大 20 回の検索ステップを実行でき、推論をストリーミングできます。簡単な検索や単一の事実の確認には lana-fast を使用します。1 ターンあたり最大 4 回の検索ステップを実行できます。lana-thinkinglana-fast
古いものから順に並べた会話です。少なくとも 1 件のメッセージが必要で、最後のメッセージには
role user が必要です。API は会話を保存しないため、リクエストのたびに会話全体を送信してください。空でない文字列、または空でないコンテンツブロックの配列です。
text は両方のロールで使用できます。image と tool_result は user メッセージでのみ、tool_use は assistant メッセージでのみ使用できます。1 回のモデルステップで Lana が出力できるトークンの最大数です。検索を伴うターンでは複数のステップが実行されるため、ターン全体の
output_tokens はこれより多くなる場合があります。2,048 未満では、lana-thinking は推論を行いません。plain を指定すると、Lana は Markdown を使用せず、{{cite:N}} マーカーも削除します。source イベントは引き続き受信されます。markdownplain
Lana がアドレスの履歴から最大 10,000 件のトランザクション(件数と合計値の場合は 50,000 件)を読み取れるようにします。1 ターンあたり最大 3 回スキャンできます。メインネットでのみ使用できます。これを指定しない場合、Lana は 1 回の検索につき最大 100 件のトランザクションを読み取ります。料金は同じ固定価格です。
ボディ
application/json
レスポンス
ターンが実行されました。"stream": false の場合は 1 つの JSON オブジェクトです。stop_reason を確認してください。
コンテンツの生成後に失敗したターンでも 200 が返され、stop_reason: "error" と
error オブジェクトが含まれます。
"stream": true の場合は、サーバー送信イベントのストリームです。各イベントは
event: <type> 行と data: <json> 行で構成され、その後に空行が続きます。ストリームは
message_start で始まり、必ず message_end または error で終了します。新しいイベントの
種類やフィールドが追加される可能性があります。認識できないものは無視してください。
非ストリーミングレスポンスです。回答は text ブロックを順番に連結したものです。
このページは役に立ちましたか?
⌘I
curl --request POST \
--url https://beta.helius-rpc.com/v1/lana/messages \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"model": "lana-thinking",
"messages": [
{
"role": "user",
"content": "現在の SOL の価格はいくらですか?"
}
],
"extensions": {
"read_only": true
}
}
'{
"id": "msg_3f9c...",
"type": "message",
"role": "assistant",
"model": "lana-thinking",
"content": [
{
"type": "tool_use",
"id": "toolu_01...",
"name": "...",
"input": {
"mint": "So11111111111111111111111111111111111111112"
}
},
{
"type": "tool_result",
"tool_use_id": "toolu_01...",
"content": "{\"price\":..."
},
{
"type": "text",
"text": "SOL は ... で取引されています"
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 90800,
"output_tokens": 96,
"tool_calls": 1,
"prompt_tokens": 45600,
"context_window": 200000
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "max_tokens: max_tokens must be <= 8192"
}
}<string><string>{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "<string>"
}
}