Langkau ke kandungan utama
TransConvert

Video Conversion API

Convert video between MP4, MOV, AVI, MKV, and WEBM. Video encodes can take minutes, so this is an async, submit-then-poll endpoint rather than one blocking request — same ffmpeg engine behind TransConvert's website converter.

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

POST https://transconvert.com/api/v1/convert-async.php
Field Description
AuthorizationRequired. "Bearer tc_live_...".
categorySet to "video".
targetRequired. Output format code: "MP4", "MOV", "AVI", "MKV", or "WEBM".
fileRequired. The video file.
TransConvert
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" \
  -o output.mp4

Tinjau status

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

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.

Ralat

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).

Status & code When it happens
401 missing_keyTiada header Authorization dihantar.
401 invalid_keyKunci tersebut tidak wujud, atau telah dibatalkan.
403 account_suspendedAkaun yang memiliki kunci ini telah digantung.
403 plan_requiredAkaun berada pada pelan Percuma — akses API memerlukan Basic, Lite, Pro, atau Team.
400 invalid_category"category" bukan "image" atau "document".
400 invalid_target"target" bukan format output yang disokong untuk kategori tersebut.
400 no_fileTiada fail dihantar, atau muat naik gagal — medan itu mesti dinamakan "file".
413 file_too_largeFail melebihi saiz muat naik maksimum pelan anda.
429 quota_exceededPeruntukan minit penukaran bulanan pelan telah habis digunakan. Direset pada awal bulan kalendar berikutnya.
429 concurrency_limitTerlalu banyak penukaran sedang berjalan serentak untuk akaun ini (dikongsi dengan laman web) — tunggu sehingga salah satu selesai dan cuba lagi.
404 job_not_foundTiada tugas dengan id tersebut wujud untuk akaun ini (turut dikembalikan untuk job_id akaun lain — kewujudannya tidak pernah didedahkan).
410 result_goneTugas telah selesai, tetapi hasilnya telah pun dipadam (hasil dipadam sejurus selepas dimuat turun, atau secara automatik selepas tempoh penyimpanan yang singkat).
400/415/422/500/503 conversion_failedFail itu sendiri tidak dapat ditukar — "message" menerangkan sebabnya. Kod status berbeza mengikut sebab: 400/415/422 bermaksud fail atau target tidak akan berfungsi tidak kira berapa kali anda cuba semula; 500/503 bermaksud masalah di pihak pelayan, dan 503 khususnya berbaloi untuk dicuba semula dengan singkat.

Supported formats

MP4, MOV, AVI, MKV, WEBM

Berkaitan