Chuyển đến nội dung chính
Lana API là một tác nhân AI Solana mà bạn gọi qua HTTP. Bạn gửi câu hỏi bằng tiếng Anh thông thường, Lana sẽ tra cứu ví, token, giao dịch và giá, sau đó truyền phát câu trả lời về. Lana thực hiện mọi lượt tra cứu ở phía Helius, vì vậy bạn không cần định nghĩa hoặc chạy bất kỳ công cụ nào. Dịch vụ có trên các gói Helius trả phí (Developer trở lên), với mức giá cố định cho mỗi yêu cầu: 10.000 tín dụng cho lana-thinking và 2.000 tín dụng cho lana-fast. Xem Giá. API có cấu trúc giống Anthropic Messages API, nhưng các SDK Anthropic không hoạt động với API này. Hãy gọi API qua HTTP thuần như trong các ví dụ bên dưới. Xem Điểm khác biệt so với Anthropic Messages API. Lana chạy trên các mô hình Claude của Anthropic. Câu hỏi và cuộc trò chuyện của bạn được gửi đến Anthropic để tạo câu trả lời.
Lana API đang ở giai đoạn beta trên endpoint Gatekeeper (Beta), beta.helius-rpc.com. API này chưa có trên mainnet.helius-rpc.com. Các sự kiện và trường mới có thể được thêm trong giai đoạn beta.

Bạn có thể hỏi Lana những gì

Các câu hỏi mà người dùng có thể đặt về giao dịch của họ và những ví mà họ tương tác:
  • “Tại sao giao dịch gần nhất của tôi thất bại?”
  • “Tôi đã chịu mức trượt giá bao nhiêu trong lần hoán đổi này?”
  • “Tôi đã trả những khoản phí nào cho giao dịch này?”
  • “Ví này nhận tiền từ đâu và đã gửi tiền đến đâu?”
  • “Ví này có liên kết với ví kia không?”
  • “Ai là những người nắm giữ nhiều token này nhất?”
Truyền ví của người dùng trong extensions.user_context.wallet để các câu hỏi về ví “của tôi” hoặc “giao dịch gần nhất của tôi” hoạt động.

Bắt đầu nhanh

1

Get an API key

Sao chép khóa API từ Helius Dashboard.
2

Ask a question

Thay thế YOUR_API_KEY rồi chạy:
cURL
-N khiến curl in từng sự kiện ngay khi nhận được. Sự kiện đầu tiên có thể mất tối đa 10 giây mới đến.
3

Read the answer

Phản hồi là một luồng sự kiện:
Câu trả lời là các đoạn text_delta theo đúng thứ tự. lana-thinking cũng có thể gửi các đoạn thinking_delta: đây là phần suy luận của Lana, vì vậy hãy hiển thị riêng với câu trả lời hoặc bỏ qua.

Đọc luồng trong mã

Cả hai ví dụ đều kiểm tra trạng thái HTTP trước khi đọc phần thân dưới dạng luồng, chờ Retry-After khi gặp 429 hoặc 503, in câu trả lời trong lúc truyền phát và dừng nếu lượt xử lý thất bại hoặc luồng kết thúc sớm.

Điểm khác biệt so với Anthropic Messages API

  • Các mô hình là lana-thinking và lana-fast.
  • Lana chạy các công cụ riêng. tools, tool_choice, temperature, top_p, top_k, stop_sequences và metadata trả về 400.
  • system được thêm vào chỉ dẫn của Lana.
  • max_tokens là tùy chọn (mặc định và tối đa là 8.192), đồng thời hình ảnh phải là URL.
  • Các sự kiện khác nhau. Không có content_block_start, content_block_stop, message_delta hoặc message_stop. Luồng kết thúc bằng message_end hoặc error.
  • usage bổ sung tool_calls, prompt_tokens và context_window. stop_reason có thể là error.
  • extensions chỉ dành cho Lana.

Endpoint và xác thực

Gửi khóa API Helius theo một trong các cách sau: Authorization: Bearer không hoạt động trên endpoint này và trả về 401. mainnet.helius-rpc.com chưa cung cấp tuyến này và trả về 503. Gửi Content-Type: application/json trong mọi yêu cầu.
Khóa API sử dụng tín dụng trong gói của bạn. Hãy gọi Lana từ máy chủ, không phải từ trình duyệt hoặc ứng dụng mà bạn phân phối cho người dùng.

Phần thân yêu cầu

Phần thân là một đối tượng JSON. Các trường không xác định sẽ bị từ chối với 400, bao gồm cả các trường không xác định bên trong extensions và các khối nội dung.
string
bắt buộc
lana-thinking hoặc lana-fast. Xem Mô hình.
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 cùng phải có role: "user". Xem Tin nhắn.
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, từ 1 đến 8192. 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 max_tokens. Khi dưới 2.048, lana-thinking không suy luận.
boolean
mặc định:"false"
true truyền phát sự kiện. false trả về một phản hồi JSON khi lượt kết thúc.
string
Chỉ dẫn bổ sung, dài từ 1 đến 10.000 ký tự, chẳng hạn như “Trả lời bằng ba dấu đầu dòng.” Các 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. Xem Phần mở rộng.

Mô hình

lana-thinking chỉ suy luận khi max_tokens từ 2048 trở lên.

Tin nhắn

Mỗi tin nhắn có một role (user hoặc assistant) và content:
API không lưu trữ cuộc trò chuyện. Để đặt câu hỏi tiếp theo, hãy gửi lại toàn bộ cuộc trò chuyện với câu hỏi mới ở cuối. Văn bản câu trả lời của Lana là đủ cho các lượt assistant:
Lana chỉ tra cứu các địa chỉ xuất hiện trong cuộc trò chuyện, trong kết quả tra cứu của chính Lana hoặc trong extensions.user_context.wallet. content là một chuỗi không rỗng hoặc một mảng khối không rỗng: Hình ảnh phải là URL. Hình ảnh Base64 không được hỗ trợ. Bạn không cần các khối tool_use hoặc tool_result. Chúng cho phép phát lại các lượt tra cứu từ một lượt trước đó theo đúng dữ liệu Lana đã trả về, để Lana có thể tái sử dụng các kết quả đó. tool_result cũng nhận một giá trị boolean is_error tùy chọn.

Phần mở rộng

Tất cả phần mở rộng đều là tùy chọn. 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. extensions cũng chấp nhận progress_context và transaction_filter_context. Trình khám phá Orb sử dụng chúng, còn bạn không cần chúng. Các trường user_context:

Sự kiện truyền phát

Với "stream": true, bạn nhận được trạng thái 200 và Content-Type: text/event-stream. Mỗi sự kiện có dạng như sau:
data là một dòng JSON. type của dòng này khớp với tên event. 200 và các sự kiện đầu tiên đến khi Lana phản hồi lần đầu (phần suy luận, văn bản câu trả lời, một lượt tra cứu hoặc một tệp), hoặc chậm nhất sau 10 giây. Cho đến lúc đó, không có gì được gửi, vì vậy yêu cầu thất bại trong khoảng thời gian này sẽ nhận phản hồi lỗi thông thường và không bị tính phí. Sau đó, một ping sẽ đến mỗi 10 giây trong khi Lana làm việc. Đặt thời gian chờ đọc của máy khách HTTP thành 30 giây trở lên. Giá trị mặc định 5 giây như trong httpx là quá ngắn: thời gian chờ có thể hết trước byte đầu tiên hoặc giữa hai sự kiện. Các sự kiện đến theo thứ tự sau:
  1. message_start, luôn đến đầu tiên.
  2. Bất kỳ tổ hợp nào của content_block_delta, tool_use, tool_result, source, ui_block, document, progress_update và ping.
  3. ui_schema, tối đa một lần.
  4. follow_up, tối đa một lần.
  5. message_end nếu lượt hoàn tất hoặc error nếu lượt thất bại. Đây luôn là sự kiện cuối cùng.
Các loại sự kiện và trường mới có thể được thêm vào. Hãy bỏ qua những loại hoặc trường bạn không nhận ra. Mẹo hiển thị luồng:
  • Chỉ sử dụng tool_use cho chỉ báo tiến trình. Tên công cụ và dữ liệu đầu vào có thể thay đổi.
  • Với đầu ra "markdown", hãy chuyển mỗi {{cite:N}} thành liên kết đến source có index tương ứng hoặc loại bỏ nó.
  • ui_block và ui_schema chứa cùng các thành phần. Lana có thể chỉ gửi ui_schema, vì vậy hãy hiển thị các sự kiện ui_block nếu chúng đến; nếu không, hãy kết xuất ui_schema.
  • Các lượt tìm kiếm web gửi một tool_result với văn bản Web search completed. hoặc Web fetch completed.. Các trang được gửi đến dưới dạng sự kiện source.

Lỗi công cụ

Một lượt tra cứu thất bại không làm cả lượt xử lý thất bại. Lana sẽ xử lý theo cách khác và bạn không cần thử lại. tool_result có is_error: true, còn content là JSON chứa một thông báo ngắn và một code:
Các mã mới có thể được thêm vào. Hãy xử lý mã không xác định như internal.

Lý do dừng

stop_reason nằm trong message_end và phản hồi JSON:

Mức sử dụng

Các chỉ dẫn và công cụ tra cứu riêng của Lana sử dụng khoảng 45.000 token trong mỗi bước mô hình, vì vậy input_tokens vẫn cao ngay cả với câu hỏi ngắn. Giá được tính theo yêu cầu nên số lượng token không làm thay đổi số tiền bạn trả.

Phản hồi không truyền phát

Với "stream": false, bạn nhận được một đối tượng JSON khi lượt kết thúc:
Câu trả lời là các khối text được nối theo thứ tự. Phần suy luận và progress_update chỉ có khi truyền phát. Các trường này chỉ xuất hiện khi có giá trị:

Lỗi

Trước khi luồng bắt đầu

Yêu cầu thất bại trước khi phản hồi bắt đầu sẽ trả về trạng thái không phải 200 cùng phần thân lỗi thông thường, ngay cả khi dùng "stream": true. Không có sự kiện nào được gửi và bạn không bị tính phí. Hãy kiểm tra trạng thái HTTP trước khi đọc phần thân dưới dạng luồng. Với "stream": true, phản hồi bắt đầu khi Lana phản hồi lần đầu hoặc chậm nhất sau 10 giây. Một lượt thất bại trước thời điểm đó, chẳng hạn do mô hình quá tải hoặc cuộc trò chuyện quá dài, cũng thuộc trường hợp này. Hai 429 đầu tiên đến từ gói của bạn và phần thân phản hồi cho biết bạn gặp trường hợp nào. Trường hợp thứ ba đến từ Lana và có phần thân JSON. Nếu nhận được 429 hoặc 503 mà không có header Retry-After, hãy chờ vài giây trước khi thử lại. Các lỗi riêng của Lana (400 cho phần thân không hợp lệ hoặc context_overflow, 429 với rate_limit_error, 500, 502, 503, 504 và 529) có phần thân JSON. Lỗi từ Gatekeeper (401, 403, 400 do phần thân quá lớn và các 429 của gói) là văn bản thuần. Hãy phân nhánh theo error.type, không phải message:

Sau khi luồng bắt đầu

Trạng thái đã là 200, vì vậy lỗi sẽ kết thúc luồng bằng sự kiện error cuối cùng hoặc bằng message_end và stop_reason: "error". message_end đó không có đối tượng error; hãy xử lý như api_error. Mọi văn bản câu trả lời trước đó đều chưa hoàn chỉnh. Hãy hiển thị là chưa hoàn chỉnh hoặc loại bỏ.

