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

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

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

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

İlgili