메인 콘텐츠로 건너뛰기
POST
각 요청의 비용은 lana-thinking 사용 시 10,000크레딧, lana-fast 사용 시 2,000크레딧입니다. 유료 플랜이 필요합니다. 무료 플랜의 요청은 403 Forbidden을 반환합니다. 빠른 시작, 스트리밍 이벤트 및 오류 처리는 Lana API 가이드를 참조하세요.

요청 매개변수

string
필수
여러 단계의 분석에는 lana-thinking을 사용하며, 턴당 최대 20회의 조회 단계를 수행하고 추론 과정을 스트리밍할 수 있습니다. 빠른 조회와 단일 정보 확인에는 lana-fast을 사용하며, 턴당 최대 4회의 조회 단계를 수행합니다.
  • lana-thinking
  • lana-fast
array
필수
오래된 메시지부터 정렬된 대화입니다. 메시지가 하나 이상 있어야 하며, 마지막 메시지는 role이 user이어야 합니다. API는 대화를 저장하지 않으므로 요청할 때마다 전체 대화를 전송하세요.
string
필수
메시지를 작성한 주체입니다.
  • user
  • assistant
any
필수
비어 있지 않은 문자열 또는 비어 있지 않은 콘텐츠 블록 배열입니다. text은 두 역할 모두에서 허용되고, image과 tool_result은 user 메시지에서만 허용되며, tool_use은 assistant 메시지에서만 허용됩니다.
number
기본값:"8192"
Lana가 한 번의 모델 단계에서 작성할 수 있는 최대 출력 토큰 수입니다. 조회가 포함된 턴은 여러 단계를 거치므로 해당 턴의 전체 output_tokens은 더 클 수 있습니다. 2,048 미만에서는 lana-thinking이 추론하지 않습니다.
boolean
기본값:"false"
true은 서버 전송 이벤트를 스트리밍합니다. false은 턴이 끝나면 하나의 JSON 객체를 반환합니다.
string
“글머리 기호 세 개로 답변하세요.”와 같은 추가 지침입니다. 이 지침은 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개까지 읽을 수 있습니다. 턴당 최대 3회 스캔합니다. Mainnet에서만 사용할 수 있습니다. 이 옵션을 사용하지 않으면 Lana는 조회당 최대 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[]
필수

오래된 순서로 정렬된 대화입니다. 메시지가 하나 이상 필요하며 마지막 메시지의 role은 user여야 합니다. API는 대화를 저장하지 않으므로 요청할 때마다 전체 대화를 보내세요.

Minimum array length: 1
max_tokens
integer
기본값:8192

Lana가 한 모델 단계에서 작성할 수 있는 최대 출력 토큰 수입니다. 조회가 포함된 턴은 여러 단계를 거치므로 턴의 총 output_tokens는 더 클 수 있습니다. 2,048 미만에서는 lana-thinking이 추론하지 않습니다.

필수 범위: 1 <= x <= 8192
stream
boolean
기본값:false

true이면 서버 전송 이벤트를 스트리밍합니다. false이면 턴이 끝날 때 하나의 JSON 객체를 반환합니다.

system
string

"글머리 기호 세 개로 답변하세요."와 같은 추가 지침입니다. Lana 자체 지침을 대체하지 않고 해당 지침에 추가됩니다.

Required string length: 1 - 10000
extensions
object

Lana 전용 옵션입니다. 모두 선택 사항입니다. include_* 옵션은 해당 출력을 가능하게 하며 실제 전송 여부는 Lana가 결정합니다.

응답

턴이 실행되었습니다. "stream": false이면 하나의 JSON 객체가 반환됩니다. stop_reason을 확인하세요. 콘텐츠를 생성한 후 실패한 턴도 stop_reason: "error"와 error 객체를 포함하여 200을 반환합니다.

"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 구성 요소를 하나의 트리로 나타냅니다. include_ui_schema가 활성화되어 있고 표시할 항목이 있을 때 존재합니다.

documents
object[]

include_documents가 활성화되어 있고 Lana가 파일을 만들었을 때 존재합니다.

follow_up
string[]

include_followups가 활성화되어 있고 Lana가 질문을 제안했을 때 존재합니다.

sources
object[]

Lana가 웹 페이지를 사용했을 때 존재합니다.

error
object