Không truyền phát

Với "stream": false, một lượt thất bại trả về một trong hai dạng:
  • 200 với stop_reason: "error" và một đối tượng error khi lượt đã tạo bất kỳ nội dung nào, bao gồm cả lượt tra cứu. Luôn kiểm tra stop_reason.
  • Phần thân lỗi JSON khi lượt không tạo nội dung nào. Trạng thái khớp với error.type: 400 cho context_overflow, 500 cho api_error, 502 cho tool_error, 504 cho timeout_error hoặc 529 cho overloaded_error (trạng thái Anthropic sử dụng cho mô hình quá tải; một số máy khách HTTP không nhận ra, vì vậy hãy xử lý như 503). Những trường hợp này không bị tính phí. Xử lý như trong Loại lỗi.

Loại lỗi

Xử lý mọi loại khác như api_error.

Giới hạn

Khi một lượt gần đạt 5 phút, Lana dừng tra cứu và trả lời bằng thông tin hiện có. Các lượt dài thường kết thúc bằng câu trả lời một phần nêu rõ nội dung còn thiếu, thay vì hết thời gian chờ. Khi truyền phát, hãy đặt thời gian chờ đọc của máy khách HTTP thành 30 giây trở lên. Byte đầu tiên có thể mất tối đa 10 giây mới đến, sau đó một ping đến mỗi 10 giây, vì vậy khoảng ngắt dài hơn nhiều nghĩa là kết nối đã bị gián đoạn. Giá trị mặc định 5 giây như trong httpx là quá ngắn. Khi không truyền phát, không có dữ liệu nào đến cho đến khi lượt kết thúc, vì vậy hãy đặt thời gian chờ đọc trên 5 phút. Nếu bạn ngắt kết nối, Lana sẽ dừng lượt. Yêu cầu có luồng đã bắt đầu vẫn bị tính phí. Khi Lana đã hết công suất, các yêu cầu mới nhận 503 trước khi có dữ liệu truyền phát. Các yêu cầu này không bị tính phí. Hãy thử lại sau khoảng thời gian trong header Retry-After.

Giá

Mỗi yêu cầu có mức giá cố định tùy theo mô hình: Giá giống nhau cho yêu cầu truyền phát và không truyền phát, cũng như trên mọi gói trả phí (Developer trở lên). Lana không có trên gói Free. Tín dụng được lấy từ gói của bạn. Xem Tín dụng.

Trường hợp bị tính phí

Bạn bị tính phí cho mọi yêu cầu nhận HTTP 200, dù có truyền phát hay không và bất kể lượt kết thúc như thế nào. Yêu cầu thất bại trước khi phản hồi bắt đầu sẽ nhận trạng thái khác và không bị tính phí.
  • Một lượt truyền phát thất bại với sự kiện error hoặc bị bạn ngắt kết nối sau khi bắt đầu vẫn bị tính phí: trạng thái đã là 200.
  • Yêu cầu bị từ chối trước khi lượt bắt đầu (400, 401, 403, 429, 503) không bị tính phí.
  • Một lượt thất bại trước khi phản hồi bắt đầu (400, 5xx), dù có truyền phát hay không, đều không bị tính phí.

Ví dụ khác

Thiết lập giọng điệu và ví của người dùng

cURL

Quét toàn bộ lịch sử của ví

cURL

Nhận thành phần UI, câu hỏi tiếp theo và tệp CSV

cURL

Bước tiếp theo

API Reference

Lược đồ yêu cầu và phản hồi, kèm môi trường thử nghiệm.

Rate Limits

Giới hạn tốc độ của Lana theo từng gói.

Credits

Cách các yêu cầu Lana sử dụng tín dụng trong gói của bạn.

Contact Support

Nhận trợ giúp qua Discord, trò chuyện hoặc email.