İnceleme 2026-11-10 · API sürümü 2026-11-09 · Markdown oku
Medya yükleme ve saklama
Medya baytları geçici özel nesne depolamasına doğrudan gider. REST ve MCP yükleme
talimatları döndürür; araç JSON'unda ikili dosya içeriği kabul etmezler.
Dağıtımda depolama yapılandırılmış olmalıdır; aksi hâlde yükleme oluşturma
provider_unavailable döndürür.
Yükleme yaşam döngüsü
- Dosya adı, bildirilen MIME ve bayt sayısıyla
POST /api/v1/media/upload-intentsuçlarını çağırın. DöndürülenassetIdvesessionIddeğerlerini ayrı kimlikler olarak saklayın. methodalanını inceleyin.presigned_putiçin, dosyanın tamamını döndürülen başlıklarlauploadUrladresine yükleyin.multipart_initiatediçin,partSizeBytesile bölün, her numaralı parçayı kendi döndürülen URL'sine yükleyin ve ETag makbuzunu saklayın. Depolama isteklerine asla AiVideoEditor bearer anahtarını eklemeyin.sessionIdve multipart için herpartNumberveetagdeğerini içerenmultipart.partsilePOST /api/v1/media/{assetId}/finalizeuçlarında sonlandırın.- Finalize edilen varlık kimliğini taslağın
mediaIdsalanında kullanın. Tek başına bir yükleme niyeti varlığı yayınlanabilir yapmaz.
Sunucu, değiştirilemez son kopyada gerçek baytları ve biçimi gözlemler. Bildirilen boyut/MIME, rezervasyon girişleridir; dosya geçerliliğinin kanıtı değildir. Desteklenen temel aileler JPEG, PNG ve MP4'tür; ayrı hedefler daha katı sınırlar uygulayabilir. Geçerli maksimum dosya boyutu 500 MiB'dir (524.288.000 bayt). 50 MiB veya üzerindeki dosyalar multipart kullanır, normalde 16 MiB parçalarla. Bu varsayılanlardan türetmek yerine her zaman döndürülen boyutlara, URL'lere ve son kullanma süresine uyun.
{
"sessionId": "<session UUID from upload-intents>",
"multipart": {
"parts": [
{ "partNumber": 1, "etag": "<ETag returned by storage>" }
]
}
}
Bu bir multipart biçimi çizimidir; her gerçek parçayı ekleyin. Single-PUT
sonlandırması yalnızca sessionId gönderir. Her yeni API mutasyonuna kendi
Idempotency-Key değerini verin; güvenli özdeş yeniden denemeler için saklayın.
Sürdürme veya bırakma
Süresi dolmuş imzalı URL'ler kalıcı medya adresleri değildir. fromPart ve toPart
(en fazla 64 parçalık kapsayıcı bir aralık) ile POST /media/{id}/upload-parts uçlarından
taze multipart parça URL'leri isteyin. Sınırlı istek biçimi için API başvurusuna bakın. Tamamlanmış parçaları gereksiz yere yeniden yüklemeyin ve
multipart birleştirmeyi doğrudan depolama üzerinden tamamlamayın: sonlandırma sunucu
tarafından denetlenir.
Eksik bir yüklemeyi iptal ederken POST /media/{id}/abandon uçlarını kullanın. Bu,
rezervasyonunu paylaşılan temizlik iş akışı üzerinden serbest bırakır. Oturum süresi
dolması veya tüketilmiş multipart durumu yeni bir niyet gerektirebilir; depolama nesne
anahtarlarını tahmin etmeyin.
Geçici saklama
GET /media/{id}; durum ve dinamik deleteAfter bilgisi döndürür, kalıcı bir genel
URL değil. Zamanlanmış ve yürütülmekte olan kullanımlar, iş boyunca medyayı korur.
Varsayılan ilke; kullanılmayan taslak medyasını 14 gün, sonuçlanmış medyayı 72 saat
ve başarısız veya belirsiz işi ilgili denemeden sonra 7 gün saklar. Gerçek saklama,
kalan tüm referanslara bağlıdır; deleteAfter null olabilir. Orijinallerinizi saklayın.
Medyanın süresi dolmuşsa veya siliniyorsa, yayınlamadan önce yeniden yükleyin.