AiVideoEditor
Ücretsiz başlayın
Menü

İ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ü

  1. Dosya adı, bildirilen MIME ve bayt sayısıyla POST /api/v1/media/upload-intents uçlarını çağırın. Döndürülen assetId ve sessionId değerlerini ayrı kimlikler olarak saklayın.
  2. method alanını inceleyin. presigned_put için, dosyanın tamamını döndürülen başlıklarla uploadUrl adresine yükleyin. multipart_initiated için, partSizeBytes ile 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.
  3. sessionId ve multipart için her partNumber ve etag değerini içeren multipart.parts ile POST /api/v1/media/{assetId}/finalize uçlarında sonlandırın.
  4. Finalize edilen varlık kimliğini taslağın mediaIds alanı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.