Khóa API tương thích OpenAI: Lấy một cái và gửi yêu cầu
Một khóa API tương thích OpenAI là một token Bearer tiêu chuẩn, hoạt động với bất kỳ SDK OpenAI nào khi bạn chỉ định client của bạn đến một base URL khác. Trang này hướng dẫn cách lấy một khóa cho API văn bản được lưu trữ trên trang web này và thực hiện một yêu cầu thành công trong vài phút.
Đã cập nhậtSpeech To Text API

Khóa thực sự là gì
"Tương thích OpenAI" mô tả hình dạng của API HTTP, không phải công ty đứng sau nó. Dịch vụ chấp nhận cùng body JSON trên POST /v1/chat/completions mà các SDK OpenAI gửi, và nó đọc cùng header Authorization: Bearer. Do đó, một khóa từ dịch vụ này có thể tích hợp vào bất kỳ công cụ nào cho phép bạn đặt base URL và API key tùy chỉnh: thư viện Python và Node chính thức, LangChain, curl thuần túy và hầu hết các client chat trên máy tính.
Khóa này không phải là khóa OpenAI, và nó sẽ không hoạt động trên api.openai.com. Ngược lại cũng đúng: một khóa OpenAI sẽ không hoạt động ở đây. Mỗi khóa thuộc về một dịch vụ, và dịch vụ này chạy một mô hình open-weight duy nhất, được tinh chỉnh để trả lời mà không từ chối nội dung cho người dùng trưởng thành hợp pháp, được lưu trữ bởi nhà cung cấp độc lập. Nó không phải là API chính thức của bất kỳ nhà cung cấp mô hình nào và không định tuyến đến các nhà cung cấp khác.
Đây là những gì bạn cần nhớ. Base URL cho trang web này là https://api.speechtotextapis.com/v1. Model ID là uncensored. Khóa là bất kỳ chuỗi nào bạn nhận được sau khi đăng ký. Mọi nội dung bên dưới là biến thể của ba giá trị đó.
Dịch vụ chỉ xử lý văn bản. Dịch vụ xử lý hoàn tất hội thoại, truyền phát (streaming), gọi hàm và chế độ JSON. Dịch vụ không tạo hình ảnh hay âm thanh, không cung cấp embedding và không tinh chỉnh mô hình. Nếu bạn đến đây từ một pipeline giọng nói, công việc điển hình là bước xử lý văn bản sau khi phiên âm: làm sạch bản ghi, chia thành các cảnh, viết lại hội thoại hoặc trích xuất dữ liệu có cấu trúc. Hướng dẫn xử lý kịch bản giọng nói voice script đề cập chi tiết hơn về phần này.
Lấy khóa của bạn trong bốn bước
- Đăng ký. Sử dụng Google, hoặc đăng ký bằng địa chỉ email và mật khẩu.
- Mở trang khóa API. Nó nằm ở trang khóa trên trang web này. Khóa của bạn được tạo và hiển thị ở đó.
- Nhận tín dụng dùng thử. Một nút trên cùng trang cho bạn $0.50 tín dụng dùng thử chỉ với một cú nhấp chuột. Mỗi người chỉ nhận một lần, có hiệu lực trong 7 ngày và không cần thẻ.
- Sao chép khóa vào kho bí mật. Một biến môi trường là đủ cho thử nghiệm cục bộ. Đối với bất kỳ ứng dụng nào được triển khai, hãy sử dụng trình quản lý bí mật của máy chủ.
Tín dụng dùng thử được thiết kế để chứng minh rằng tích hợp hoạt động trước khi bạn trả bất kỳ khoản tiền nào. Ở mức giá hiện tại, nó đủ cho nhiều yêu cầu ngắn, và phần chi phí bên dưới cho thấy phép tính. Khi bạn sẵn sàng tiếp tục, trang giá cả liệt kê các số tiền nạp. Tín dụng là trả trước, không có đăng ký và tín dụng không bao giờ hết hạn, vì vậy không có áp lực phải chi tiêu một khoản nạp trước một thời hạn nhất định.
Khóa dùng thử có giới hạn chặt chẽ hơn khóa đầy đủ: 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút. Điều đó là đủ cho một kịch bản đầu tiên. Nếu bạn dự định gửi song song hàng chục đoạn bản ghi, bạn sẽ chạm giới hạn cho đến khi chuyển sang tài khoản đã nạp tiền.
Ba cài đặt mà mọi client đều yêu cầu
Bất kể phần mềm nào bạn sử dụng, màn hình thiết lập đều yêu cầu cùng ba thứ dưới các tên gọi hơi khác nhau.
| Cài đặt | Tên trường điển hình | Giá trị |
|---|---|---|
| Endpoint | Base URL, API base, host | https://api.speechtotextapis.com/v1 |
| Thông tin xác thực | Khóa API, token, bí mật | Khóa của bạn từ trang khóa |
| Mô hình | Mô hình, tên mô hình, động cơ | uncensored |
Một chi tiết khiến mọi người bối rối: base URL đã kết thúc bằng /v1. Các SDK tự thêm /chat/completions, vì vậy bạn không nên thêm nó. Nếu client của bạn yêu cầu URL đầy đủ của endpoint chat thay vì base, giá trị là https://api.speechtotextapis.com/v1/chat/completions.
Nếu một công cụ chỉ cung cấp tùy chọn "OpenAI" với host được mã hóa cứng và không có cách nào để chỉnh sửa nó, nó không thể giao tiếp với dịch vụ này. Hãy tìm tùy chọn "custom", "OpenAI-compatible" hoặc "advanced" cho phép truy cập vào trường base URL.
Yêu cầu đầu tiên của bạn
Bắt đầu với curl, vì nó loại bỏ mọi lớp giữa bạn và API. Thay thế YOUR_KEY bằng khóa bạn đã sao chép.
curl https://api.speechtotextapis.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
]
}'
Một phản hồi thành công là một đối tượng JSON với một mảng choices. Văn bản nằm trong choices[0].message.content, và một khối usage báo cáo các token bạn đã được tính phí.
Cùng một lệnh gọi với thư viện Python chính thức trông như thế này. Chỉ có base_url và api_key khác với thiết lập OpenAI tiêu chuẩn.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.speechtotextapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
],
)
print(resp.choices[0].message.content)
Và trong Node, sử dụng cùng gói:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.speechtotextapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Rewrite this in plain English: the beta shipped on Tuesday." },
],
});
console.log(resp.choices[0].message.content);
Bạn không cần đặt max_tokens. Khi nó bị bỏ qua, phần hoàn thành có thể sử dụng phần còn lại của cửa sổ 100.000 token sau prompt của bạn. Đặt nó nếu bạn muốn một giới hạn cứng về chi phí cho mỗi lệnh gọi.
Kiểm tra xem khóa có hoạt động mà không tốn token không
Trước khi kết nối khóa vào một hệ thống lớn hơn, hãy thực hiện một lệnh gọi rẻ tiền đến endpoint models. Nó xác nhận khóa được chấp nhận và base URL là đúng.
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
Cờ -i in ra các header phản hồi, nơi API này báo cáo trạng thái hữu ích:
X-Request-Idxác định yêu cầu. Bao gồm nó nếu bạn liên hệ hỗ trợ về một lệnh gọi cụ thể.X-Balance-USDhiển thị tín dụng còn lại trên tài khoản.X-RateLimit-Limit-RequestsvàX-RateLimit-Limit-Concurrencyhiển thị các giới hạn áp dụng cho khóa của bạn, vì vậy bạn có thể biết ngay lập tức nếu khóa có giới hạn dùng thử hoặc đầy đủ.
Đọc X-Balance-USD trong mã của riêng bạn là một cách rẻ tiền để tự cảnh báo trước khi hết tín dụng. Ghi nhật ký nó một lần mỗi công việc thay vì một lần mỗi yêu cầu nếu bạn không muốn đầu ra ồn ào.
Chi phí sử dụng khóa
Việc có một khóa không tốn gì. Bạn trả tiền cho token: $0.15 cho mỗi 1M token đầu vào và $0.50 cho mỗi 1M token đầu ra, được trích từ tín dụng trả trước. Các yêu cầu thất bại hoặc bị từ chối không bị tính phí.
Ví dụ minh họa với lệnh gọi làm sạch bản ghi ở trên. Giả sử một prompt là 1.000 token và câu trả lời đã làm sạch là 500 token.
- Đầu vào: 1,000 / 1,000,000 x $0.15 = $0.00015
- Đầu ra: 500 / 1.000.000 x $0,50 = $0,00025
- Tổng cộng: $0.0004 cho mỗi lệnh gọi
Tín dụng dùng thử $0.50 do đó bao gồm khoảng 1.250 lệnh gọi có kích thước đó ($0.50 / $0.0004). Số liệu của bạn sẽ khác, vì bản ghi thay đổi về độ dài, nhưng phương pháp là giống nhau: đếm token đầu vào, đếm token đầu ra, nhân lên.
Khi bạn nạp tiền, bất kỳ số nguyên nào từ $20 đến $500 đều được chấp nhận. Các khoản nạp lớn hơn mang lại ưu đãi: +5% từ $50, +10% từ $100 và +15% từ $200. Ví dụ, một khoản nạp $100 sẽ cho bạn $110 tín dụng. Bạn có thể thanh toán bằng tiền mã hóa (USDT trên TRC20, USDC trên Base).
Giữ khóa an toàn
Khóa API là mật khẩu cho số dư của bạn. Bất kỳ ai có nó đều có thể chi tiêu tín dụng của bạn, vì vậy hãy đối xử với nó như vậy.
- Giữ nó ra khỏi kiểm soát phiên bản. Đọc nó từ một biến môi trường hoặc trình quản lý bí mật.
- Đừng đưa khóa này vào JavaScript trên trình duyệt hoặc gói ứng dụng di động. Bất cứ thứ gì chạy trên thiết bị của người dùng đều có thể bị kiểm tra. Hãy đặt một máy chủ nhỏ ở giữa giao diện người dùng và API, để máy chủ thêm tiêu đề đó.
- Đừng dán khóa vào ảnh chụp màn hình, vé hỗ trợ hoặc tin nhắn trò chuyện.
- Nếu bạn nghĩ khóa đã bị rò rỉ, hãy ngừng sử dụng nó và liên hệ với bộ phận hỗ trợ ngay lập tức thay vì chờ đợi xem điều gì sẽ xảy ra.
Về quyền riêng tư: các prompt gửi đến API không được sử dụng để huấn luyện. Đây là tuyên bố về dịch vụ, không phải lý do để gửi các dữ liệu bí mật mà bạn không cần gửi. Hãy loại bỏ dữ liệu cá nhân khỏi bản ghi khi nhiệm vụ không yêu cầu.
Khi một lệnh gọi thất bại
Hầu hết các vấn đề trong ngày đầu tiên đều xuất phát từ một trong bốn nguyên nhân.
Base URL sai
Hai lỗi thường gặp là thiếu /v1 và bị nhân đôi /chat/completions. Hãy so sánh giá trị của bạn từng ký tự với giá trị trong bảng ở trên.
Khóa có ký tự thừa
Việc sao chép từ trang web thường kèm theo một khoảng trắng hoặc ký tự xuống dòng ở cuối. Hãy cắt bỏ giá trị này trong mã của bạn và kiểm tra xem tiêu đề có đọc là Bearer, một khoảng trắng, sau đó là khóa hay không.
Tên mô hình không phải là uncensored
Các client thường mặc định sử dụng tên mô hình khác. Hãy đặt rõ mô hình cho mọi lệnh gọi.
HTTP 429
Có hai loại, và mã lỗi cho biết sự khác biệt. rate_limited có nghĩa là bạn đã gửi quá nhiều yêu cầu mỗi phút. concurrency có nghĩa là quá nhiều yêu cầu đang được xử lý cùng lúc. Một yêu cầu truyền phát giữ slot độ đồng thời của nó cho đến khi luồng kết thúc, vì vậy một trình đọc chậm có thể gây ra lỗi này ngay cả ở tốc độ yêu cầu thấp. Mã 429 với tiêu đề Retry-After: 5 có nghĩa là dịch vụ đang quá tải tạm thời; hãy đợi năm giây và thử lại. Việc giảm dần theo cấp số nhân ngắn trong client của bạn sẽ xử lý cả ba trường hợp.
Để xem danh sách tham số đầy đủ, định dạng truyền phát và chi tiết gọi công cụ, hãy xem tài liệu API.
Hướng dẫn khác
Hỏi đáp
Đây có phải là khóa OpenAI không?
Không. Nó tuân theo cùng định dạng yêu cầu, vì vậy các SDK OpenAI hoạt động với nó, nhưng nó được cấp bởi dịch vụ này và chỉ hoạt động với base URL của dịch vụ này.
Tôi có cần thẻ tín dụng để lấy khóa không?
Không. Đăng ký bằng Google hoặc email, sau đó nhận tín dụng dùng thử $0,50 bằng một cú nhấp chuột trên trang khóa. Tín dụng dùng thử không cần thẻ và có hiệu lực trong 7 ngày.
Tôi nên sử dụng tên mô hình nào?
Hãy sử dụng uncensored trong trường mô hình. Một lệnh gọi đến GET /v1/models sẽ liệt kê những gì khóa của bạn có thể truy cập.
Tôi có thể sử dụng cùng một khóa từ nhiều máy chủ không?
Có, nhưng các giới hạn áp dụng cho khóa nói chung: 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút trên khóa đầy đủ, 2 và 60 trên khóa dùng thử.
Khóa có hoạt động cho hình ảnh hoặc giọng nói không?
Không. API chỉ hỗ trợ văn bản. API không tạo hoặc chuyển đổi âm thanh hoặc hình ảnh, và cũng không có embeddings hay fine-tuning.
Khóa của bạn chỉ cách một mẫu đơn
Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.