API TransConvert

Daripada sifar kepada fail pertama yang ditukar dalam tiga langkah.

Setiap permintaan memerlukan kunci API, dihantar sebagai token Bearer dalam header Authorization.

Tersedia pada pelan Basic, Lite, Pro, dan Team. Jana kunci daripada akaun anda →

Uji kunci anda

Cara pantas untuk mengesahkan kunci berfungsi sebelum menulis sebarang kod integrasi sebenar — ini sahaja tidak akan menukar apa-apa (tiada fail dilampirkan), tetapi 400 no_file dan bukannya 401 mengesahkan kunci itu sendiri sah.

Satu titik akhir mengendalikan setiap penukaran. Hantar permintaan POST multipart/form-data dengan fail anda dan medan-medan di bawah.

Parameter

Penukaran biasa

Rujukan pantas untuk pasangan popular — titik akhir yang sama mengendalikan kesemuanya, hanya dengan kombinasi category/target yang berbeza.

Respons

Jika berjaya (200): bait mentah fail yang telah ditukar, dengan header Content-Type dan Content-Disposition ditetapkan untuknya. Jika gagal: badan JSON berbentuk {"error": {"code": "...", "message": "..."}} dengan kod status HTTP yang sepadan — lihat Ralat di bawah.

Kecilkan saiz fail tanpa menukar formatnya — format masuk sama dengan format keluar. Sepasang kategori berasingan daripada penukaran, iaitu image-compress dan document-compress, masing-masing dengan pilihannya sendiri di bawah.

image-compress

Format masuk sama dengan format keluar (JPG/PNG/WEBP/GIF) — target_percent ialah sasaran saiz hasil berbanding dengan asal secara kasar, bukan tetapan kualiti yang tetap.

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 masuk, PDF keluar, melalui pemampatan semula Ghostscript sendiri — tidak akan sekali-kali memulangkan fail yang lebih besar daripada yang dimuat naik (kembali kepada fail asal jika pemampatan semula tidak membantu).

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

Penukaran video dan audio boleh mengambil masa beberapa minit — terlalu lama untuk mengekalkan satu permintaan segerak terbuka — jadi ia menggunakan aliran hantar-kemudian-tinjau, bukan titik akhir di atas. Hantar fail, dapatkan job_id serta-merta, kemudian tinjau statusnya sehingga selesai.

Hantar tugas

Bentuk POST multipart yang sama seperti titik akhir utama, pada URL yang berbeza.

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"

Respons (202 Accepted)

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

Tinjau status

Tinjau ini setiap beberapa saat menggunakan job_id yang diterima. "status" ialah salah satu daripada queued, processing, completed, atau 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 (pilihan)

Jika anda memberikan webhook_url semasa penghantaran, kami akan POST kandungan JSON yang sama ke situ sekali apabila kerja selesai — berjaya atau gagal — dan cuba semula beberapa kali jika titik akhir anda tidak bertindak balas. job-status.php tetap berfungsi sebagai alternatif.

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"
}

Muat turun hasil

Apabila status ialah "completed", respons menyertakan download_url — URL status yang sama dengan &download=1 ditambah di hujungnya. Memintanya kemudian menstrim bait mentah fail yang telah ditukar, dengan header yang sama seperti setiap titik akhir lain pada halaman ini. Hasil akan dipadam sebaik sahaja dimuat turun, atau dipadam secara automatik selepas tempoh penyimpanan yang singkat jika tidak pernah dimuat turun.

scheduleHasil tugas dipadam sejurus selepas dimuat turun, atau dipadam secara automatik selepas tempoh penyimpanan yang singkat jika tidak pernah dimuat turun — muat turun dengan segera.

Permintaan yang sama dalam empat bahasa — pilih mana-mana yang sepadan dengan tindanan anda. Setiap satu menukar photo.jpg tempatan kepada PNG dan menyimpan hasilnya.

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());
    }
}

Setiap kegagalan memulangkan sampul ralat JSON dengan "code" yang boleh digunakan kod anda untuk bercabang, ditambah "message" yang boleh dibaca manusia. Sesetengah ralat menyertakan medan tambahan (quota_exceeded menyertakan "limit" dan "used", sebagai contoh).

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

Mengendalikan ralat & cuba semula

Bercabang berdasarkan medan JSON "code", bukan teks "message" — kata-kata mungkin berubah dari semasa ke semasa, kod tidak. concurrency_limit berbaloi untuk dicuba semula dengan singkat selepas beberapa saat (ia hilang sebaik sahaja salah satu penukaran anda yang sedang berjalan selesai); quota_exceeded tidak akan selesai dengan sendirinya sehingga bulan depan, jadi jangan cuba semula dalam gelung. conversion_failed ialah satu-satunya kod di mana status HTTP masih penting: 503 ialah isu sementara di pihak pelayan yang berbaloi untuk satu percubaan semula yang singkat, manakala 400/415/422/500 bermaksud kombinasi fail/sasaran itu tepat tidak akan berjaya tidak kira berapa kali anda hantar semula. Menyemak saiz fail di pihak klien sebelum memuat naik mengelakkan pembaziran permintaan atas file_too_large yang sudah pasti berlaku.

API berkongsi hadnya dengan pelan yang sama yang anda sudah gunakan di laman web — tiada apa-apa berasingan untuk dikonfigurasikan.

Sebaik sahaja had seminit dikenakan, setiap respons menyertakan pengepala X-RateLimit-Limit dan X-RateLimit-Remaining; respons 429 turut menyertakan Retry-After (dalam saat) — gunakannya untuk memperlahankan sebelum mencapai had, bukan hanya bertindak balas selepas 429.

Enjin penukaran yang sama persis dengan yang digunakan laman web — tiada apa yang eksklusif untuk API atau eksklusif untuk laman web.

infoVideo dan audio — baik penukaran mahupun pemampatan — buat masa ini hanya tersedia di laman web: panggilan HTTP segerak kurang sesuai untuk tugas yang boleh mengambil masa beberapa minit.