Chuyển đến nội dung chính
POST
Mỗi yêu cầu tốn 10.000 credit với lana-thinking hoặc 2.000 credit với lana-fast. Yêu cầu gói trả phí. Các yêu cầu từ gói miễn phí trả về 403 Forbidden. Để xem hướng dẫn bắt đầu nhanh, sự kiện truyền phát và cách xử lý lỗi, hãy tham khảo hướng dẫn Lana API.

Tham số yêu cầu

string
bắt buộc
lana-thinking dành cho phân tích nhiều bước, với tối đa 20 bước tra cứu mỗi lượt; mô hình này có thể truyền phát quá trình suy luận. lana-fast dành cho các lượt tra cứu nhanh và thông tin đơn lẻ, với tối đa 4 bước tra cứu mỗi lượt.
  • lana-thinking
  • lana-fast
array
bắt buộc
Cuộc hội thoại, sắp xếp từ cũ nhất đến mới nhất. Cuộc hội thoại phải có ít nhất một tin nhắn và tin nhắn cuối cùng phải có role user. API không lưu trữ các cuộc hội thoại; hãy gửi toàn bộ cuộc hội thoại trong mỗi yêu cầu.
string
bắt buộc
Người viết tin nhắn.
  • user
  • assistant
any
bắt buộc
Một chuỗi không rỗng hoặc một mảng khối nội dung không rỗng. text được phép trong cả hai vai trò, image và tool_result chỉ được phép trong các tin nhắn user, còn tool_use chỉ được phép trong các tin nhắn assistant.
number
mặc định:"8192"
Số token đầu ra tối đa mà Lana có thể tạo trong một bước của mô hình. Một lượt có hoạt động tra cứu cần nhiều bước, vì vậy tổng output_tokens của lượt đó có thể cao hơn. Khi dưới 2.048, lana-thinking không thực hiện suy luận.
boolean
mặc định:"false"
true truyền phát các sự kiện do máy chủ gửi. false trả về một đối tượng JSON khi lượt kết thúc.
string
Các chỉ dẫn bổ sung, chẳng hạn như “Trả lời bằng ba dấu đầu dòng.” Những chỉ dẫn này được thêm vào chỉ dẫn riêng của Lana chứ không thay thế chúng.
object
Các tùy chọn chỉ dành cho Lana. Tất cả đều không bắt buộc. Các tùy chọn include_* cho phép tạo đầu ra; Lana sẽ quyết định có gửi đầu ra đó hay không.
boolean
mặc định:"true"
Loại bỏ các công cụ chuyển, hoán đổi và khởi chạy token. Hãy giữ giá trị là true.
string
mặc định:"markdown"
plain yêu cầu Lana không sử dụng Markdown và loại bỏ các dấu {{cite:N}}. Các sự kiện source vẫn được gửi đến.
  • markdown
  • plain
boolean
mặc định:"false"
Cho phép các thành phần UI dưới dạng sự kiện ui_block và ui_schema.
boolean
mặc định:"false"
Cho phép tối đa 3 câu hỏi tiếp theo được đề xuất.
boolean
mặc định:"false"
Cho phép các tệp CSV, JSON hoặc văn bản có thể tải xuống dưới dạng sự kiện document.
boolean
mặc định:"false"
Cho phép Lana đọc tối đa 10.000 giao dịch trong lịch sử của một địa chỉ (50.000 để đếm và tính tổng), với tối đa 3 lần quét mỗi lượt. Chỉ dành cho mainnet. Nếu không bật tùy chọn này, Lana đọc tối đa 100 giao dịch mỗi lần tra cứu. Mức giá cố định không đổi.
object
Người đang đặt câu hỏi.
string
Địa chỉ của người dùng để các cụm từ “ví của tôi” và “số dư của tôi” hoạt động.
string
wallet hoặc token: cho biết wallet là gì. Yêu cầu wallet.
string
Múi giờ IANA, chẳng hạn như America/New_York, để cụm từ “hôm nay” hoạt động.
string
mặc định:"mainnet"
Mạng cần tra cứu.
  • mainnet
  • devnet
array
Tối đa 8 hình ảnh được thêm vào tin nhắn cuối cùng của người dùng. Các khối image trong messages không được tính vào giới hạn này.
string
bắt buộc
URL của hình ảnh.
string
bắt buộc
Luôn là image.
  • image
