สร้างเสียง
ShareAI endpoint จะคืนผลลัพธ์เสียงแบบ JSON ที่มีขอบเขต.
ในหน้านี้
https://api.shareai.now/api/v1/audio/generationsสร้างเสียง
- Base URL → URL พื้นฐาน
https://api.shareai.now- การตรวจสอบสิทธิ์
- Bearer API key หรือโทเค็นการเข้าถึง OAuth ที่ได้รับการอนุมัติ
- ขอบเขตที่จำเป็น
inferenceormonetization_gateway
ShareAI endpoint ส่งคืนผลลัพธ์ JSON แบบจำกัดสำหรับเสียง คำขอสร้างเสียงที่ modalities:["text","audio"] สามารถใช้ /api/v1/chat/completions. คำขอของคุณจะถูกส่งไปยังการดำเนินการเสียงที่ระบุ การตอบสนองแบบซิงโครนัสนี้จะถูกรวบรวมก่อนการส่งคืน; สตรีมของ Provider ที่ไม่สมบูรณ์จะไม่ถูกเรียกเก็บเงินเป็นผลลัพธ์ที่สำเร็จ รูปแบบเสียงที่ส่งออกได้คือ mp3, wav, flac, pcm16 หรือ pcm24 ขึ้นอยู่กับโมเดล PCM ดิบไม่สามารถรองรับการคิดค่าบริการตามระยะเวลา ตั้งค่า max_tokens หรือ max_completion_tokens เพื่อจำกัดโทเค็นที่สร้างขึ้น; อย่าระบุทั้งสอง.
ก่อนเริ่มต้น#
ตั้งค่า SHAREAI_API_KEY บนเซิร์ฟเวอร์ของคุณและแทนที่ placeholder ของโมเดลด้วยโมเดลที่เปิดใช้งานในปัจจุบัน ห้ามเปิดเผย API key ในโค้ดเบราว์เซอร์ โมเดล บัญชี ข้อมูลรับรอง และผู้ให้บริการต้องอนุญาตการดำเนินการนี้ การตั้งค่าเพิ่มเติมด้านล่างต้องการการสนับสนุนจากโมเดล ขอบเขตความปลอดภัยของ API ไม่ใช่คำสัญญาว่าโมเดลทุกตัวจะรองรับค่าทุกค่า.
ส่งคำขอ#
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);ฟิลด์คำขอ#
| ฟิลด์ | ประเภท | ความหมายและข้อจำกัด |
|---|---|---|
model จำเป็น | สตริง | ตัวระบุโมเดลสาธารณะที่เปิดใช้งานอย่างแม่นยำ ต้องประกาศการดำเนินการนี้และได้รับอนุญาตจากข้อมูลรับรองของคุณ. |
messages จำเป็น | array → อาร์เรย์ | ข้อความสนทนา 1–256 พร้อมบทบาท/เนื้อหา ใช้เฉพาะรูปแบบเนื้อหาที่รองรับโดยโมเดลเสียงที่เลือก. |
modalities | array → อาร์เรย์ | หนึ่งหรือสองค่าที่ไม่ซ้ำกันจากข้อความและเสียง; เสียงเป็นสิ่งจำเป็น ค่าเริ่มต้นคือเสียง Endpoint แบบซิงโครนัสนี้ไม่รองรับการสตรีม. |
audio | ออบเจ็กต์ | ตัวเลือกการส่งออกเพิ่มเติม: เฉพาะเสียงและรูปแบบ รูปแบบคือ mp3, wav, flac, pcm16 หรือ pcm24 ขึ้นอยู่กับการรองรับของโมเดล PCM ดิบไม่เข้ากันกับการคิดค่าบริการตามระยะเวลา. |
temperature | หมายเลข | อุณหภูมิการสร้างที่รองรับโดยโมเดล (ตัวเลือก). |
top_p | หมายเลข | ค่า nucleus sampling ที่รองรับโดยโมเดล (ตัวเลือก). |
max_tokens | จำนวนเต็ม | ขอบเขตโทเค็นที่ส่งออก (ตัวเลือก) 1–262144 อย่ารวมกับ max_completion_tokens. |
max_completion_tokens | จำนวนเต็ม | ขอบเขตโทเค็นที่ส่งออก (ตัวเลือก) 1–262144 อย่ารวมกับ max_tokens. |
provider | ออบเจ็กต์ | การตั้งค่าการกำหนดเส้นทางผู้ให้บริการที่เลือกได้ ใช้ provider.only สำหรับแท็กผู้ให้บริการที่ยอมรับ ไม่ใช่คำนำหน้าใน ID โมเดล ข้อจำกัดบัญชีและข้อมูลรับรองยังคงมีผล. |
อ่านผลลัพธ์#
การตอบสนองสำเร็จส่งคืน HTTP 200 พร้อม JSON ShareAI endpoint ส่งคืนผลลัพธ์ JSON แบบจำกัดสำหรับเสียง คำขอสร้างเสียงที่ modalities:["text","audio"] สามารถใช้ /api/v1/chat/completions. คำขอของคุณจะถูกส่งไปยังการดำเนินการเสียงที่ระบุ การตอบสนองแบบซิงโครนัสนี้จะถูกรวบรวมก่อนการส่งคืน; สตรีมของ Provider ที่ไม่สมบูรณ์จะไม่ถูกเรียกเก็บเงินเป็นผลลัพธ์ที่สำเร็จ รูปแบบเสียงที่ส่งออกได้คือ mp3, wav, flac, pcm16 หรือ pcm24 ขึ้นอยู่กับโมเดล PCM ดิบไม่สามารถรองรับการคิดค่าบริการตามระยะเวลา ตั้งค่า max_tokens หรือ max_completion_tokens เพื่อจำกัดโทเค็นที่สร้างขึ้น; อย่าระบุทั้งสอง.
หน่วยการเรียกเก็บเงิน#
โมเดลเสียงสามารถเผยแพร่มิติของโทเค็นข้อความและโทเค็นเสียงแยกกัน ระยะเวลา อัตราเพลงหรือคำขอ รวมโทเค็นทั้งหมดจะถูกแบ่งออกเป็นตัวนับข้อความ/เสียงที่ไม่ทับซ้อนกัน; โทเค็นเสียงเดียวกันจะไม่ถูกเรียกเก็บเงินซ้ำในรูปแบบข้อความ การใช้งานที่ไม่รองรับหรือขาดหายไปจะไม่ถูกประมาณจากไบต์ที่เข้ารหัส.
เลือกตัวระบุโมเดลที่เปิดใช้งานจาก Console ความสามารถในการดำเนินการและอินพุต/เอาต์พุตที่ประกาศไว้ต้องตรงกับ endpoint นี้ โมเดลแชทข้อความไม่สามารถแทนที่การดำเนินการอื่นได้ ข้อจำกัดข้อมูลรับรอง ผู้ให้บริการ และบัญชีของคุณยังคงมีผล.
การกำหนดราคาและการใช้งาน#
อัตราค่าบริการถูกเผยแพร่ในเครดิต AI สกุลเงิน EUR สำหรับโมเดล ผู้ให้บริการ หน่วย และตัวแปรที่เลือก เฉพาะมิติในอัตราภาษีที่ใช้งานอยู่เท่านั้นที่ถูกเรียกเก็บเงิน การประมาณการจะสำรองเครดิตก่อนการดำเนินการ ค่าใช้จ่ายสุดท้ายใช้การใช้งานที่วัดได้ ราคาอาจขึ้นอยู่กับความละเอียด รูปแบบเอาต์พุต หรือช่วงการใช้งาน ตรวจสอบ Console Usage สำหรับการหักเครดิต ShareAI สุดท้าย ฟิลด์ต้นทุนต้นน้ำและไบต์สื่อจะไม่ถูกแปลงเป็นจำนวน token ที่ถูกสร้างขึ้น.
การเข้าถึงและข้อผิดพลาด#
การใช้งาน inference สำหรับการอนุมานต้นทุนเครือข่ายที่ได้รับการอนุมัติหรือ monetization_gateway สำหรับการเพิ่มราคาของ Builder ที่ได้รับการอนุมัติและเงื่อนไขการเรียกเก็บเงินที่ยอมรับ การเข้าถึงเฉพาะตัวตนไม่อนุญาตให้ใช้จ่าย การตรวจสอบ การอนุญาตโมเดล เครดิตไม่เพียงพอ ขีดจำกัดอัตรา และความล้มเหลวในการดำเนินการจะส่งคืน error. หลังจากหมดเวลาหรือการส่งที่ไม่แน่นอน ให้ตรวจสอบ Usage หรือวิดีโอ job ก่อนสร้างคำขอที่อาจมีค่าใช้จ่ายอีกครั้ง.
อัปเดตล่าสุด พฤศจิกายน 3, 2026