TransConvert API

จากศูนย์สู่ไฟล์ที่แปลงเสร็จแรกของคุณใน 3 ขั้นตอน

ทุกคำขอต้องใช้คีย์ API โดยส่งเป็น Bearer token ในส่วนหัว Authorization

ใช้งานได้กับแพ็กเกจ Basic, Lite, Pro และ Team สร้างคีย์จากบัญชีของคุณ →

ทดสอบคีย์ของคุณ

วิธีที่รวดเร็วในการยืนยันว่าคีย์ใช้งานได้ก่อนเริ่มเขียนโค้ดผสานระบบจริง — คำขอนี้เพียงอย่างเดียวจะไม่แปลงไฟล์ใดๆ (ไม่มีไฟล์แนบมา) แต่การได้รับ 400 no_file แทนที่จะเป็น 401 ยืนยันว่าคีย์นั้นใช้งานได้

เอนด์พอยต์เดียวรองรับการแปลงไฟล์ทุกรูปแบบ ส่งคำขอ POST แบบ multipart/form-data พร้อมไฟล์ของคุณและฟิลด์ด้านล่าง

พารามิเตอร์

การแปลงที่ใช้บ่อย

รายการอ้างอิงสำหรับคู่ฟอร์แมตยอดนิยม — เอนด์พอยต์เดียวกันรองรับทั้งหมด เพียงเปลี่ยนค่า category/target ให้ต่างกัน

การตอบกลับ

สำเร็จ (200): ไบต์ดิบของไฟล์ที่แปลงแล้ว พร้อมส่วนหัว Content-Type และ Content-Disposition ที่ตั้งค่าให้ ล้มเหลว: เนื้อหา JSON รูปแบบ {"error": {"code": "...", "message": "..."}} พร้อมรหัสสถานะ HTTP ที่ตรงกัน — ดู Errors ด้านล่าง

บีบอัดไฟล์โดยไม่เปลี่ยนฟอร์แมต — ฟอร์แมตเข้าและออกเหมือนกัน เป็นคู่ประเภทแยกต่างหากจากการแปลง ได้แก่ image-compress และ document-compress แต่ละแบบมีตัวเลือกของตัวเองด้านล่าง

image-compress

ฟอร์แมตเข้าและออกเหมือนกัน (JPG/PNG/WEBP/GIF) — target_percent คือขนาดผลลัพธ์เป้าหมายโดยประมาณเทียบกับต้นฉบับ ไม่ใช่ค่าคุณภาพตายตัว

curl -X POST \
  https://transconvert.com/api/v1/convert.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=image-compress" \
  -F "target_percent=50" \
  -F "file=@photo.jpg" \
  -o compressed.jpg

document-compress

PDF เข้าและ PDF ออก ผ่านการบีบอัดใหม่ของ Ghostscript เอง — จะไม่คืนไฟล์ที่ใหญ่กว่าไฟล์ที่อัปโหลด (หากบีบอัดแล้วไม่ได้ผลดีขึ้น จะคืนไฟล์ต้นฉบับแทน)

curl -X POST \
  https://transconvert.com/api/v1/convert.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=document-compress" \
  -F "level=high" \
  -F "file=@report.pdf" \
  -o compressed.pdf

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

ส่งงาน

รูปแบบ multipart POST เดียวกับเอนด์พอยต์หลัก แต่คนละ URL

curl -X POST \
  https://transconvert.com/api/v1/convert-async.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=video" \
  -F "target=MP4" \
  -F "file=@clip.mov"

การตอบกลับ (202 Accepted)

{ "job_id": "job_242e1555d78d166807aa56502f15d118", "status": "queued" }

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

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

{
  "job_id": "job_242e1555d78d166807aa56502f15d118",
  "status": "completed",
  "category": "video",
  "target_format": "MP4",
  "created_at": "2026-08-26 19:17:47",
  "download_url": "/api/v1/job-status.php?job_id=job_...&download=1",
  "filename": "clip.mp4"
}

เว็บฮุก (ไม่บังคับ)

หากคุณระบุ webhook_url ไว้ตอนส่งคำขอ เมื่องานเสร็จสิ้น (สำเร็จหรือล้มเหลว) เราจะส่ง JSON เนื้อหาเดียวกันไปที่นั่นหนึ่งครั้ง และจะลองใหม่อีกสองสามครั้งหากปลายทางของคุณไม่ตอบสนอง ไม่ว่าจะอย่างไร job-status.php ก็ยังใช้งานได้เป็นทางเลือกสำรอง

POST your webhook_url
{
  "job_id": "job_242e1555d78d166807aa56502f15d118",
  "status": "completed",
  "category": "video",
  "target_format": "MP4",
  "created_at": "2026-08-26 19:17:47",
  "download_url": "https://transconvert.com/api/v1/job-status.php?job_id=job_...&download=1",
  "filename": "clip.mp4"
}

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

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

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

คำขอเดียวกันในสี่ภาษาโปรแกรม — เลือกภาษาที่ตรงกับสแต็กของคุณ แต่ละตัวอย่างแปลงไฟล์ photo.jpg ในเครื่องเป็น PNG แล้วบันทึกผลลัพธ์

curl -X POST \
  https://transconvert.com/api/v1/convert.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=image" \
  -F "target=PNG" \
  -F "file=@photo.jpg" \
  -o converted.png

