All Products
Search

This Product

    Intelligent Media Services:CreateEditingProject

    Document Center

    Intelligent Media Services:CreateEditingProject

    Last Updated:Jun 11, 2026

    Membuat proyek pengeditan cloud. Anda dapat mengatur judul, deskripsi, timeline, dan gambar sampul.

    Deskripsi operasi

    • Anda akan dikenakan biaya berdasarkan durasi video yang dihasilkan. Untuk detail penagihan, lihat Video clip. Tidak ada biaya yang dikenakan untuk node yang gagal.

    • Setelah Anda membuat proyek pengeditan, Anda dapat memanggil SubmitMediaProducingJob untuk mengirimkan node pengeditan dan komposisi media, atau memanggil SubmitLiveEditingJob untuk mengirimkan node pengeditan langsung.

    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:CreateEditingProject

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Title

    string

    Yes

    Judul proyek pengeditan cloud.

    example
    Description

    string

    No

    Deskripsi proyek pengeditan cloud.

    描述
    Timeline

    string

    No

    Timeline proyek pengeditan cloud dalam format JSON.

    {"VideoTracks":[{"VideoTrackClips":[{"MediaId":"****4d7cf14dc7b83b0e801c****"},{"MediaId":"****4d7cf14dc7b83b0e801c****"}]}]}
    CoverURL

    string

    No

    URL sampul proyek pengeditan cloud.

    https://example.com/example.png
    TemplateId

    string

    No

    ID templat yang digunakan untuk membuat timeline dengan cepat dan mudah.

    Penting Tentukan tepat satu dari Timeline atau TemplateId. Jika TemplateId ditentukan, ClipsParam juga harus ditentukan.

    ****96e8864746a0b6f3****
    ClipsParam

    string

    No

    Parameter material untuk templat dalam format JSON. Jika TemplateId ditentukan, ClipsParam juga harus ditentukan. Untuk informasi lebih lanjut tentang format, lihat Create and use a common template dan Create and use an advanced template.

    见模板使用文档
    TemplateType

    string

    No

    Tipe templat. Tentukan parameter ini saat Anda membuat proyek pengeditan cloud berbasis templat. Nilai default: Timeline.

    Nilai valid:

    • Timeline: templat umum.

    • VETemplate: templat lanjutan.

    Valid values:

    • Timeline :

      Templat umum.

    • VETemplate :

      Templat lanjutan.

    Timeline
    MaterialMaps

    string

    No

    Material yang terkait dengan proyek. Pisahkan beberapa ID material dengan koma (,). Maksimal 10 ID material didukung untuk setiap tipe.

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

    string

    No

    Konfigurasi bisnis proyek. Anda dapat mengabaikan parameter ini untuk proyek pengeditan umum.

    • Untuk proyek pengeditan langsung, OutputMediaConfig.StorageLocation wajib ditentukan.

    • Jika OutputMediaConfig.Path tidak ditentukan, klip langsung yang dihasilkan disimpan di path root.

    • Nilai valid OutputMediaTarget: vod-media dan oss-object. Nilai default: oss-object.

    • Ketika OutputMediaTarget diatur ke vod-media, Path tidak berlaku.

    { "OutputMediaConfig" : { "StorageLocation": "test-bucket.oss-cn-shanghai.aliyuncs.com", "Path": "test-path" }, "OutputMediaTarget": "oss-object", "ReservationTime": "2021-06-21T08:05:00Z" }
    ProjectType

    string

    No

    Tipe proyek pengeditan.

    • EditingProject: proyek pengeditan umum.

    • LiveEditingProject: proyek pengeditan langsung.

    LiveEditingProject

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Tanggapan.

    RequestId

    string

    ID permintaan.

    ******3B-0E1A-586A-AC29-742247******
    Project

    object

    Proyek pengeditan cloud.

    ProjectId

    string

    ID proyek pengeditan cloud.

    ****01bf24bf41c78b2754cb3187****
    Title

    string

    Judul proyek pengeditan cloud.

    example_title
    Description

    string

    Deskripsi proyek.

    example_description
    Timeline

    string

    Timeline proyek pengeditan cloud dalam format JSON. Untuk informasi lebih lanjut tentang struktur, lihat TimeLine. Jika bidang ini kosong, timeline kosong akan dibuat dan total durasi proyek pengeditan cloud adalah 0.

    {"VideoTracks":[{"VideoTrackClips":[{"MediaId":"****4d7cf14dc7b83b0e801c****"},{"MediaId":"****4d7cf14dc7b83b0e801c****"}]}]}
    TemplateId

    string

    ID templat.

    ****96e8864746a0b6f3****
    ClipsParam

    string

    Parameter material templat.

    见模板使用文档
    CoverURL

    string

    URL sampul proyek pengeditan cloud.

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

    integer

    Status proyek pengeditan cloud.

    Nilai valid:

    • 1: Draft

    • 2: Editing

    • 3: Producing

    • 4: Produced

    • 5: ProduceFailed

    • 7: Deleted.

    2
    StatusName

    string

    Nama status proyek pengeditan cloud, yang sesuai dengan nama status dalam daftar status.

    Editing
    CreateTime

    string

    Waktu pembuatan proyek pengeditan cloud.

    2021-01-08T16:52:07Z
    ModifiedTime

    string

    Waktu modifikasi terakhir proyek pengeditan cloud.

    2021-01-08T16:52:07Z
    Duration

    number

    Durasi proyek pengeditan cloud.

    3.4200000
    CreateSource

    string

    Metode yang digunakan untuk membuat proyek pengeditan cloud.

    • OpenAPI

    • AliyunConsole

    • WebSDK

    • LiveEditingOpenAPI

    • LiveEditingConsole.

    WebSDK
    ModifiedSource

    string

    Metode yang digunakan untuk memodifikasi proyek pengeditan cloud.

    • OpenAPI

    • AliyunConsole

    • WebSDK

    • LiveEditingOpenAPI

    • LiveEditingConsole.

    WebSDK
    TemplateType

    string

    Tipe templat proyek pengeditan cloud.

    • Timeline

    • VETemplate.

    Timeline
    BusinessConfig

    string

    Konfigurasi bisnis proyek. Anda dapat mengabaikan parameter ini untuk proyek pengeditan umum.

    { "OutputMediaConfig" : { "StorageLocation": "test-bucket.oss-cn-shanghai.aliyuncs.com", "Path": "test-path" }, "OutputMediaTarget": "oss-object", "ReservationTime": "2021-06-21T08:05:00Z" }
    ProjectType

    string

    Tipe proyek pengeditan. Nilai default: EditingProject.

    • EditingProject: proyek pengeditan umum.

    • LiveEditingProject: proyek pengeditan langsung.

    LiveEditingProject
    BusinessStatus

    string

    Status bisnis proyek. Anda dapat mengabaikan parameter ini untuk proyek pengeditan umum.

    • Reserving: Proyek sedang dalam proses reservasi.

    • ReservationCanceled: Reservasi dibatalkan.

    • BroadCasting: Proyek sedang melakukan streaming langsung.

    • LoadingFailed: Proyek gagal dimuat.

    • LiveFinished: Streaming langsung telah berakhir.

    Reserving

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "Project": {
    "ProjectId": "****01bf24bf41c78b2754cb3187****",
    "Title": "example_title",
    "Description": "example_description",
    "Timeline": "{\"VideoTracks\":[{\"VideoTrackClips\":[{\"MediaId\":\"****4d7cf14dc7b83b0e801c****\"},{\"MediaId\":\"****4d7cf14dc7b83b0e801c****\"}]}]}",
    "TemplateId": "****96e8864746a0b6f3****",
    "ClipsParam": "见模板使用文档",
    "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
    "Status": 2,
    "StatusName": "Editing",
    "CreateTime": "2021-01-08T16:52:07Z",
    "ModifiedTime": "2021-01-08T16:52:07Z",
    "Duration": 3.42,
    "CreateSource": "WebSDK",
    "ModifiedSource": "WebSDK",
    "TemplateType": "Timeline",
    "BusinessConfig": "{ \"OutputMediaConfig\" :    { \"StorageLocation\": \"test-bucket.oss-cn-shanghai.aliyuncs.com\", \"Path\": \"test-path\"   }, \"OutputMediaTarget\": \"oss-object\", \"ReservationTime\": \"2021-06-21T08:05:00Z\" }",
    "ProjectType": "LiveEditingProject",
    "BusinessStatus": "Reserving"
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.