ShareAI Platform Docs

สร้างเสียง

ShareAI endpoint จะคืนผลลัพธ์เสียงแบบ JSON ที่มีขอบเขต.

ดูในรูปแบบ Markdown
ในหน้านี้
POST https://api.shareai.now/api/v1/audio/generations

สร้างเสียง

Base URL → URL พื้นฐาน
https://api.shareai.now
การตรวจสอบสิทธิ์
Bearer API key หรือโทเค็นการเข้าถึง OAuth ที่ได้รับการอนุมัติ
ขอบเขตที่จำเป็น
inference or monetization_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
}'

ฟิลด์คำขอ#

ฟิลด์ประเภทความหมายและข้อจำกัด
model จำเป็นสตริงตัวระบุโมเดลสาธารณะที่เปิดใช้งานอย่างแม่นยำ ต้องประกาศการดำเนินการนี้และได้รับอนุญาตจากข้อมูลรับรองของคุณ.
messages จำเป็นarray → อาร์เรย์ข้อความสนทนา 1–256 พร้อมบทบาท/เนื้อหา ใช้เฉพาะรูปแบบเนื้อหาที่รองรับโดยโมเดลเสียงที่เลือก.
modalitiesarray → อาร์เรย์หนึ่งหรือสองค่าที่ไม่ซ้ำกันจากข้อความและเสียง; เสียงเป็นสิ่งจำเป็น ค่าเริ่มต้นคือเสียง 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

เอกสารแพลตฟอร์ม ShareAI
เอกสารทั้งหมด

ค้นหาตามชื่อหรือเนื้อหา.

สอบถามเกี่ยวกับหน้านี้

เลือกผู้ช่วยเพื่อสำรวจหน้านี้ คุณยังสามารถคัดลอกหน้าและวางลงในบทสนทนาของคุณได้.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI