ข้ามไปยังเนื้อหาหลัก
TransConvert

Audio Conversion API

Convert audio between any of 23 supported formats — MP3, WAV, OGG, AAC, FLAC, M4A, WMA, OPUS, AIFF, AMR, AU, CAF, AC3, DTS, GSM, IRCAM, MP2, TTA, VOC, W64, WV, SPX, and RM. Like video, this is an async, submit-then-poll endpoint rather than one blocking request — same ffmpeg engine behind TransConvert's website converter.

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

ส่งงาน

POST https://transconvert.com/api/v1/convert-async.php
Field Description
AuthorizationRequired. "Bearer tc_live_...".
categorySet to "audio".
targetRequired. Output format code: "MP3", "WAV", "OGG", "AAC", "FLAC", "M4A", "WMA", "OPUS", "AIFF", "AMR", "AU", "CAF", "AC3", "DTS", "GSM", "IRCAM", "MP2", "TTA", "VOC", "W64", "WV", "SPX", or "RM".
fileRequired. The audio file.
TransConvert
curl -X POST \
  https://transconvert.com/api/v1/convert-async.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=audio" \
  -F "target=MP3" \
  -F "file=@track.wav" \
  -o output.mp3

ตรวจสอบสถานะ

ตรวจสอบทุก ๆ 2-3 วินาทีด้วย job_id ที่ได้รับกลับมา "status" มีค่าใดค่าหนึ่งจาก queued, processing, completed หรือ failed

GET https://transconvert.com/api/v1/job-status.php?job_id=job_...
cURL
curl -H "Authorization: Bearer tc_live_your_key_here" \
  https://transconvert.com/api/v1/job-status.php?job_id=job_...

ดาวน์โหลดผลลัพธ์

เมื่อ status เป็น "completed" การตอบกลับจะมี download_url ซึ่งคือ URL ตรวจสอบสถานะเดิมที่เพิ่ม &download=1 ต่อท้าย การเรียกใช้ URL นี้จะสตรีมไฟล์ที่แปลงแล้วกลับมาโดยตรง ใช้ส่วนหัวเดียวกับเอนด์พอยต์อื่น ๆ ในหน้านี้ ผลลัพธ์จะถูกลบทันทีที่มีการดาวน์โหลด หรือถูกลบโดยอัตโนมัติหลังช่วงเวลาจัดเก็บสั้น ๆ หากไม่เคยถูกดาวน์โหลดเลย

scheduleผลลัพธ์ของงานจะถูกลบทันทีหลังดาวน์โหลด หรือถูกลบโดยอัตโนมัติหลังช่วงเวลาจัดเก็บสั้น ๆ หากไม่เคยถูกดาวน์โหลด — กรุณาดาวน์โหลดให้ทันเวลา

ข้อผิดพลาด

ทุกความล้มเหลวจะส่งกลับเป็นซองข้อผิดพลาด JSON ที่มี "code" ให้โค้ดของคุณใช้แยกกรณีได้ พร้อม "message" ที่มนุษย์อ่านเข้าใจ บางข้อผิดพลาดมีฟิลด์เพิ่มเติม (เช่น quota_exceeded จะมี "limit" และ "used")

Status & code When it happens
401 missing_keyไม่มีการส่งส่วนหัว Authorization มา
401 invalid_keyคีย์นี้ไม่มีอยู่จริง หรือถูกเพิกถอนแล้ว
403 account_suspendedบัญชีที่เป็นเจ้าของคีย์นี้ถูกระงับ
403 plan_requiredบัญชีนี้อยู่ในแพ็กเกจ Free — การใช้งาน API ต้องมี Basic, Lite, Pro หรือ Team
400 invalid_category"category" ไม่ใช่ "image" หรือ "document"
400 invalid_target"target" ไม่ใช่ฟอร์แมตผลลัพธ์ที่รองรับสำหรับหมวดหมู่นั้น
400 no_fileไม่มีการส่งไฟล์มา หรือการอัปโหลดล้มเหลว — ฟิลด์ต้องตั้งชื่อว่า "file"
413 file_too_largeไฟล์มีขนาดเกินขีดจำกัดการอัปโหลดสูงสุดของแพ็กเกจของคุณ
429 quota_exceededโควตานาทีการแปลงรายเดือนของแพ็กเกจถูกใช้จนหมดแล้ว จะรีเซ็ตเมื่อเริ่มเดือนปฏิทินถัดไป
429 concurrency_limitมีการแปลงไฟล์ทำงานพร้อมกันมากเกินไปสำหรับบัญชีนี้ (ใช้ร่วมกับเว็บไซต์) — รอให้งานหนึ่งเสร็จก่อนแล้วลองใหม่
404 job_not_foundไม่มีงานที่มี id นี้อยู่ในบัญชีนี้ (ข้อความเดียวกันนี้จะถูกส่งกลับสำหรับ job_id ของบัญชีอื่นด้วย — จะไม่มีการเปิดเผยว่ามีอยู่จริงหรือไม่)
410 result_goneงานเสร็จสิ้นแล้ว แต่ผลลัพธ์ถูกลบไปแล้ว (ผลลัพธ์จะถูกลบทันทีหลังดาวน์โหลด หรือโดยอัตโนมัติหลังช่วงเวลาจัดเก็บสั้น ๆ)
400/415/422/500/503 conversion_failedไฟล์นี้ไม่สามารถแปลงได้ — "message" อธิบายสาเหตุ รหัสสถานะจะต่างกันไปตามสาเหตุ: 400/415/422 หมายความว่าไฟล์หรือ target นี้จะไม่สำเร็จไม่ว่าจะลองกี่ครั้งก็ตาม; 500/503 หมายถึงปัญหาฝั่งเซิร์ฟเวอร์ และ 503 โดยเฉพาะคุ้มค่าที่จะลองใหม่อีกครั้งในเวลาสั้นๆ

Supported formats

MP3, WAV, OGG, AAC, FLAC, M4A, WMA, OPUS, AIFF, AMR, AU, CAF, AC3, DTS, GSM, IRCAM, MP2, TTA, VOC, W64, WV, SPX, RM

ที่เกี่ยวข้อง