เริ่มต้นใช้งานสำหรับ Xtts pipelines
ผสาน API ข้อความแบบไม่เซ็นเซอร์ของเราเข้ากับ voice cloning pipeline ของคุณด้วยคู่มือเริ่มต้นนี้ เรียนรู้การสร้างสคริปต์ คำบรรยาย และผลลัพธ์ข้อความดิบโดยใช้เอนด์พอยต์ที่เข้ากันได้กับ OpenAI
การตรวจสอบสิทธิ์และ Base URL
เริ่มโดยไปที่หน้า รับคีย์ API และเข้าสู่ระบบด้วย Google หรือรหัสผ่านอีเมล คุณจะได้รับคีย์ API ที่เป็นเอกลักษณ์ทันที ใช้ Base URL https://api.xtts.cc/v1 สำหรับคำขอทั้งหมด URL นี้เข้ากันได้กับ SDK ทางการของ OpenAI และไคลเอนต์ใดๆ ที่รองรับรูปแบบ chat-completions ของ OpenAI
รวมคีย์ของคุณในหัว Authorization เป็น bearer token รหัสโมเดลที่คุณต้องส่งคือ uncensored โมเดลแบบเปิดน้ำหนักนี้โฮสต์บนเซิร์ฟเวอร์ของเราและปรับแต่งให้ตอบโดยไม่มีการปฏิเสธเนื้อหาสำหรับการใช้งานผู้ใหญ่ที่ถูกต้องตามกฎหมาย เพื่อให้ voice pipeline ของคุณได้รับข้อความดิบที่ต้องการ
สร้างข้อความแบบไม่เซ็นเซอร์
ส่งคำขอ POST ไปยัง /v1/chat/completions พร้อมระบบและพรอมต์ผู้ใช้ API จะส่งคืน JSON ที่มีโครงสร้างซึ่งประกอบด้วยข้อความที่สร้าง เอนด์พอยต์นี้ถูกออกแบบมาสำหรับการเขียนพรอมต์ การสร้างสคริปต์ และงานหลังการประมวลผลใน workflow voice cloning ของคุณ
ร่างคำขอรวมถึงชื่อโมเดล ประวัติข้อความของคุณ และพารามิเตอร์เสริมเช่น temperature หรือ top_p คุณสามารถควบคุมความยาวผลลัพธ์ด้วยพารามิเตอร์ max_tokens หากคุณไม่ได้ตั้งค่า max_tokens การตอบกลับอาจยาวไปจนสุด context window
curl https://api.xtts.cc/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
ผสาน SDK Python
ใช้ SDK Python ทางการของ OpenAI เพื่อโต้ตอบกับ API ของเรา ตั้งค่า base_url เป็นเอนด์พอยต์ของเราและระบุคีย์ API ของคุณ วิธีนี้ช่วยให้คุณใช้โครงสร้างโค้ดที่มีอยู่ขณะได้รับประโยชน์จากพฤติกรรมของโมเดลแบบไม่เซ็นเซอร์ของเรา
สร้างอินสแตนซ์ไคลเอนต์ด้วย base URL แล้วเรียก chat.completions.create ส่งรหัสโมเดล uncensored และข้อความของคุณ วัตถุผลลัพธ์ประกอบด้วยข้อความที่สร้างใน content วิธีนี้เหมาะสำหรับสคริปต์การประมวลผลแบบแบตช์หรือการผสานการสร้างข้อความลงในแอปพลิเคชัน Python ขนาดใหญ่
from openai import OpenAI
client = OpenAI(base_url="https://api.xtts.cc/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
ผสาน SDK Node
สำหรับสภาพแวดล้อม JavaScript ให้ใช้ SDK Node ของ OpenAI กำหนดค่าไคลเอนต์ด้วย base URL และคีย์ API ของเรา การตั้งค่านี้ช่วยให้คุณสร้างข้อความโดยตรงในแอปพลิเคชันเว็บหรือฝั่งเซิร์ฟเวอร์ของคุณ
เรียกเอนด์พอยต์ chat completions ด้วยโมเดล uncensored ผลลัพธ์ให้ข้อความที่สร้างซึ่งคุณสามารถส่งต่อไปยังเครื่องสังเคราะห์เสียงของคุณได้ การผสานนี้เหมาะสำหรับการสร้างข้อความแบบเรียลไทม์ในเว็บแอปหรือบริการแบ็กเอนด์ที่เตรียมสคริปต์สำหรับ voice cloning
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.xtts.cc/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
ผลลัพธ์แบบสตรีมมิง
เปิดใช้งานสตรีมมิงโดยตั้งค่า stream เป็น true ในคำขอของคุณ API จะส่ง Server-Sent Events (SSE) สำหรับแต่ละโทเคนที่สร้าง คุณลักษณะนี้มีประโยชน์สำหรับการแสดงข้อความแบบเรียลไทม์หรือการเตรียมการสังเคราะห์เสียงแบบก้าวหน้า
แต่ละชิ้นเหตุการณ์มีข้อความบางส่วน ชิ้นสุดท้ายมีสถิติการใช้งาน เช่น จำนวนโทเคน การสตรีมช่วยให้แอปพลิเคชันของคุณประมวลผลข้อความขณะที่กำลังสร้างอยู่ ลดความล่าช้าที่ผู้ใช้รู้สึก จัดการเหตุการณ์สตรีมเพื่อรวบรวมการตอบกลับที่สมบูรณ์
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
ขีดจำกัดอัตราและพารามิเตอร์
คีย์ API แต่ละคีย์จำกัดอยู่ที่ 300 คำขอต่อนาทีและ 8 คำขอพร้อมกัน ร่างคำขอต้องไม่เกิน 8 MB หากคุณส่งคีย์ที่ไม่ถูกต้องคุณจะได้รับข้อผิดพลาด 401 หากเครดิตแบบเติมเงินล่วงหน้าของคุณหมดลงคุณจะได้รับข้อผิดพลาด 402 การเกินขีดจำกัดอัตราจะส่งผลให้ได้รับข้อผิดพลาด 429
หน้าต่างบริบทรองรับ 100,000 โทเคนรวม ทั้งพรอมต์และการสร้างข้อความ ไม่มีขีดจำกัดผลลัพธ์แยกต่างหาก และคุณสามารถระบุค่า max_tokens ที่ต่ำกว่าได้หากต้องการคำตอบที่สั้นลง ข้อผิดพลาดและการปฏิเสธไม่ใช้เครดิตแบบเติมเงินล่วงหน้าของคุณ รองรับ function calling และโหมด JSON สำหรับการสกัดข้อมูลที่มีโครงสร้าง
ข้อมูลจำเพาะ API
ขีดจำกัดและความสามารถจริงทั้งหมดของ API ในที่เดียว ตรวจสอบก่อนเติมเงิน
| รายการ | ค่า |
|---|---|
| รูปแบบ API | รองรับ OpenAI: ใช้ OpenAI SDK ใดก็ได้ แค่เปลี่ยน base URL และคีย์ |
| เอนด์พอยต์ | POST /v1/chat/completions · GET /v1/models |
| การยืนยันตัวตน | Authorization: Bearer YOUR_KEY |
| ID โมเดล | uncensored |
| Base URL | https://api.xtts.cc/v1 |
| การเรียกใช้ฟังก์ชัน | รองรับ — tools, tool_choice คำตอบมี tool_calls รวมถึงตอนสตรีม ส่งผลลัพธ์กลับด้วย role: tool |
| เอาต์พุตสูงสุด | ได้ถึงส่วนที่เหลือของหน้าต่าง 100,000 โทเคน; max_tokens ไม่บังคับ (ไม่มีเพดานแยก) |
| พารามิเตอร์ | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| โหมด JSON | response_format: {"type": "json_object"} |
| หน้าต่างบริบท | 100,000 โทเคน (อินพุตรวมเอาต์พุต) |
| สตรีมมิง | รองรับ — server-sent events ชิ้นสุดท้ายมีจำนวนโทเคนที่ใช้ |
| ขนาดคำขอ | ไม่เกิน 8 MB |
| คำขอพร้อมกัน | สูงสุด 8 คำขอพร้อมกันต่อคีย์ |
| เฮดเดอร์ของคำตอบ | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| ขีดจำกัดอัตรา | 300 คำขอต่อนาทีต่อคีย์ |
| เครดิตทดลองใช้ฟรี | $0.50 ใช้ได้ 7 วัน ไม่ต้องใช้บัตร · คีย์ทดลอง: 2 คำขอพร้อมกัน, 60 ครั้งต่อนาที; ขีดจำกัดเต็ม (8 และ 300) หลังเติมเงินครั้งแรก |
| ราคา | $0.15 ต่อ 1 ล้านโทเคนอินพุต · $0.50 ต่อ 1 ล้านโทเคนเอาต์พุต |
| การคิดเงิน | เครดิตแบบเติมเงินล่วงหน้าตามการใช้งานจริง ข้อผิดพลาดและการปฏิเสธไม่คิดเงิน |
| เติมเงิน | USDT (TRC20) หรือ USDC (Base) จำนวนเต็มใดก็ได้ตั้งแต่ $20 ถึง $500 |
| โบนัส | +5% เมื่อเติมตั้งแต่ $50, +10% ตั้งแต่ $100, +15% ตั้งแต่ $200 |
| อายุเครดิต | เครดิตที่ซื้อไม่มีวันหมดอายุ ไม่มีการสมัครรายเดือน |
| เข้าสู่ระบบ | Google หรืออีเมลและรหัสผ่าน |
| คีย์ | หนึ่งบัญชีมีคีย์ที่ใช้งานได้หนึ่งคีย์ คีย์ใหม่จะแทนคีย์เดิม |
| เนื้อหา | อนุญาตเนื้อหาสำหรับผู้ใหญ่ ปฏิเสธเนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์ |
รหัสข้อผิดพลาด
ข้อผิดพลาดส่งกลับเป็น JSON พร้อม type ที่คงที่ คำขอที่ล้มเหลวหรือถูกปฏิเสธไม่คิดเงิน
| HTTP | ประเภท | ความหมาย |
|---|---|---|
400 | bad_request | JSON ไม่ถูกต้อง ข้อความว่าง พารามิเตอร์ผิด หรือเกินหน้าต่างบริบท |
401 | missing_key · invalid_key · key_revoked | ไม่มีคีย์ คีย์ผิด หรือคีย์ถูกแทนที่แล้ว |
402 | no_credit | เครดิตหมด เติมเงินแล้วใช้งานต่อได้ทันที |
403 | content_blocked | เนื้อหาทางเพศเกี่ยวกับผู้เยาว์ ถูกปฏิเสธ ไม่คิดเงิน |
404 | not_found | ไม่รู้จักเอนด์พอยต์ |
413 | request_too_large | ขนาดเกิน 8 MB |
429 | rate_limited · concurrency | เกิน 300/นาที หรือ 8 พร้อมกัน รอแล้วลองใหม่ |
503 | upstream_busy | โมเดลไม่ว่าง ลองใหม่ในไม่กี่วินาที |
ถาม-ตอบ
เติมเงินเครดิตแบบเติมเงินล่วงหน้าอย่างไร?
คุณสามารถเติมเงินด้วยคริปโต (USDT บน TRC20, USDC บน Base) จำนวนที่รับได้คือ $20 ถึง $500 รับโบนัส 5% สำหรับยอดเติม $50 ขึ้นไป และโบนัส 10% สำหรับ $100 ขึ้นไป เครดิตไม่หมดอายุ
API สร้างเสียงหรือวิดีโอหรือไม่?
ไม่ API นี้ใช้สำหรับการสร้างข้อความเท่านั้น มันให้ผลลัพธ์ข้อความแบบไม่เซ็นเซอร์ที่คุณสามารถนำไปใช้ใน voice synthesis หรือ video pipeline ของคุณเองได้ มันไม่สร้างไฟล์เสียง รูปภาพ หรือวิดีโอโดยตรง
ข้อเสนอทดลองใช้คืออะไร?
ผู้ใช้ใหม่ได้รับเครดิตทดลองใช้ $0.50 จำนวนหนึ่งต่อคน ใช้ได้เป็นเวลา 7 วัน โอนเครดิตนี้ด้วยการคลิกเดียวบนหน้าคีย์ API ของคุณ ไม่ต้องใช้บัตรเครดิตในการสมัคร สิ่งนี้ช่วยให้คุณทดสอบ API ก่อนซื้อเครดิตแบบเติมเงินล่วงหน้า
คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว
สร้างบัญชี คัดลอกคีย์ เปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด