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을 사용하며, 턴당 최대 20회의 조회 단계를 수행하고 추론 과정을 스트리밍할 수 있습니다. 빠른 조회와 단일 정보 확인에는 lana-fast을 사용하며, 턴당 최대 4회의 조회 단계를 수행합니다.lana-thinkinglana-fast
오래된 메시지부터 정렬된 대화입니다. 메시지가 하나 이상 있어야 하며, 마지막 메시지는
role이 user이어야 합니다. API는 대화를 저장하지 않으므로 요청할 때마다 전체 대화를 전송하세요.비어 있지 않은 문자열 또는 비어 있지 않은 콘텐츠 블록 배열입니다.
text은 두 역할 모두에서 허용되고, image과 tool_result은 user 메시지에서만 허용되며, tool_use은 assistant 메시지에서만 허용됩니다.Lana가 한 번의 모델 단계에서 작성할 수 있는 최대 출력 토큰 수입니다. 조회가 포함된 턴은 여러 단계를 거치므로 해당 턴의 전체
output_tokens은 더 클 수 있습니다. 2,048 미만에서는 lana-thinking이 추론하지 않습니다.plain은 Lana가 Markdown을 사용하지 않도록 하고 {{cite:N}} 마커를 제거합니다. source 이벤트는 계속 전달됩니다.markdownplain
Lana가 주소 기록에서 최대 10,000개의 트랜잭션을 읽을 수 있게 하며, 개수와 합계를 계산할 때는 최대 50,000개까지 읽을 수 있습니다. 턴당 최대 3회 스캔합니다. Mainnet에서만 사용할 수 있습니다. 이 옵션을 사용하지 않으면 Lana는 조회당 최대 100개의 트랜잭션을 읽습니다. 동일한 정액 요금이 적용됩니다.
본문
application/json
응답
턴이 실행되었습니다. "stream": false이면 하나의 JSON 객체가 반환됩니다. stop_reason을
확인하세요. 콘텐츠를 생성한 후 실패한 턴도 stop_reason: "error"와 error 객체를
포함하여 200을 반환합니다.
"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>"
}
}