Tüm Ürünler
Search

Bu Ürün

    :CreateUploadVideo

    Belge Merkezi

    :CreateUploadVideo

    Son Güncelleme:Oct 12, 2026

    Bir ses veya video dosyası için yükleme URL'sini ve kimlik bilgilerini alır ve medya bilgilerini oluşturur. ApsaraVideo VOD; yetkilendirmeyi ve güvenliği sağlamak, kötü amaçlı yüklemeleri önlemek ve yönetim için video kimliği (VideoId) olarak da bilinen bir medya kimliğini (MediaId) otomatik olarak oluşturmak amacıyla yükleme URL'sini ve kimlik bilgilerini sağlar. Gerekli yükleme URL'sini ve kimlik bilgilerini almak ve ses ile video bilgilerini oluşturmak için bu işlemi çağırabilirsiniz.

    Operation description

    • Bu işlemi çağırmadan önce, ApsaraVideo VOD'un faturalandırma yöntemlerini ve fiyatlandırmasını tam olarak anladığınızdan emin olun. Medya varlıklarını ApsaraVideo VOD'a yüklemek depolama ücretlerine tabidir. Faturalandırma hakkında daha fazla bilgi için Medya varlığı depolama faturalandırması konusuna bakın. Depolama ve aktarım hızlandırmayı etkinleştirdiyseniz, medya varlıklarını ApsaraVideo VOD'a yüklemek aynı zamanda yükleme hızlandırma ücretlerine de tabidir. Faturalandırma hakkında daha fazla bilgi için Depolama ve aktarım hızlandırma faturalandırması konusuna bakın. Depolama ücretleri, dosyanın yüklendiği andan itibaren hesaplanır. Hızlandırma ücretleri, özelliği etkinleştirdikten sonra dosya yüklediğinizde hesaplanır. Yalnızca bu işlemi çağırmak herhangi bir ücrete tabi değildir.

    • Yükleme URL'sini ve kimlik bilgilerini almak, ApsaraVideo VOD'un temelini oluşturur ve her yükleme işlemi için gerekli bir adımdır. ApsaraVideo VOD, her birinin yükleme URL'si ve kimlik bilgilerini alma gereksinimleri farklı olan çeşitli yükleme yöntemleri sunar. Daha fazla bilgi için Yükleme URL'leri ve kimlik bilgileri konusuna bakın.

    • Bu işlem yalnızca yükleme URL'sini ve kimlik bilgilerini almak ve temel medya varlığı bilgilerini oluşturmak için kullanılır. Dosya yüklemez. API işlemlerini çağırarak dosya yüklemeyle ilgili eksiksiz bir örnek için ApsaraVideo VOD API'sini kullanarak medya varlığı dosyaları yükleme konusuna bakın.

    • Bu işlem, hem video hem de ses dosyaları için yükleme URL'si ve kimlik bilgilerinin alınmasını destekler. Daha fazla bilgi için Yükleme URL'leri ve kimlik bilgileri konusuna bakın.

    • Video yükleme kimlik bilgisinin süresi dolarsa (varsayılan geçerlilik süresi 3.000 saniyedir), yeni bir yükleme kimlik bilgisi almak için RefreshUploadVideo işlemini çağırın.

    • Yükleme işleminden sonra, yükleme olayı bildirimlerini almak üzere bir geri arama yapılandırabilir veya yüklemenin başarılı olup olmadığını belirlemek için yanıtta dosya durumunu kontrol etmek üzere GetMezzanineInfo işlemini çağırabilirsiniz.

    • Bu işlem tarafından döndürülen VideoId parametresi, medya varlığı yaşam döngüsü yönetimi veya medya işleme için kullanılabilir.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    vod:CreateUploadVideo

    create

    *Tüm kaynaklar.

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    CoverURL

    string

    No

    Özel video küçük resminin URL'si.

    https://example.aliyundoc.com/image/D22F553TEST****.jpeg
    Description

    string

    No

    Yükleme tamamlandıktan sonra ApsaraVideo VOD'da görüntülenen ses veya video dosyasının açıklaması.

    • Açıklama en fazla 1.024 karakter uzunluğunda olabilir.

    • Açıklama UTF-8 ile kodlanmalıdır.

    UploadTest
    FileName

    string

    Yes

    Yüklenecek ses veya video kaynak dosyasının adı.

    • Dosya adı bir uzantı içermelidir. Uzantı büyük/küçük harfe duyarlı değildir.

    • Desteklenen uzantılar için Yükleme genel bakışı konusuna bakın.

    D:\video_01.mp4
    FileSize

    integer

    No

    Yüklenecek ses veya video kaynak dosyasının boyutu. Birim: bayt.

    123
    Title

    string

    Yes

    Yükleme tamamlandıktan sonra ApsaraVideo VOD'da görüntülenen ses veya video dosyasının başlığı.

    • Başlık en fazla 128 karakter uzunluğunda olabilir.

    • Başlık UTF-8 ile kodlanmalıdır.

    UploadTest
    CateId

    integer

    No

    Kategori kimliği. Kategori kimliğini aşağıdaki yöntemlerden birini kullanarak alabilirsiniz:

    • ApsaraVideo VOD konsolunda oturum açın. Sol gezinme bölmesinde Yapılandırma Yönetimi > Medya Varlığı Yönetimi Yapılandırması > Kategori Yönetimi yolunu izleyerek kategori kimliğini görüntüleyin.

    • AddCategory işlemini çağırarak bir kategori oluşturduğunuzda, kategori kimliği yanıtta CateId parametresinin değeridir.

    • GetCategories işlemini çağırarak kategorileri sorguladığınızda, kategori kimliği yanıtta CateId parametresinin değeridir.

    100036****
    Tags

    string

    No

    Ses veya video dosyasının etiketleri.

    • En fazla 16 etiket belirtebilirsiniz.

    • Birden fazla etiketi virgülle (,) ayırın.

    • Her etiket en fazla 32 karakter uzunluğunda olabilir.

    • Etiketler UTF-8 ile kodlanmalıdır.

    tag1,tag2
    UserData

    string

    No

    Özel ayarlar. Değer; mesaj geri araması ve yükleme hızlandırma gibi ayarları destekleyen bir JSON dizesidir. Daha fazla bilgi için UserData konusuna bakın.

    Not

    • Mesaj geri arama özelliğini kullanmak için bir HTTP geri arama URL'si yapılandırmalı ve konsolda ilgili geri arama olay türlerini seçmelisiniz. Aksi takdirde, geri arama ayarları etkili olmaz. Sonraki görevler için bir geri arama URL'si belirtilmezse, bildirimler varsayılan olarak bu URL'ye gönderilir. Konsolda HTTP geri aramalarını yapılandırma hakkında daha fazla bilgi için Geri arama ayarları konusuna bakın.

    • Yükleme hızlandırma özelliğini kullanmak için, özelliği etkinleştirmek üzere bir başvuru göndermeniz gerekir. Daha fazla bilgi için Yükleme talimatları konusuna bakın.

    {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
    TemplateGroupId

    string

    No

    Kod dönüştürme şablonu grubunun kimliği. Kimliği aşağıdaki yöntemlerden birini kullanarak alabilirsiniz:

    • ApsaraVideo VOD konsolunda oturum açın. Sol gezinme bölmesinde Yapılandırma Yönetimi > Medya İşleme Yapılandırması > Kod Dönüştürme Şablonu Grupları yolunu izleyerek kod dönüştürme şablonu grubunun kimliğini görüntüleyin.

    • Kod dönüştürme şablonu grubu oluşturma işlemini çağırarak bir kod dönüştürme şablonu grubu oluşturduğunuzda, kimlik yanıtta TranscodeTemplateGroupId parametresinin değeridir.

    • Kod dönüştürme yapılandırma listesini sorgulama işlemini çağırarak kod dönüştürme şablonu gruplarını sorguladığınızda, kimlik yanıtta TranscodeTemplateGroupId parametresinin değeridir.

    Not

    • Hem WorkflowId hem de TemplateGroupId belirtilmişse, WorkflowId önceliklidir.

    • Bu parametreyi belirtmezseniz, varsayılan kod dönüştürme şablonu grubu kullanılır. Bu parametreyi belirtirseniz, belirtilen kod dönüştürme şablonu grubu kullanılır.

    • Bu parametreyi yerleşik Kod Dönüştürme Yok şablonu grubuna ayarlarsanız, ses veya video dosyası yüklendikten sonra yalnızca video yükleme tamamlanma olay bildirimi oluşturulur. Tek çözünürlük kod dönüştürme tamamlanma olay bildirimi oluşturulmaz.

    • Bu parametre tarafından tetiklenen görev eşzamansız bir görevdir. Görev gönderildikten sonra kuyruğa alınır ve arka planda eşzamansız olarak yürütülür.

    • Normal oynatmayı sağlamak için bu parametreyi yerleşik Kod Dönüştürme Yok şablonu grubuna ayarlarsanız, ses veya video dosyası yüklendikten sonra kod dönüştürme olmadan doğrudan oynatmayı yalnızca şu biçimler destekler: MP4, FLV, MP3, M3U8 ve WEBM. Diğer biçimler yalnızca depolama için desteklenir (FileName uzantısına dikkat edin). Oynatma için ApsaraVideo Player kullanıyorsanız, sürüm 3.1.0 veya sonraki bir sürüm olmalıdır.

    405477f9e214d19ea2c7c854****
    WorkflowId

    string

    No

    İş akışı kimliği. İş akışı kimliğini görüntülemek için ApsaraVideo VOD konsolunda oturum açabilir ve Yapılandırma Yönetimi > Medya İşleme Yapılandırması > İş Akışları yolunu izleyebilirsiniz.

    Not

    • Hem WorkflowId hem de TemplateGroupId belirtilmişse, WorkflowId önceliklidir. Daha fazla bilgi için İş akışları konusuna bakın.

    • Bu parametre tarafından tetiklenen görev eşzamansız bir görevdir. Görev gönderildikten sonra kuyruğa alınır ve arka planda eşzamansız olarak yürütülür.

    613efff3887ec34af685714cc461****
    StorageLocation

    string

    No

    Depolama adresi. Depolama adresini aşağıdaki yöntemi kullanarak alabilirsiniz: ApsaraVideo VOD konsolunda oturum açın ve depolama adresini görüntülemek için Yapılandırma Yönetimi > Medya Varlığı Yönetimi Yapılandırması > Depolama Yönetimi yolunu izleyin.

    Not

    Bu parametreyi belirtmezseniz, ses veya video dosyası varsayılan depolama adresine yüklenir. Varsayılan depolama adresi yapılandırılmamışsa, dosya depolama listesindeki ilk depolama adresine yüklenir. Bu parametreyi belirtirseniz, ses veya video dosyası belirtilen depolama adresine yüklenir.

    out-****.oss-cn-shanghai.aliyuncs.com
    AppId

    string

    No

    Uygulama kimliği. Varsayılan değer: app-1000000. Daha fazla bilgi için Çoklu uygulama konusuna bakın.

    app-1000000
    ReferenceId

    string

    No

    Özel kimlik. Kimlik 6 ila 64 karakter uzunluğunda olabilir ve yalnızca küçük harfler, büyük harfler, rakamlar, tire (-) ve alt çizgi (_) içerebilir. Kimlik, kullanıcı boyutunda benzersiz olmalıdır.

    123-123
    EnableFirstFrameCover

    boolean

    No

    Videonun ilk karesinin küçük resim olarak kullanılıp kullanılmayacağını belirtir.

    GenerateThumbnail

    boolean

    No

    Video için bir küçük resim oluşturulup oluşturulmayacağını belirtir.

    Response elements

    Element

    Type

    Description

    Example

    object

    Yanıt.

    RequestId

    string

    İstek kimliği.

    25818875-5F78-4AF6-04D5-D7393642****
    UploadAddress

    string

    Yükleme URL'si.

    Not

    İşlem tarafından döndürülen yükleme URL'si Base64 ile kodlanmıştır. Medya varlığını yüklemek için bir SDK veya API işlemi çağırdığınızda, kullanmadan önce URL'nin kodunu çözmeniz gerekir. Yükleme için yerel OSS SDK'sını veya OSS API'sini kullandığınızda yalnızca UploadAddress değerini ayrıştırmanız gerekir.

    eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
    VideoId

    string

    Ses veya video kimliği. Bu kimliği medya varlığı yönetimi, medya işleme ve medya inceleme işlemleri için bir istek parametresi olarak kullanabilirsiniz.

    93ab850b4f6f54b6e91d24d81d44****
    UploadAuth

    string

    Yükleme kimlik bilgisi.

    Not

    İşlem tarafından döndürülen yükleme kimlik bilgisi Base64 ile kodlanmıştır. Medya varlığını yüklemek için bir SDK veya API işlemi çağırdığınızda, kullanmadan önce kimlik bilgisinin kodunu çözmeniz gerekir. Yükleme için yerel OSS SDK'sını veya OSS API'sini kullandığınızda yalnızca UploadAuth değerini ayrıştırmanız gerekir.

    eyJFbmRwb2ludCI6Imm****

    Examples

    Success response

    JSON format

    {
  "RequestId": "25818875-5F78-4AF6-04D5-D7393642****",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "VideoId": "93ab850b4f6f54b6e91d24d81d44****",
  "UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.