Câu hỏi thường gặp về API không kiểm duyệt: Đăng ký, thanh toán, endpoint, mã lỗi và ranh giới nội dung

Đăng ký và dùng thử miễn phí

Làm thế nào để đăng ký, có cần liên kết thẻ ngân hàng không?

Bạn chỉ cần đăng ký trên trang /get-api-key/ bằng email và mật khẩu, không cần liên kết thẻ. Sau khi đăng ký thành công, khóa API sẽ hiển thị ngay trên trang, không cần chờ phê duyệt.

Tài khoản mới có bao nhiêu tiền dùng thử, và có thể dùng trong bao lâu?

Tài khoản mới có $0.50 tín dụng dùng thử, có hiệu lực trong 7 ngày. Tính theo giá đầu ra $1.00 / triệu token, số tiền này đủ để tạo khoảng 500.000 token phản hồi, đủ cho việc kiểm tra tích hợp và xác minh quy mô nhỏ.

Một tài khoản có thể có bao nhiêu khóa API? Làm gì nếu mất khóa?

Mỗi tài khoản chỉ có một khóa API. Nếu bị lộ hoặc mất, bạn có thể tạo lại trong tài khoản, khóa cũ sẽ mất hiệu lực ngay lập tức, tất cả các dịch vụ đang sử dụng khóa cũ sẽ nhận được 401, vì vậy bạn cần cập nhật đồng bộ biến môi trường sau khi thay đổi.

Sẽ xảy ra gì khi hết hạn dùng thử?

Khi hết hạn dùng thử, yêu cầu sẽ trả về 402, mã lỗi là no_credit. Để tiếp tục sử dụng, bạn chỉ cần nạp tiền vào số dư tín dụng trả trước cho tài khoản, mã không cần thay đổi.

Thanh toán và số dư

Giá bao nhiêu, tính phí theo cách nào?

Tính phí theo token: đầu vào $0.25 / triệu token, đầu ra $1.00 / triệu token. Không có gói đăng ký, không có phí hàng tháng, dùng bao nhiêu trừ bấy nhiêu. Xem giải thích đầy đủ tại trang giá cả.

Số dư có hết hạn không?

Không. Số dư tín dụng trả trước bạn nạp vào không có thời hạn, chỉ có $0.50 tín dụng dùng thử của tài khoản mới có giới hạn thời gian 7 ngày.

Làm sao để biết một yêu cầu tốn bao nhiêu tiền?

Trường usage trong mỗi phản hồi sẽ cung cấp số lượng token đầu vào và đầu ra của lần đó, nhân với giá đơn vị sẽ ra chi phí. Trong khối dữ liệu cuối cùng của yêu cầu streaming cũng có usage, hãy lưu ý rằng choices của khối này là một mảng rỗng khi đọc.

Làm thế nào để tránh phát sinh chi phí cao ngoài ý muốn?

Chủ yếu dựa vào hai điểm: sử dụng max_tokens để giới hạn đầu ra mỗi lần, mặc định là 2048; khi hội thoại nhiều lượt, hãy cắt bớt lịch sử để không cho đầu vào tăng dần. Vì là tín dụng trả trước, khi hết số dư, yêu cầu sẽ dừng lại và không phát sinh hóa đơn vượt quá số dư.

Ví dụ, một yêu cầu thông thường tốn khoảng bao nhiêu tiền?

Giả sử đầu vào 2.000 token, đầu ra 500 token: đầu vào khoảng $0.0005, đầu ra khoảng $0.0005, tổng cộng khoảng $0.001, tương đương khoảng $1 cho một nghìn yêu cầu như vậy. Số liệu thực tế dựa vào usage trong phản hồi.

Sẽ xảy ra gì khi hết số dư?

Endpoint trả về 402, mã lỗi no_credit. Sau khi nạp tiền, bạn có thể tiếp tục sử dụng mà không cần tạo lại khóa API.

Endpoint và tham số

Địa chỉ endpoint và tên mô hình là gì?

Base URL là https://api.wuxianzhiapi.com/v1, tên mô hình cố định là uncensored. Endpoint khả dụng: POST /v1/chat/completions và GET /v1/models.

Có tương thích với SDK của OpenAI không?

Tương thích. Với openai v1 trở lên của Python chính thức và openai v4 trở lên của npm, bạn chỉ cần thay đổi base_url và khóa là có thể sử dụng. Xem ví dụ mã để biết cách viết cụ thể, hoặc tham khảo hướng dẫn di chuyển để chuyển từ các endpoint khác.

Ngữ cảnh dài bao nhiêu? max_tokens có thể đặt lớn nhất là bao nhiêu?

Ngữ cảnh là 100,000 token, tổng prompt và đầu ra không được vượt quá con số này. max_tokens mặc định là 2048, tối đa mỗi lần là 32,000. Thân yêu cầu không được vượt quá 8 MB.

Hỗ trợ truyền phát đầu ra và gọi hàm không?

Đều hỗ trợ. Với streaming, dùng stream: true; server sẽ tự động thêm một khối dữ liệu chứa usage ở cuối. Với gọi hàm, dùng tools và tool_choice theo định dạng OpenAI; kết quả công cụ được trả về qua tin nhắn có role: "tool".

Tại sao khối cuối của phản hồi streaming không có văn bản?

Đó là khối thống kê lượng token được thêm tự động, choices là mảng rỗng, usage chứa số token của lần gọi này. Khi phân tích, bạn hãy kiểm tra xem choices có rỗng hay không trước khi lấy nội dung, như vậy sẽ tránh được lỗi vượt chỉ số.

Có giới hạn tốc độ không?