object
Được trình khám phá Orb sử dụng. Bạn không cần tùy chọn này.
object
Được trình khám phá Orb sử dụng. Bạn không cần tùy chọn này.

Ủy quyền

X-Api-Key
string
header
bắt buộc

Khóa API Helius của bạn.

Nội dung

application/json
model
enum<string>
bắt buộc

Dùng lana-thinking để phân tích nhiều bước, với tối đa 20 bước tra cứu mỗi lượt; mô hình có thể truyền phát quá trình suy luận. Dùng lana-fast để tra cứu nhanh và tìm dữ kiện đơn lẻ, với tối đa 4 bước tra cứu mỗi lượt.

Tùy chọn có sẵn:
lana-thinking,
lana-fast
Ví dụ:

"lana-thinking"

messages
object[]
bắt buộc

Cuộc trò chuyện, từ cũ nhất đến mới nhất. Cần có ít nhất một tin nhắn và tin nhắn cuối phải có role là user. API không lưu trữ cuộc trò chuyện; hãy gửi toàn bộ cuộc trò chuyện trong mỗi yêu cầu.

Minimum array length: 1
max_tokens
integer
mặc định:8192

Số token đầu ra tối đa mà Lana có thể ghi trong một bước mô hình. Một lượt có tra cứu cần nhiều bước, vì vậy tổng output_tokens của lượt có thể cao hơn. Khi dưới 2.048, lana-thinking không suy luận.

Phạm vi bắt buộc: 1 <= x <= 8192
stream
boolean
mặc định:false

true truyền phát các sự kiện do máy chủ gửi. false trả về một đối tượng JSON khi lượt kết thúc.

system
string

Các hướng dẫn bổ sung, chẳng hạn như "Trả lời bằng ba gạch đầu dòng." Chúng được thêm vào hướng dẫn riêng của Lana, không thay thế các hướng dẫn đó.

Required string length: 1 - 10000
extensions
object

Các tùy chọn chỉ dành cho Lana. Tất cả đều không bắt buộc. Các tùy chọn include_* cho phép tạo đầu ra; Lana quyết định có gửi đầu ra đó hay không.

Phản hồi

Lượt đã chạy. Với "stream": false, trả về một đối tượng JSON. Hãy kiểm tra stop_reason: một lượt bị lỗi sau khi tạo nội dung vẫn trả về 200, với stop_reason: "error" và một đối tượng error.

Với "stream": true, trả về một luồng sự kiện do máy chủ gửi. Mỗi sự kiện gồm một dòng event: <type> và một dòng data: <json>, theo sau là một dòng trống. Luồng bắt đầu bằng message_start và luôn kết thúc bằng message_end hoặc error. Có thể bổ sung các loại sự kiện và trường mới; hãy bỏ qua những loại hoặc trường bạn không nhận ra.

Phản hồi không truyền phát. Câu trả lời là các khối text được nối theo thứ tự.

id
string
bắt buộc
Ví dụ:

"msg_3f9c..."

type
enum<string>
bắt buộc
Tùy chọn có sẵn:
message
role
enum<string>
bắt buộc
Tùy chọn có sẵn:
assistant
model
enum<string>
bắt buộc
Tùy chọn có sẵn:
lana-thinking,
lana-fast
content
object[]
bắt buộc
stop_reason
enum<string>
bắt buộc
  • end_turn: Lana đã hoàn thành câu trả lời.
  • max_tokens: câu trả lời đã đạt max_tokens và có thể bị cắt bớt.
  • tool_use: lượt kết thúc ở một bước tra cứu, thường là khi đạt giới hạn bước.
  • error: lượt bị lỗi. Câu trả lời chưa hoàn chỉnh.
Tùy chọn có sẵn:
end_turn,
max_tokens,
tool_use,
error
usage
object
bắt buộc
ui_schema
object

Tất cả thành phần UI dưới dạng một cây. Có mặt khi include_ui_schema được bật và có nội dung để hiển thị.

documents
object[]

Có mặt khi include_documents được bật và Lana đã tạo tệp.

follow_up
string[]

Có mặt khi include_followups được bật và Lana đã đề xuất câu hỏi.

sources
object[]

Có mặt khi Lana sử dụng các trang web.

error
object