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 대시보드에서 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입니다. 모델을 참조하세요.가장 오래된 항목부터 나열한 대화입니다. 메시지가 하나 이상 있어야 하며 마지막 메시지에는
role: "user"이 있어야 합니다. 메시지를 참조하세요.Lana가 한 모델 단계에서 작성할 수 있는 최대 출력 토큰 수로,
1부터 8192까지입니다. 조회가 포함된 턴은 여러 단계를 거치므로 턴의 총 output_tokens은 max_tokens보다 클 수 있습니다. 2,048 미만에서는 lana-thinking이 추론하지 않습니다.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은 JSON 한 줄입니다. 해당 type은 event 이름과 일치합니다.
200과 첫 이벤트는 Lana가 처음 응답할 때(추론, 답변 텍스트, 조회 또는 파일), 또는 늦어도 10초 후에 도착합니다. 그전에는 아무것도 전송되지 않으므로 이 시간 내에 실패한 요청은 일반 오류 응답을 받으며 요금이 부과되지 않습니다. 이후 Lana가 작업하는 동안 10초마다 ping이 도착합니다.
HTTP 클라이언트의 읽기 타임아웃을 30초 이상으로 설정하세요. httpx과 같은 5초 기본값은 너무 짧습니다. 첫 바이트가 도착하기 전이나 두 이벤트 사이에 만료될 수 있습니다.
이벤트는 다음 순서로 도착합니다.
message_start이 항상 먼저 도착합니다.content_block_delta,tool_use,tool_result,source,ui_block,document,progress_update및ping이 임의로 섞여 도착합니다.ui_schema이 최대 한 번 도착합니다.follow_up이 최대 한 번 도착합니다.- 턴이 완료되면
message_end이, 실패하면error이 도착합니다. 항상 마지막 이벤트입니다.
스트림 표시 팁:
tool_use은 진행률 표시기에만 사용하세요. 도구 이름과 입력은 변경될 수 있습니다."markdown"출력에서는 각{{cite:N}}을 해당index이 있는source링크로 바꾸거나 제거하세요.ui_block과ui_schema에는 동일한 컴포넌트가 포함됩니다. Lana가ui_schema만 보낼 수도 있으므로ui_block이벤트가 도착하면 표시하고, 그렇지 않으면ui_schema을 렌더링하세요.- 웹 검색은
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을 사용하면 턴이 끝날 때 하나의 JSON 객체를 받습니다.
text 블록을 순서대로 결합한 것입니다. 추론 및 progress_update은 스트리밍에서만 제공됩니다.
다음 필드는 값이 있을 때만 나타납니다.
오류
스트림 시작 전
응답이 시작되기 전에 실패한 요청은"stream": true을 사용하더라도 일반 오류 본문과 함께 200이 아닌 상태를 반환합니다. 이벤트는 전송되지 않으며 요금도 부과되지 않습니다. 본문을 스트림으로 읽기 전에 HTTP 상태를 확인하세요.
"stream": true을 사용하면 Lana가 처음 응답할 때 또는 늦어도 10초 후에 응답이 시작됩니다. 모델 과부하나 너무 긴 대화 등으로 그전에 실패한 턴도 여기에 해당합니다.
처음 두
429은 요금제에서 발생하며 응답 본문에 어느 제한에 도달했는지 표시됩니다. 세 번째는 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, 채팅 또는 이메일을 통해 도움을 받으세요.