Mỗi khóa API cho phép 300 yêu cầu mỗi phút. Vượt quá sẽ trả về mã 429, bạn chỉ cần đợi và thử lại, khuyến nghị sử dụng cơ chế backoff theo cấp số nhân.

Hỗ trợ vector, hình ảnh, giọng nói hoặc fine-tuning không?

Không hỗ trợ. Nơi đây chỉ cung cấp hội thoại văn bản, chỉ có một mô hình uncensored, không có embeddings, cũng không có tạo hình ảnh, âm thanh, video và fine-tuning.

Mã lỗi

Tất cả phản hồi lỗi đều là JSON, định dạng là {"error":{"code":...,"message":...}}. Dưới đây là hướng dẫn xử lý từng mã trạng thái.

Lỗi 400 là gì?

Yêu cầu của bạn có vấn đề, phổ biến nhất là prompt cộng với max_tokens vượt quá 100,000 token, hoặc định dạng JSON không đúng, sai kiểu trường dữ liệu. Bạn cần sửa yêu cầu, thử lại cũng không được.

Làm sao để khắc phục lỗi 401?

Khóa API không hợp lệ hoặc chưa được đính kèm. Hãy kiểm tra xem header của yêu cầu có phải Authorization: Bearer <khóa API> không, biến môi trường có hiệu lực không, khóa API có bị tạo lại không. Khóa cũ sẽ mất hiệu lực ngay lập tức sau khi tạo lại.

no_credit 402 có nghĩa là gì?

Số dư đã hết hoặc tín dụng dùng thử miễn phí đã hết hạn. Bạn chỉ cần nạp tiền vào tài khoản là có thể khôi phục, không cần thay đổi khóa API.

content_blocked 403 có nghĩa là gì?

Yêu cầu của bạn đã kích hoạt bộ lọc nội dung. Nội dung khiêu dâm liên quan đến trẻ em luôn bị chặn, bao gồm cả nội dung hư cấu và nhập vai, đây là quy tắc không thể điều chỉnh. Hãy sửa đổi nội dung yêu cầu rồi thử lại, gửi lại nguyên bản kết quả sẽ không thay đổi.

Lỗi 404 là gì?

Bạn đã truy cập vào một endpoint không tồn tại. Nguyên nhân phổ biến là URL bị sai, chẳng hạn thiếu /v1, hoặc gọi một endpoint không được hỗ trợ như embeddings hoặc tạo hình ảnh.

Phải xử lý lỗi 429 và 503 như thế nào?

429 nghĩa là bạn đã vượt quá giới hạn tốc độ 300 yêu cầu mỗi phút; mã lỗi 503 là upstream_busy, nghĩa là mô hình đang bận tạm thời, bạn hãy thử lại sau vài giây. Cả hai đều phù hợp để thử lại với cơ chế backoff theo cấp số nhân, ví dụ xem tại trang ví dụ mã.

Ranh giới nội dung

"Không kiểm duyệt" có nghĩa là có thể tạo ra mọi thứ không?

Không. Nội dung người lớn hợp pháp, tác phẩm hư cấu và các chủ đề gây tranh cãi sẽ không bị từ chối, nhưng nội dung liên quan đến tình dục với trẻ em luôn bị chặn, trả về mã 403, bất kể là hư cấu hay nhập vai. Bạn phải sử dụng hợp pháp.

Dành cho người dùng nào?

Chỉ dành cho người dùng từ 18 tuổi trở lên. Nếu bạn sử dụng nó để xây dựng sản phẩm dành cho người dùng cuối, bạn cần xác nhận độ tuổi trong ứng dụng của mình và duy trì cơ chế báo cáo và quản lý tài khoản.

Có thể dùng để nhập vai, viết tiểu thuyết, làm game không?

Có, đây là cách sử dụng điển hình nhất. Xem các ví dụ prompt và ước tính chi phí cho từng trường hợp tại Ứng dụng.

Trong nhập vai, trường hợp nào sẽ trả về 403?

Chỉ khi kích hoạt bộ lọc nội dung thì mới trả về, điển hình là nội dung khiêu dâm liên quan đến trẻ em, bao gồm cả thiết lập hư cấu. Nội dung hợp pháp giữa những người trưởng thành sẽ không bị từ chối chỉ vì là nhập vai. Khi gặp 403, bạn hãy điều chỉnh nhân vật hoặc cốt truyện rồi gửi yêu cầu lại.

Thông tin thực tế trong đầu ra của mô hình có luôn đáng tin cậy không?

Không chắc chắn. Việc không từ chối không đồng nghĩa với việc nội dung chính xác. Các kết luận liên quan đến sự thật, dữ liệu, pháp lý hoặc y tế cần bạn tự mình xác minh trước khi sử dụng.

Quyền riêng tư

Prompt của tôi có được dùng để huấn luyện mô hình không?

Không. Prompt bạn gửi sẽ không được dùng để huấn luyện.

Làm sao để bảo quản khóa API?

Đặt khóa API trong biến môi trường của máy chủ, không ghi vào trang web frontend, gói cài đặt mobile hoặc kho mã nguồn công khai. Nếu nghi ngờ bị lộ, hãy tạo lại ngay trong tài khoản, khóa cũ sẽ mất hiệu lực ngay lập tức.

Xử lý dữ liệu người dùng trong ứng dụng như thế nào?

Phần này phụ thuộc vào sản phẩm của bạn. Chúng tôi khuyên bạn chỉ gửi những nội dung cần thiết để hoàn thành nhiệm vụ, không đưa thông tin nhạy cảm như tên thật, số giấy tờ, thông tin liên lạc của người dùng vào prompt, và ghi rõ cách thức luân chuyển dữ liệu trong chính sách quyền riêng tư của bạn.