Hướng dẫn tuyến

Tianshu cung cấp hai tuyến tích hợp, chọn theo loại yêu cầu là được.

Tuyến chuẩn (mặc định)

https://tian-shu.org

Phù hợp với hầu hết các giao diện: chat, văn bản, vector (embeddings), xếp hạng lại (rerank), v.v. Đầu ra dạng luồng của chat sẽ bắt đầu trả token ngay sau khi thiết lập kết nối, không bị ảnh hưởng bởi timeout byte đầu tiên, khuyến nghị dùng mặc định tuyến này.

Tuyến kết nối trực tiếp (yêu cầu dài / tạo ảnh)

https://api.tian-shu.org

Phù hợp với các yêu cầu tốn nhiều thời gian, trả về một lần, điển hình như tạo ảnh (/v1/images/generations, v.v.). Loại yêu cầu này cần máy chủ tính xong mới trả kết quả một lần, dễ kích hoạt timeout của CDN; tuyến kết nối trực tiếp đi thẳng tới máy chủ gốc, bỏ qua CDN, tránh bị ngắt do timeout.

Quy tắc kinh nghiệm: yêu cầu dạng luồng liên tục nhả chữ → tuyến chuẩn; yêu cầu tính lâu mới trả về một lần (tạo ảnh, v.v.) → tuyến kết nối trực tiếp.

Đường dẫn giao diện

Cả hai tuyến đều tương thích đường dẫn kiểu OpenAI, ví dụ:

Mục đích	Đường dẫn
Chat completion	/v1/chat/completions
Responses	/v1/responses
Claude Messages	/v1/messages
Vector	/v1/embeddings
Xếp hạng lại	/v1/rerank
Tạo ảnh	/v1/images/generations
Tổng hợp / chuyển âm thanh	/v1/audio/speech, /v1/audio/transcriptions

Một mô hình cụ thể hỗ trợ những giao diện nào, lấy theo chú thích trên Chợ mô hình làm chuẩn.