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?”
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-thinkingvàlana-fast. - Lana chạy các công cụ riêng.
tools,tool_choice,temperature,top_p,top_k,stop_sequencesvàmetadatatrả về400. systemđược thêm vào chỉ dẫn của Lana.max_tokenslà 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_deltahoặcmessage_stop. Luồng kết thúc bằngmessage_endhoặcerror. usagebổ sungtool_calls,prompt_tokensvàcontext_window.stop_reasoncó thể làerror.extensionschỉ dành cho Lana.
Endpoint và xác thực
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.
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ới400, 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.
lana-thinking hoặc lana-fast. Xem Mô hình.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.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.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.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.
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ộtrole (user hoặc assistant) và content:
assistant:
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:
message_start, luôn đến đầu tiên.- Bất kỳ tổ hợp nào của
content_block_delta,tool_use,tool_result,source,ui_block,document,progress_updatevàping. ui_schema, tối đa một lần.follow_up, tối đa một lần.message_endnếu lượt hoàn tất hoặcerrornếu lượt thất bại. Đây luôn là sự kiện cuối cùng.
Mẹo hiển thị luồng:
- Chỉ sử dụng
tool_usecho 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 đếnsourcecóindextương ứng hoặc loại bỏ nó. ui_blockvàui_schemachứa cùng các thành phần. Lana có thể chỉ gửiui_schema, vì vậy hãy hiển thị các sự kiệnui_blocknếu chúng đến; nếu không, hãy kết xuấtui_schema.- Các lượt tìm kiếm web gửi một
tool_resultvới văn bảnWeb search completed.hoặcWeb fetch completed.. Các trang được gửi đến dưới dạng sự kiệnsource.
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:
Tool error codes
Tool error codes
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:
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ải200 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:
200vớistop_reason: "error"và một đối tượngerrorkhi 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 trastop_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:400chocontext_overflow,500choapi_error,502chotool_error,504chotimeout_errorhoặc529chooverloaded_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 HTTP200, 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
errorhoặ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.