🔌 REST API v1 · 1 Character = 1 Credit
เอกสาร Genaudiopro Developer API
เชื่อมต่อระบบสร้างเสียง AI ครบทั้ง 7 โมเดล + เสียงโคลนส่วนตัว เข้ากับแอป, บอท, n8n, Make หรือสคริปต์ของคุณด้วย REST API มาตรฐาน
🔐 Base URL และการยืนยันตัวตน (Authentication)
Base URL: https://genaudiopro.com/api/v1
ส่ง API Key (ขึ้นต้นด้วย gap_live_...) ใน HTTP Header อย่างใดอย่างหนึ่ง: Authorization: Bearer gap_live_... หรือ X-API-Key: gap_live_...
POST
สร้างไฟล์เสียง MP3 (หรือส่ง "format":"base64" เพื่อรับเป็น JSON) รองรับ Voice Controls ครบเหมือนหน้าเว็บ/api/v1/ttsGET
ดึงรายชื่อเสียงและ Voice ID ของแต่ละโมเดล รวมถึงเสียงโคลนส่วนตัวของคุณ/api/v1/voices?model=genaudio-v4-turboGET
ตรวจสอบยอดเครดิตคงเหลือ แพ็กเกจปัจจุบัน ลิมิตตัวอักษร และรายชื่อโมเดลทั้งหมด/api/v1/accountcurl -X POST "https://genaudiopro.com/api/v1/tts" \
-H "Authorization: Bearer gap_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "สวัสดีครับ ยินดีต้อนรับสู่ Genaudiopro API",
"model": "genaudio-v4-turbo",
"voice": "Aria",
"speed": 1.0,
"pitch": 0,
"stability": 0.5,
"similarity": 0.75,
"style": 0.0,
"speaker_boost": true
}' \
--output speech.mp3📖 พารามิเตอร์ทั้งหมดของ POST /api/v1/tts (Voice Controls)
ส่งค่า Voice Controls ได้ทั้งที่ระดับบนสุดของ JSON หรือซ้อนในอ็อบเจกต์ voice_settings · ค่าระดับ PRO+ จะเปิดใช้งานเฉพาะบัญชีแผน PRO และ STUDIO ขึ้นไป
| พารามิเตอร์ | ชนิด / ช่วงค่า | ค่าเริ่มต้น | สิทธิ์ | คำอธิบาย |
|---|---|---|---|---|
text * | string (1–20,000) | — | All | ข้อความที่ต้องการสังเคราะห์เสียง (FREE/STARTER ≤ 5,000, PRO ≤ 10,000, STUDIO ≤ 20,000) |
model | string | genaudio-v4-turbo | All | genaudio-v4-turbo · genaudio-v3 · gemini-2.5-flash · gemini-2.5-pro · minimax-hd · vbee-v1 · fish-audio · voice-clone |
voice | string | Aria | All | ชื่อเสียงพากย์สำหรับ V4 Turbo / V3 (54 เสียง) หรือ Gemini 2.5 (30 เสียง) |
voice_id | string | — | All | รหัส Voice ID สำหรับ MiniMax / Vbee / Fish Audio / Custom Voice ID / เสียงโคลน (clone_...) |
speed | number (0.5 – 2.0) | 1.0 | All | ความเร็วในการพูด |
pitch | number (-12 – 12) | 0 | All | ระดับเสียงสูง–ต่ำ (Semitones สำหรับ V4 Turbo / V3) |
stability | number (0.0 – 1.0) | 0.5 | PRO+ | ความสม่ำเสมอของน้ำเสียง |
similarity | number (0.0 – 1.0) | 0.75 | PRO+ | ความเหมือนต้นฉบับ (alias: similarity_boost) |
style | number (0.0 – 1.0) | 0.0 | PRO+ | ระดับการเน้นสไตล์และอารมณ์ |
speaker_boost | boolean | false | PRO+ | เพิ่มความคมชัดมิติเสียง (alias: use_speaker_boost) |
style_prompt | string (≤ 200) | "" | All | คำสั่งกำกับอารมณ์สำหรับ Gemini 2.5 Flash & Pro |
format | "mp3" | "base64" | "mp3" | All | mp3 = ไฟล์เสียงโดยตรง · base64 = JSON พร้อมข้อมูลเครดิต |
📬 Response Headers และรหัสสถานะ (HTTP Status Codes)
| Header / รหัสสถานะ | ความหมาย |
|---|---|
X-Genaudiopro-Job-Id | รหัสงานสำหรับอ้างอิง (บันทึกในแท็บ History 24 ชม.) |
X-Genaudiopro-Credits-Used / -Remaining | จำนวนเครดิตที่ใช้และยอดคงเหลือล่าสุด |
200 / 400 / 401 / 402 / 403 / 429 / 502 | 200 สำเร็จ · 400 พารามิเตอร์ผิด · 401 API Key ผิด · 402 เครดิตไม่พอ · 403 ไม่มีสิทธิ์เสียงโคลน · 429 เกิน 60 req/นาที · 502 ระบบหนาแน่น (ไม่หักเครดิต) |