Tạo âm thanh
Endpoint ShareAI trả về kết quả âm thanh JSON có giới hạn.
Trên trang này
https://api.shareai.now/api/v1/audio/generationsTạo âm thanh
- 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
inferenceormonetization_gateway
Điểm cuối ShareAI trả về một kết quả âm thanh JSON có giới hạn. Các yêu cầu tạo âm thanh với modalities:["text","audio"] cũng có thể sử dụng /api/v1/chat/completions. Yêu cầu của bạn được định tuyến đến thao tác âm thanh đã khai báo. Phản hồi đồng bộ này được thu thập trước khi trả về; các luồng nhà cung cấp không hoàn chỉnh sẽ không được tính là kết quả thanh toán thành công. Các định dạng đầu ra âm thanh bao gồm mp3, wav, flac, pcm16 hoặc pcm24, tùy thuộc vào mô hình. PCM thô không hỗ trợ biểu giá theo thời lượng. Đặt max_tokens hoặc max_completion_tokens để giới hạn số lượng token được tạo; không cung cấp cả hai.
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/generations" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_AUDIO_MODEL',
'messages': [{'role': 'user', 'content': 'A short instrumental melody.'}],
'modalities': ['text', 'audio'],
'audio': {'format': 'mp3'},
'max_completion_tokens': 1024}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/generations', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/audio/generations", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Các trường yêu cầu#
| Trường | Loại | Ý nghĩa và giới hạn |
|---|---|---|
model bắt buộc | chuỗ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. |
messages bắt buộc | mảng | 1–256 tin nhắn hội thoại với vai trò/nội dung. Chỉ sử dụng các phương thức nội dung được hỗ trợ bởi mô hình âm thanh đã chọn. |
modalities | mảng | Một hoặc hai giá trị duy nhất từ văn bản và âm thanh; âm thanh là bắt buộc. Mặc định là âm thanh. Điểm cuối đồng bộ này không chấp nhận luồng. |
audio | đối tượng | Các tùy chọn đầu ra tùy chọn: chỉ giọng nói và định dạng. Định dạng là mp3, wav, flac, pcm16 hoặc pcm24, tùy thuộc vào hỗ trợ của mô hình. PCM thô không tương thích với biểu giá theo thời lượng. |
temperature | số | Nhiệt độ tạo tùy chọn được hỗ trợ bởi mô hình. |
top_p | số | Giá trị lấy mẫu hạt nhân tùy chọn được hỗ trợ bởi mô hình. |
max_tokens | số nguyên | Giới hạn token đầu ra tùy chọn, 1–262144. Không kết hợp với max_completion_tokens. |
max_completion_tokens | số nguyên | Giới hạn token đầu ra tùy chọn, 1–262144. Không kết hợp với max_tokens. |
provider | đối tượng | Tù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 JSON. Điểm cuối ShareAI trả về một kết quả âm thanh JSON có giới hạn. Các yêu cầu tạo âm thanh với modalities:["text","audio"] cũng có thể sử dụng /api/v1/chat/completions. Yêu cầu của bạn được định tuyến đến thao tác âm thanh đã khai báo. Phản hồi đồng bộ này được thu thập trước khi trả về; các luồng nhà cung cấp không hoàn chỉnh sẽ không được tính là kết quả thanh toán thành công. Các định dạng đầu ra âm thanh bao gồm mp3, wav, flac, pcm16 hoặc pcm24, tùy thuộc vào mô hình. PCM thô không hỗ trợ biểu giá theo thời lượng. Đặt max_tokens hoặc max_completion_tokens để giới hạn số lượng token được tạo; không cung cấp cả hai.
Đơn vị thanh toán#
Các mô hình âm thanh có thể công bố các kích thước riêng biệt cho token văn bản và token âm thanh, thời lượng, bài hát hoặc tỷ lệ yêu cầu. Tổng số token bao gồm được chia thành các bộ đếm văn bản/âm thanh riêng biệt; các token âm thanh giống nhau sẽ không bao giờ bị tính phí lại dưới dạng văn bản. Việc sử dụng không được hỗ trợ hoặc bị thiếu sẽ không được ước tính từ các byte đã mã hóa.
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