ShareAI Platform Docs

Tạo giọng nói

Phản hồi thành công là âm thanh nhị phân, không phải JSON.

Xem dưới dạng Markdown
Trên trang này
POST https://api.shareai.now/api/v1/audio/speech

Tạo giọng nói

URL cơ sở
https://api.shareai.now
Xác thực
Khóa API Bearer hoặc token truy cập OAuth đã được phê duyệt
Phạm vi yêu cầu
inference or monetization_gateway

Phản hồi thành công là âm thanh nhị phân, không phải JSON. Lưu nó bằng curl --output speech.mp3 hoặc đọc các byte phản hồi trong SDK của bạn. Chọn một giọng nói mô hình được hỗ trợ và định dạng đầu ra; tốc độ được giới hạn từ 0.25 đến 4. Giới hạn đầu vào là 256 KiB và giới hạn phản hồi đồng bộ là 2 MiB.

Trước khi bạn bắt đầu#

Đặt SHAREAI_API_KEY trên máy chủ của bạn và thay thế placeholder model bằng một model hiện đang được kích hoạt. Không bao giờ để lộ khóa API trong mã trình duyệt. Model, tài khoản, thông tin xác thực và nhà cung cấp phải cho phép thực hiện thao tác này. Các cài đặt tùy chọn dưới đây yêu cầu hỗ trợ từ model; giới hạn an toàn của API không đảm bảo rằng mọi model đều hỗ trợ mọi giá trị.

Gửi một yêu cầu#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/speech" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_SPEECH_MODEL",
  "input": "Hello from ShareAI.",
  "response_format": "mp3"
}' --output speech.mp3

Các trường yêu cầu#

TrườngLoạiÝ nghĩa và giới hạn
model bắt buộcchuỗiĐịnh danh mô hình công khai chính xác đã được kích hoạt. Phải khai báo thao tác này và được thông qua bởi thông tin xác thực của bạn.
input bắt buộcchuỗiYêu cầu văn bản lời nói không rỗng, tối đa 256 KiB UTF-8. Biểu phí ký tự tính theo ký tự Unicode, không phải byte mã hóa.
voicechuỗiGiọng nói tùy chọn được hỗ trợ bởi mô hình lời nói đã chọn, tối đa 100 ký tự.
response_formatchuỗiMã hóa âm thanh tùy chọn được hỗ trợ như mp3. Phản hồi thành công là nhị phân, không phải JSON. Các tuyến định giá theo thời lượng cần MP3, WAV hoặc FLAC tự mô tả.
speedsốTốc độ lời nói tùy chọn từ 0.25 đến 4; mô hình có thể áp đặt giới hạn hẹp hơn.
providerđối tượngTùy chọn ưu tiên định tuyến nhà cung cấp. Sử dụng provider.only cho các thẻ nhà cung cấp được chấp nhận, không phải tiền tố trong ID mô hình. Các hạn chế về tài khoản và thông tin xác thực vẫn được áp dụng.

Đọc kết quả#

Thành công trả về HTTP 200 với âm thanh nhị phân. Phản hồi thành công là âm thanh nhị phân, không phải JSON. Lưu nó bằng curl --output speech.mp3 hoặc đọc các byte phản hồi trong SDK của bạn. Chọn một giọng nói mô hình được hỗ trợ và định dạng đầu ra; tốc độ được giới hạn từ 0.25 đến 4. Giới hạn đầu vào là 256 KiB và giới hạn phản hồi đồng bộ là 2 MiB.

Đơn vị thanh toán#

Lời nói có thể được định giá theo ký tự đầu vào, token được báo cáo bởi nhà cung cấp hoặc giây được tạo, tùy thuộc vào mô hình. Số lượng ký tự sử dụng ký tự Unicode. Định giá theo thời lượng yêu cầu kết quả MP3, WAV hoặc FLAC tự mô tả được hỗ trợ. Kết quả PCM thô không có tốc độ mẫu được đoán. Các tuyến định giá theo token cần biên lai sử dụng đáng tin cậy.

Chọn mã định danh model đã kích hoạt chính xác từ Console. Hoạt động được công bố và khả năng đầu vào/đầu ra của nó phải phù hợp với endpoint này; một model trò chuyện văn bản không thể thay thế cho một hoạt động khác. Các hạn chế về thông tin xác thực, nhà cung cấp và tài khoản của bạn vẫn được áp dụng.

Giá cả và sử dụng#

Mức giá được công bố bằng tín dụng AI EUR cho model, nhà cung cấp, đơn vị và biến thể đã chọn. Chỉ các yếu tố trong biểu giá đang hoạt động của nó mới bị tính phí. Một ước tính sẽ giữ trước tín dụng trước khi thực thi; phí cuối cùng sử dụng mức sử dụng được đo lường. Giá có thể phụ thuộc vào độ phân giải, định dạng đầu ra hoặc một dải sử dụng. Kiểm tra Console Usage để biết khoản ghi nợ ShareAI cuối cùng. Các trường chi phí thượng nguồn và byte phương tiện không được chuyển đổi thành số lượng token được tạo ra.

Truy cập và lỗi#

Sử dụng inference cho suy luận chi phí mạng được phê duyệt hoặc monetization_gateway cho một mức tăng giá của Builder được phê duyệt và các điều khoản thanh toán được chấp nhận. Quyền truy cập chỉ danh tính không cho phép chi tiêu. Xác thực, ủy quyền model, tín dụng không đủ, giới hạn tốc độ và lỗi thực thi trả về một cấu trúc error. Sau khi hết thời gian chờ hoặc gửi không chắc chắn, kiểm tra Usage hoặc công việc video trước khi tạo một yêu cầu khác có thể phải trả phí.

Cập nhật lần cuối Tháng 11 3, 2026

Tài liệu Nền tảng ShareAI
Tất cả tài liệu

Tìm kiếm theo tiêu đề hoặc nội dung.

Hỏi về trang này

Chọn một trợ lý để khám phá trang này. Bạn cũng có thể sao chép trang và dán vào cuộc trò chuyện của mình.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI