Ana içeriğe geç
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.

Video ve ses dönüştürmeleri dakikalarca sürebilir — tek bir senkron isteği bu kadar uzun süre açık tutmak pratik değildir, bu yüzden yukarıdaki uç nokta yerine gönder-sonra-sorgula akışı kullanılır. Bir dosya gönderin, hemen bir job_id alın, ardından işiniz tamamlanana kadar durumunu sorgulayın.

Bir iş gönderin

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

Durumu sorgulayın

Aldığınız job_id ile bunu birkaç saniyede bir sorgulayın. "status" alanı queued, processing, completed veya failed değerlerinden biridir.

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

Sonucu indirin

"status" "completed" olduğunda yanıt bir download_url içerir — aynı durum URL'sine &download=1 eklenmiş hali. Bu URL'e istek atmak, sayfadaki diğer tüm uç noktalarla aynı başlıklarla dönüştürülmüş dosyanın ham baytlarını akıtır. Sonuç, indirildiği anda silinir; hiç indirilmezse kısa bir saklama süresinin ardından otomatik olarak silinir.

scheduleİş sonuçları indirildikten hemen sonra silinir; hiç indirilmezse kısa bir saklama süresinin ardından otomatik olarak silinir — dosyanızı zamanında indirin.

Hatalar

Her başarısızlık, kodunuzun dallanabileceği bir "code" ile birlikte insan tarafından okunabilir bir "message" içeren bir JSON hata zarfı döndürür. Bazı hatalar ek alanlar içerir (örneğin quota_exceeded, "limit" ve "used" içerir).

Status & code When it happens
401 missing_keyAuthorization başlığı gönderilmedi.
401 invalid_keyAnahtar mevcut değil veya iptal edilmiş.
403 account_suspendedBu anahtara sahip hesap askıya alınmış.
403 plan_requiredHesap Free planında — API erişimi Basic, Lite, Pro veya Team gerektirir.
400 invalid_category"category", "image" veya "document" değildi.
400 invalid_target"target", bu kategori için desteklenen bir çıktı formatı değil.
400 no_fileDosya gönderilmedi veya yükleme başarısız oldu — alanın adı "file" olmalı.
413 file_too_largeDosya, planınızın izin verdiği en büyük yükleme boyutunu aşıyor.
429 quota_exceededPlanın aylık dönüştürme dakikası kotası tükendi. Bir sonraki takvim ayının başında sıfırlanır.
429 concurrency_limitBu hesap için aynı anda çalışan çok fazla dönüştürme var (web sitesiyle paylaşılır) — birinin bitmesini bekleyip tekrar deneyin.
404 job_not_foundBu hesap için bu kimlikte bir iş yok (başka bir hesabın job_id'si için de aynı yanıt döner — bir işin var olup olmadığı asla ifşa edilmez).
410 result_goneİş tamamlandı, ancak sonucu o zamandan beri silindi (sonuçlar indirildikten hemen sonra veya hiç indirilmezse kısa bir saklama süresinin ardından otomatik olarak silinir).
400/415/422/500/503 conversion_failedDosyanın kendisi dönüştürülemedi — "message" nedenini açıklar. Durum kodu nedene göre değişir: 400/415/422, dosyanın veya hedefin kaç kez denerseniz deneyin çalışmayacağı anlamına gelir; 500/503 sunucu tarafında bir sorun olduğunu gösterir, özellikle 503 için kısa bir yeniden deneme mantıklıdır.

Supported formats

MP4, MOV, AVI, MKV, WEBM

İlgili