Base URL ของ API TTS: คืออะไรและต้องกรอกอะไร คืออะไรและต้องกรอกอะไร

URL พื้นฐาน และสิ่งหนึ่งที่ต้องรู้ก่อน

หากคุณมาถึงหน้านี้โดยการค้นหา tts api base url ให้ตรวจสอบรายละเอียดหนึ่งอย่างก่อนคัดลอกสิ่งใด: บริการที่อยู่เบื้องหลังเว็บไซต์นี้คือ API โมเดลภาษาข้อความ ไม่ใช่เครื่องสังเคราะห์เสียง URL พื้นฐานคือ https://api.ttsapihub.com/v1 และเปิดใช้งาน POST /v1/chat/completions และ GET /v1/models ไม่มีเส้นทาง /audio/speech ไม่มีรายการเสียง และไม่มีเอาต์พุตเสียง

สิ่งนี้สำคัญเนื่องจากเครื่องมือจำนวนมากตั้งชื่อการตั้งค่าแบบทั่วไป ช่องที่เรียกว่า URL พื้นฐานในไคลเอนต์ทำงานเหมือนกันไม่ว่าเซิร์ฟเวอร์ที่อยู่เบื้องหลังจะตอบกลับด้วยข้อความหรือเสียง หากเป้าหมายของคุณคือการแปลงข้อความเป็นเสียง เอนด์พอยต์นี้ไม่สามารถทำได้ หากเป้าหมายของคุณคือการสร้างข้อความที่เครื่องมือเสียงจะอ่านในภายหลัง เช่น บทสคริปต์ บทสนทนา หรือร่างการบรรยาย มันเหมาะมาก TTS pipeline checklist ของเว็บไซต์คือสถานที่ที่คุณควรดูเมื่อวางแผน workflow แบบนั้น และ quickstart docs ระบุพารามิเตอร์คำขอทั้งหมด

ส่วนที่เหลือของหน้านี้ใช้ได้กับไคลเอนต์ที่เข้ากันได้กับ OpenAI ใดๆ ดังนั้นจึงมีประโยชน์แม้ว่าคุณจะอยู่ที่นี่เพื่อเรียนรู้ว่า URL พื้นฐานทำงานอย่างไร

URL พื้นฐานจริงๆ แล้วคืออะไร

ที่อยู่ API มีสองส่วน ส่วนแรกระบุบริการและเวอร์ชันของอินเทอร์เฟซของมัน ส่วนที่สองระบุการกระทำ ไลบรารีไคลเอนต์จะรวมสองส่วนนี้เข้าด้วยกันสำหรับคุณ ด้วย SDK ของ OpenAI ชิ้นส่วนจะปรากฏดังนี้:

ส่วน	ค่า
URL พื้นฐาน	https://api.ttsapihub.com/v1
Path ที่เพิ่มโดย SDK สำหรับ chat	/chat/completions
ที่อยู่เต็มที่ถูกเรียก	https://api.ttsapihub.com/v1/chat/completions
Path สำหรับรายการโมเดล	/models

เนื่องจาก SDK เพิ่ม path เข้าไป คุณจึงให้เฉพาะส่วนแรกเท่านั้น นี่คือแนวคิดทั้งหมดเบื้องหลังการเปลี่ยนผู้ให้บริการด้วยการเปลี่ยนแปลงบรรทัดเดียว: รูปแบบคำขอถูกแชร์ ดังนั้นสิ่งเดียวที่ต้องเปลี่ยนคือตำแหน่งที่ส่งคำขอ คีย์ก็เปลี่ยนเช่นกัน เนื่องจากแต่ละบริการออกคีย์ของตัวเอง และชื่อโมเดลก็เปลี่ยน เนื่องจากแต่ละบริการตั้งชื่อโมเดลของตัวเอง สำหรับ API นี้ model ID คือ uncensored

รายละเอียดเล็กๆ น้อยๆ สองอย่างช่วยประหยัดเวลา ส่วนเวอร์ชัน /v1 เป็นส่วนหนึ่งของ base URL เพราะมันระบุรุ่นของอินเทอร์เฟซ; อินเทอร์เฟซที่ไม่เข้ากันได้ในอนาคตจะอยู่ภายใต้เวอร์ชันอื่น และโค้ดของคุณจะไม่เปลี่ยนแปลงจนกว่าคุณจะเลือกที่จะย้าย และเครื่องหมายทับท้ายบน base URL นั้น SDK ส่วนใหญ่ยอมรับ แต่ปลอดภัยกว่าที่จะปล่อยไว้โดยไม่ใส่เพื่อให้ path ที่รวมกันไม่มีเครื่องหมายทับสองครั้ง

การตรวจสอบสิทธิ์เป็น header bearer มาตรฐาน: Authorization: Bearer YOUR_KEY SDK สร้าง header นั้นจากคีย์ที่คุณส่งเข้ามา ดังนั้นคุณจึงแทบไม่ต้องเขียนมันเอง ยกเว้นใน curl

การตั้งค่า base URL ในโค้ด

Python

แพ็กเกจ openai แบบทางการรับอาร์กิวเมนต์ base_url นี่คือคำสั่งทำงานเต็มรูปแบบ:

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.ttsapihub.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a two-line scene opening."}],
)
print(resp.choices[0].message.content)

Node

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.ttsapihub.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a two-line scene opening." }],
});
console.log(resp.choices[0].message.content);

curl

ด้วย curl คุณต้องเขียนที่อยู่เต็มรูปแบบเอง ดังนั้น path จึงรวมอยู่ด้วย:

Copycurl https://api.ttsapihub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Say hello."}]}'

ตัวแปรสภาพแวดล้อม

เวอร์ชันล่าสุดของ SDK ของ OpenAI แบบทางการอ่านค่า OPENAI_BASE_URL และ OPENAI_API_KEY จาก environment เมื่อคุณไม่ได้ส่งค่าเหล่านั้นในโค้ด สิ่งนี้มีประโยชน์เมื่อคุณต้องการชี้ซอฟต์แวร์ที่มีอยู่กับเอนด์พอยต์ใหม่โดยไม่ต้องแก้ไขมัน ตั้งค่าใน shell หรือ process manager ของคุณ แล้วรันโปรแกรมตามปกติ ตรวจสอบเอกสารของเวอร์ชัน SDK ของคุณหากมันไม่ดึงค่าเหล่านี้

การตั้งค่าในโปรแกรมแก้ไขและแอป

เครื่องมือที่ยอมรับเอนด์พอยต์ OpenAI แบบกำหนดเองจะขอค่าสามค่าเดียวกัน ชื่อแตกต่างกัน ดังนั้นให้มองหาคำอธิบายเช่นต่อไปนี้:

• Cursor: ในการตั้งค่าโมเดลมีตัวเลือกเพื่อแทนที่ base URL ของ OpenAI วาง https://api.ttsapihub.com/v1 เพิ่มคีย์ของคุณ และเพิ่ม uncensored เป็นชื่อโมเดลแบบกำหนดเอง Label ของอินเทอร์เฟซเปลี่ยนแปลงระหว่างเวอร์ชันของ Cursor ดังนั้นให้ใช้ชื่อเหล่านี้เป็นแนวทาง
• SillyTavern: เลือก Chat Completion จากนั้นเลือกแหล่งข้อมูลแบบกำหนดเอง (เข้ากันได้กับ OpenAI) และกรอกเอนด์พอยต์ คีย์ และโมเดล
• Open WebUI และหน้าเว็บแชทคล้ายกัน: เพิ่มการเชื่อมต่อแบบ OpenAI ด้วย base URL และคีย์
• สคริปต์ของคุณเอง: ไคลเอนต์ HTTP ใดๆ ก็ใช้งานได้ เนื่องจากอินเทอร์เฟซคือ JSON ธรรมดาผ่าน HTTPS

เครื่องมือบางตัวตรวจสอบการเชื่อมต่อโดยการเรียก GET /v1/models API นี้รองรับเส้นทางนั้น ดังนั้นการตรวจสอบจึงผ่าน เครื่องมือบางตัวอนุญาตให้คุณเลือกจากรายการคงที่เท่านั้น หากเครื่องมือของคุณเป็นแบบนั้น ให้มองหาฟิลด์โมเดลแบบกำหนดเองหรือแบบแมนนวลแทนรายการแบบเลื่อนลง

จำไว้ว่าเครื่องมือนี้ใช้ทำอะไร Editor อย่าง Cursor จะส่งคำถามเกี่ยวกับโค้ดไปยังโมเดลแชททั่วไป ซึ่งใช้งานได้ แต่ฟีเจอร์ที่ขึ้นอยู่กับเอนด์พอยต์พิเศษ เช่น embeddings สำหรับการค้นหาโค้ด จะไม่พร้อมใช้งานที่นี่ เนื่องจากไม่ได้ให้บริการ embeddings

ข้อผิดพลาดที่ทำให้เกิดข้อผิดพลาดของ base URL ส่วนใหญ่

การเชื่อมต่อครั้งแรกที่ล้มเหลวเกือบทั้งหมดมาจากสาเหตุเหล่านี้

1. การเพิ่มเวอร์ชันซ้ำ base URL จบด้วย /v1 อยู่แล้ว หากเพิ่มเข้าไปอีก ที่อยู่จะกลายเป็น /v1/v1/chat/completions และเซิร์ฟเวอร์จะตอบกลับด้วยข้อผิดพลาด not-found
2. การวางเส้นทางเต็ม ฟิลด์ base URL ต้องการ https://api.ttsapihub.com/v1 ไม่ใช่ https://api.ttsapihub.com/v1/chat/completions SDK จะเพิ่มเส้นทางเข้าไปอีกครั้ง
3. การใช้ที่อยู่เว็บไซต์ เว็บไซต์ที่คุณกำลังอ่านไม่ใช่โฮสต์ API การร้องขอจะไปยังโฮสต์ api. ที่แสดงด้านบน
4. การเรียกใช้เส้นทางเสียง เส้นทางเช่น /audio/speech ไม่มีที่นี่และจะส่งข้อผิดพลาด
5. ชื่อโมเดลผิดหรือขาดหายไป ส่ง uncensored ตัวพิมพ์เล็กเสมอ
6. ปัญหาเกี่ยวกับคีย์ ช่องว่างที่เกินมาหรือการขาด prefix Bearer ใน header ที่เขียนด้วยมือ จะทำให้เกิดข้อผิดพลาดการตรวจสอบสิทธิ์

เพื่อแยกปัญหา URL ออกจากปัญหาคีย์ ให้ขอรายการโมเดล URL ที่ถูกต้องและคีย์ที่ผิดจะเกิดข้อผิดพลาดการตรวจสอบสิทธิ์ URL ที่ผิดจะเกิด not found, ข้อผิดพลาด DNS หรือหน้า HTML แทน JSON

Copycurl https://api.ttsapihub.com/v1/models -H "Authorization: Bearer $API_KEY"
# then a minimal chat call with the model ID "uncensored":
curl https://api.ttsapihub.com/v1/chat/completions -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}'

รับคีย์และราคา

คุณต้องการคีย์ก่อนที่สิ่งเหล่านี้จะใช้งานได้ ลงทะเบียนด้วย Google หรือด้วยอีเมลและรหัสผ่านที่ หน้า API key จากนั้นรับเครดิตทดลองใช้ $0.50 ด้วยคลิกเดียว เครดิตนี้ใช้งานได้ 7 วัน รับได้ครั้งเดียวต่อบุคคล และไม่ต้องใช้บัตร คีย์ทดลองอนุญาตให้ทำ parallel requests ได้ 2 คำขอ และ 60 คำขอต่อนาที ในขณะที่คีย์เต็มอนุญาตให้ทำ 8 คำขอพร้อมกัน และ 300 คำขอต่อนาที

ราคาอยู่ที่ $0.15 ต่อ 1M input tokens และ $0.50 ต่อ 1M output tokens จ่ายจาก prepaid credit โดยไม่มีบริการแบบสมาชิก คำขอที่มี input tokens 2,000 และ output tokens 500 มีค่าใช้จ่าย $0.0003 บวก $0.00025 รวมเป็น $0.00055 การเติมเงินเริ่มต้นที่ $20 ถึง $500 พร้อมโบนัสตั้งแต่ $50 และคุณสามารถจ่ายด้วยบัตร (Visa, Mastercard, Apple Pay, Google Pay) หรือ crypto (USDT บน TRC20, USDC บน Base) pricing page มีตารางราคาเต็ม พรอมต์ไม่ถูกใช้ในการฝึกสอน และโมเดลนี้ใช้สำหรับผู้ใหญ่ตามกฎหมายเท่านั้น ไม่มีเนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์

คู่มือเพิ่มเติม

• API ฟรีสำหรับ SillyTavern: เครดิตทดลองและการตั้งค่า
• TTS API Key ใน Python: การตั้งค่า การสตรีมมิง โหมด JSON
• รายการตรวจสอบ API ของ Elevenlabs: ไปป์ไลน์ TTS แบบไม่เซ็นเซอร์