🔌 REST API v1 · 1 Character = 1 Credit

เอกสาร Genaudiopro Developer API

เชื่อมต่อระบบสร้างเสียง AI ครบทั้ง 7 โมเดล + เสียงโคลนส่วนตัว เข้ากับแอป, บอท, n8n, Make หรือสคริปต์ของคุณด้วย REST API มาตรฐาน

🔑 เข้าสู่ระบบเพื่อรับ API Key (ฟรี 1,000 เครดิต)ดูแพ็กเกจราคา

🔐 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/api/v1/tts
สร้างไฟล์เสียง MP3 (หรือส่ง "format":"base64" เพื่อรับเป็น JSON) รองรับ Voice Controls ครบเหมือนหน้าเว็บ
GET/api/v1/voices?model=genaudio-v4-turbo
ดึงรายชื่อเสียงและ Voice ID ของแต่ละโมเดล รวมถึงเสียงโคลนส่วนตัวของคุณ
GET/api/v1/account
ตรวจสอบยอดเครดิตคงเหลือ แพ็กเกจปัจจุบัน ลิมิตตัวอักษร และรายชื่อโมเดลทั้งหมด
curl -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)
modelstringgenaudio-v4-turboAllgenaudio-v4-turbo · genaudio-v3 · gemini-2.5-flash · gemini-2.5-pro · minimax-hd · vbee-v1 · fish-audio · voice-clone
voicestringAriaAllชื่อเสียงพากย์สำหรับ V4 Turbo / V3 (54 เสียง) หรือ Gemini 2.5 (30 เสียง)
voice_idstring—Allรหัส Voice ID สำหรับ MiniMax / Vbee / Fish Audio / Custom Voice ID / เสียงโคลน (clone_...)
speednumber (0.5 – 2.0)1.0Allความเร็วในการพูด
pitchnumber (-12 – 12)0Allระดับเสียงสูง–ต่ำ (Semitones สำหรับ V4 Turbo / V3)
stabilitynumber (0.0 – 1.0)0.5PRO+ความสม่ำเสมอของน้ำเสียง
similaritynumber (0.0 – 1.0)0.75PRO+ความเหมือนต้นฉบับ (alias: similarity_boost)
stylenumber (0.0 – 1.0)0.0PRO+ระดับการเน้นสไตล์และอารมณ์
speaker_boostbooleanfalsePRO+เพิ่มความคมชัดมิติเสียง (alias: use_speaker_boost)
style_promptstring (≤ 200)""Allคำสั่งกำกับอารมณ์สำหรับ Gemini 2.5 Flash & Pro
format"mp3" | "base64""mp3"Allmp3 = ไฟล์เสียงโดยตรง · 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 / 502200 สำเร็จ · 400 พารามิเตอร์ผิด · 401 API Key ผิด · 402 เครดิตไม่พอ · 403 ไม่มีสิทธิ์เสียงโคลน · 429 เกิน 60 req/นาที · 502 ระบบหนาแน่น (ไม่หักเครดิต)