เริ่มต้นเชื่อมต่อ

ส่งคีย์ใน Header X-Token จาก Server ของคุณ เก็บคีย์เป็นความลับและเลือกสิทธิ์เท่าที่ต้องใช้

Base URL: https://voice8.cutdee.com/api/v1
X-Token: YOUR_TOKEN
Content-Type: application/json

คำขอสร้างงานต้องส่ง Idempotency-Key ที่ไม่ซ้ำกันต่อหนึ่งงาน หากเครือข่ายขาดและยังไม่ทราบผล ให้ส่งข้อมูลเดิมกับคีย์เดิมเพื่อป้องกันงานซ้ำ

เรียก GET /voices เพื่อเลือก voice_id แล้วส่งข้อความไม่เกิน 3,000 ตัวอักษร ไม่ต้องอัปโหลดวิดีโอ ถ้าใช้ instruct ส่งคำสั่งน้ำเสียงได้ไม่เกิน 300 ตัวอักษร

curl 'https://voice8.cutdee.com/api/v1/tts/jobs' \
  -H 'X-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: YOUR_UNIQUE_JOB_KEY' \
  --data '{"text":"สวัสดีครับ ยินดีต้อนรับ","voice_id":"VOICE_ID"}'

อัปโหลดไฟล์ก่อน แล้วใช้ upload.id สร้างงานทำซับ บริการนี้ไม่สร้างเสียงพากย์ รองรับเสียงภาษาไทย ความยาวไม่เกิน 30 นาที คำขออัปโหลดรวมไม่เกิน 512 MiB โดยนับรวมข้อมูลประกอบไฟล์ด้วย

curl 'https://voice8.cutdee.com/api/v1/uploads' \
  -H 'X-Token: YOUR_TOKEN' \
  -F 'file=@video.mp4'

curl 'https://voice8.cutdee.com/api/v1/subtitles/jobs' \
  -H 'X-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: YOUR_UNIQUE_JOB_KEY' \
  --data '{"upload_id":"UPLOAD_ID","language":"th","outputs":["srt","vtt","json"]}'

ติดตามงานและรับผลลัพธ์

เก็บ job.id จากคำตอบ แล้วเรียกสถานะเป็นระยะ งานที่ Server รับแล้วจะรอคิวต่อได้แม้ปิดเว็บไซต์

curl 'https://voice8.cutdee.com/api/v1/jobs/JOB_ID' \
  -H 'X-Token: YOUR_TOKEN'

เมื่อสำเร็จ อ่านรายการไฟล์จาก job.result.artifacts แล้วดาวน์โหลดจาก url พร้อม Header X-Token

คิวประมวลผลใช้ร่วมกับเว็บ Voice8 เวลารอขึ้นอยู่กับงานที่กำลังทำ ดูสถานะรวมได้ที่ หน้าหลัก

เมื่อเรียกไม่สำเร็จ

401

คีย์ไม่ถูกต้อง หมดอายุ หรือถูกเพิกถอน

403

คีย์ไม่มีสิทธิ์สำหรับคำขอนี้

409

Idempotency-Key เดิมใช้กับข้อมูลต่างจากคำขอแรก

422

ข้อมูลไม่ครบหรือไฟล์ไม่รองรับ ตรวจคำอธิบายข้อผิดพลาด

503

บริการยังไม่พร้อม ลองใหม่ภายหลังด้วย Idempotency-Key เดิม