All Products
Search

This Product

    Intelligent Media Services:AddEditingProjectMaterials

    Document Center

    Intelligent Media Services:AddEditingProjectMaterials

    Last Updated:Oct 12, 2026

    Menambahkan satu atau beberapa material ke proyek pengeditan.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ice:AddEditingProjectMaterials

    *Semua Sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ProjectId

    string

    Yes

    ID proyek pengeditan cloud.

    *****b2101cb318c*****
    MaterialMaps

    string

    Yes

    ID material. Pisahkan beberapa ID dengan koma (,). Maksimal 10 ID material didukung untuk setiap tipe. Nilai valid:

    • "video": video

    • "audio": audio

    • "image": gambar

    • "liveStream": aliran langsung

    • "editingProject": proyek pengeditan

    {"video":"*****2e057304fcd9b145c5cafc*****", "image":"****8021a8d493da643c8acd98*****,*****cb6307a4edea614d8b3f3c*****", "liveStream": "[{\"appName\":\"testrecord\",\"domainName\":\"test.alivecdn.com\",\"liveUrl\":\"rtmp://test.alivecdn.com/testrecord/teststream\",\"streamName\":\"teststream\"}]", "editingProject": "*****9b145c5cafc2e057304fcd*****"}

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Tanggapan.

    RequestId

    string

    ID permintaan.

    *****ACB-44F2-5F2D-88D7-1283E70*****
    ProjectId

    string

    ID proyek pengeditan cloud.

    *****67ae06542b9b93e0d1c387*****
    MediaInfos

    array<object>

    Kumpulan aset media yang memenuhi syarat.

    array<object>

    MediaId

    string

    ID aset media.

    *****5cb2e35433198daae94a72*****
    MediaBasicInfo

    object

    Informasi dasar aset media.

    MediaId

    string

    ID aset media.

    *****5cb2e35433198daae94a72*****
    InputURL

    string

    URL aset media yang akan didaftarkan di sistem terkait.

    http://bucket.oss-cn-shanghai.aliyuncs.com/file.mp4
    MediaType

    string

    Tipe media aset media.

    Video
    BusinessType

    string

    Tipe bisnis aset media.

    general
    Source

    string

    Sumber.

    oss
    Title

    string

    Judul.

    default_title_2020-12-23T03:32:59Z
    Description

    string

    Deskripsi.

    sample_description
    Category

    string

    Kategori.

    audio
    MediaTags

    string

    Tag.

    sample_tag
    CoverURL

    string

    URL gambar sampul.

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
    UserData

    string

    Data pengguna.

    userData
    Snapshots

    string

    Snapshot.

    null
    Status

    string

    Status aset media. Nilai valid:

    • Init: diinisialisasi

    • Preparing: sedang disiapkan

    • PrepareFail: persiapan gagal

    • Normal: Normal

    Normal
    TranscodeStatus

    string

    Status transkoding.

    Init
    CreateTime

    string

    Waktu saat aset media dibuat. Waktu ditampilkan dalam format ISO 8601 UTC (diakhiri dengan Z).

    2020-12-23T03:32:59Z
    ModifiedTime

    string

    Waktu saat aset media dimodifikasi. Waktu ditampilkan dalam format ISO 8601 UTC (diakhiri dengan Z).

    2020-12-23T03:32:59Z
    DeletedTime

    string

    Waktu saat aset media dihapus. Waktu ditampilkan dalam format ISO 8601 UTC (diakhiri dengan Z).

    2020-12-23T03:32:59Z
    SpriteImages

    string

    Gambar sprite.

    http://outin-example.oss-cn-shanghai.aliyuncs.com/test.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
    FileInfoList

    array<object>

    FileInfos.

    array<object>

    FileBasicInfo

    object

    Informasi dasar file, termasuk durasi dan ukuran.

    FileName

    string

    Nama file.

    example.mp4
    FileStatus

    string

    Status file. Nilai valid:

    • Uploading: sedang diunggah

    • Normal: Normal

    • UploadFail: pengunggahan gagal

    • Disable: dinonaktifkan

    • Deleted: dihapus

    Normal
    FileType

    string

    Tipe file.

    source_file
    FileSize

    string

    Ukuran file dalam byte.

    30611502
    FileUrl

    string

    URL OSS file.

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
    Region

    string

    Wilayah penyimpanan file.

    cn-shanghai
    FormatName

    string

    Format enkapsulasi.

    mov,mp4,m4a,3gp,3g2,mj2
    Duration

    string

    Durasi.

    216.206667
    Bitrate

    string

    Bitrate.

    1132.68
    Width

    string

    Lebar.

    960
    Height

    string

    Tinggi.

    540
    LiveMaterials

    array<object>

    Materi yang terkait dengan aliran langsung.

    object

    AppName

    string

    Nama aplikasi aliran langsung.

    testrecord
    StreamName

    string

    Nama aliran langsung.

    teststream
    DomainName

    string

    Nama domain aliran langsung.

    test.alivecdn.com
    LiveUrl

    string

    URL aliran langsung.

    rtmp://test.alivecdn.com/testrecord/teststream
    ProjectMaterials

    array

    Materi yang terkait dengan proyek pengeditan. Proyek pengeditan langsung dikaitkan dengan proyek pengeditan umum setelah aliran langsung berakhir.

    *****9b145c5cafc2e057304fcd*****

    string

    ID proyek pengeditan umum yang dikaitkan dengan proyek pengeditan langsung.

    *****c38767ae06542b9b93e0d1*****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "*****ACB-44F2-5F2D-88D7-1283E70*****",
  "ProjectId": "*****67ae06542b9b93e0d1c387*****",
  "MediaInfos": [
    {
      "MediaId": "*****5cb2e35433198daae94a72*****",
      "MediaBasicInfo": {
        "MediaId": "*****5cb2e35433198daae94a72*****",
        "InputURL": "http://bucket.oss-cn-shanghai.aliyuncs.com/file.mp4",
        "MediaType": "Video",
        "BusinessType": "general",
        "Source": "oss",
        "Title": "default_title_2020-12-23T03:32:59Z",
        "Description": "sample_description",
        "Category": "audio",
        "MediaTags": "sample_tag",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "UserData": "userData",
        "Snapshots": "null",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-23T03:32:59Z",
        "ModifiedTime": "2020-12-23T03:32:59Z",
        "DeletedTime": "2020-12-23T03:32:59Z",
        "SpriteImages": "http://outin-example.oss-cn-shanghai.aliyuncs.com/test.png?Expires=&OSSAccessKeyId=&Signature=&security-token="
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example.mp4",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "30611502",
            "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
            "Region": "cn-shanghai",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "216.206667",
            "Bitrate": "1132.68",
            "Width": "960",
            "Height": "540"
          }
        }
      ]
    }
  ],
  "LiveMaterials": [
    {
      "AppName": "testrecord",
      "StreamName": "teststream",
      "DomainName": "test.alivecdn.com",
      "LiveUrl": "rtmp://test.alivecdn.com/testrecord/teststream"
    }
  ],
  "ProjectMaterials": [
    "*****c38767ae06542b9b93e0d1*****"
  ]
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter The specified parameter \ is not valid.
    404 ProjectNotFound The specified project not found

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.