<?php
$ch = curl_init('https://transconvert.com/api/v1/convert.php');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer tc_live_your_key_here'],
    CURLOPT_POSTFIELDS => [
        'category' => 'image',
        'target' => 'PNG',
        'file' => new CURLFile('photo.jpg'),
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status === 200) {
    file_put_contents('converted.png', $response);
} else {
    $error = json_decode($response, true);
    echo $error['error']['message'];
}

const form = new FormData();
form.append('category', 'image');
form.append('target', 'PNG');
form.append('file', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');

const res = await fetch('https://transconvert.com/api/v1/convert.php', {
  method: 'POST',
  headers: { Authorization: 'Bearer tc_live_your_key_here' },
  body: form,
});

if (res.ok) {
  fs.writeFileSync('converted.png', Buffer.from(await res.arrayBuffer()));
} else {
  const { error } = await res.json();
  console.error(error.message);
}

import requests

with open('photo.jpg', 'rb') as f:
    response = requests.post(
        'https://transconvert.com/api/v1/convert.php',
        headers={'Authorization': 'Bearer tc_live_your_key_here'},
        data={'category': 'image', 'target': 'PNG'},
        files={'file': f},
    )

if response.status_code == 200:
    with open('converted.png', 'wb') as out:
        out.write(response.content)
else:
    print(response.json()['error']['message'])

# gem install multipart-post
require 'net/http'
require 'net/http/post/multipart'

url = URI('https://transconvert.com/api/v1/convert.php')

File.open('photo.jpg') do |file|
  req = Net::HTTP::Post::Multipart.new url,
    'category' => 'image',
    'target' => 'PNG',
    'file' => UploadIO.new(file, 'image/jpeg', 'photo.jpg')
  req['Authorization'] = 'Bearer tc_live_your_key_here'

  res = Net::HTTP.start(url.host, url.port, use_ssl: true) do |http|
    http.request(req)
  end

  if res.code == '200'
    File.write('converted.png', res.body)
  else
    puts JSON.parse(res.body)['error']['message']
  end
end

// Gradle: implementation("com.squareup.okhttp3:okhttp:4.+")
OkHttpClient client = new OkHttpClient();

RequestBody body = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("category", "image")
    .addFormDataPart("target", "PNG")
    .addFormDataPart("file", "photo.jpg",
        RequestBody.create(new File("photo.jpg"), MediaType.parse("image/jpeg")))
    .build();

Request request = new Request.Builder()
    .url("https://transconvert.com/api/v1/convert.php")
    .header("Authorization", "Bearer tc_live_your_key_here")
    .post(body)
    .build();

try (Response response = client.newCall(request).execute()) {
    if (response.isSuccessful()) {
        Files.write(Paths.get("converted.png"), response.body().bytes());
    } else {
        System.err.println(response.body().string());
    }
}

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

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly API allowance of 5000 conversion-minutes reached.",
    "limit": 5000,
    "used": 5000
  }
}

การจัดการข้อผิดพลาดและการลองใหม่

ให้แยกกรณีด้วยฟิลด์ "code" ใน JSON ไม่ใช่ข้อความ "message" — ถ้อยคำอาจเปลี่ยนแปลงได้ในอนาคต แต่ code จะไม่เปลี่ยน concurrency_limit คุ้มค่าที่จะลองใหม่อีกครั้งสั้นๆ หลังจากผ่านไปสองสามวินาที (จะหายไปทันทีที่การแปลงที่กำลังทำงานอยู่ของคุณตัวใดตัวหนึ่งเสร็จสิ้น) ส่วน quota_exceeded จะไม่คลี่คลายเองจนกว่าจะถึงเดือนถัดไป จึงไม่ควรลองใหม่ซ้ำๆ ในลูป conversion_failed เป็น code เดียวที่รหัสสถานะ HTTP ยังมีความหมาย: 503 คือปัญหาชั่วคราวฝั่งเซิร์ฟเวอร์ที่คุ้มค่าให้ลองใหม่สั้นๆ หนึ่งครั้ง ส่วน 400/415/422/500 หมายความว่าไฟล์/target ชุดนั้นจะไม่สำเร็จไม่ว่าจะส่งซ้ำกี่ครั้งก็ตาม การตรวจสอบขนาดไฟล์ฝั่งไคลเอนต์ก่อนอัปโหลดจะช่วยไม่ให้เสียคำขอไปกับ file_too_large ที่รู้ผลอยู่แล้ว

API ใช้ขีดจำกัดร่วมกับแพ็กเกจเดียวกับที่คุณใช้บนเว็บไซต์อยู่แล้ว — ไม่ต้องตั้งค่าแยกต่างหาก

เมื่อมีการใช้ขีดจำกัดต่อนาที ทุกการตอบกลับจะมีส่วนหัว X-RateLimit-Limit และ X-RateLimit-Remaining และการตอบกลับแบบ 429 จะมี Retry-After (หน่วยเป็นวินาที) ด้วย — ใช้ค่าเหล่านี้เพื่อชะลอคำขอก่อนจะถึงขีดจำกัด แทนที่จะตอบสนองหลังจากได้รับ 429 เท่านั้น

เครื่องมือแปลงไฟล์ตัวเดียวกันทุกประการกับที่เว็บไซต์ใช้ — ไม่มีฟอร์แมตใดเฉพาะ API หรือเฉพาะเว็บไซต์

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