All Products
Search

This Product

    ApsaraVideo Live:StartRtcCloudTranscode

    Document Center

    ApsaraVideo Live:StartRtcCloudTranscode

    Last Updated:Jun 10, 2026

    Membuat Pekerjaan transkoding cloud.

    Deskripsi operasi

    Endpoints

    The following endpoints are available for this operation.

    RegionRegion IDPublic endpoint
    Singaporeap-southeast-1live.ap-southeast-1.aliyuncs.com

    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

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Sintaks permintaan

    POST  HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    AppId

    string

    Yes

    ID aplikasi tempat saluran berada. ID dapat berisi huruf besar, huruf kecil, angka, garis bawah (_), dan tanda hubung (-). Panjang maksimum adalah 64 karakter.

    ********-7074-****-9ef5-85c19a4*****
    ChannelId

    string

    Yes

    ID saluran tempat pengguna yang akan ditranskoding berada. ID dapat berisi huruf besar, huruf kecil, angka, garis bawah (_), dan tanda hubung (-). Panjang maksimum adalah 64 karakter.

    myChannel
    InputParam

    object

    Yes

    Parameter untuk langganan aliran input.

    SingleSubUserParam

    object

    Yes

    The input parameters for a single-stream subscription.

    UserId

    string

    Yes

    The ID of the user whose stream you want to subscribe to.

    userA
    StreamType

    integer

    No

    The media type of the subscribed stream. Valid values:

    • 0 (default): The original stream, which includes both the audio and video streams.

    • 1: The audio-only stream. (This value is not supported. The setting is invalid.)

    • 2: The video-only stream. (This value is not supported. The setting is invalid.)

    0
    SourceType

    integer

    No

    The type of the video input stream. This parameter is valid only if the subscribed media type includes a video stream. Valid values:

    • 0 (default): The camera stream.

    • 1: The screen sharing stream. (This value is not supported. The setting is invalid.)

    0
    OutputParams

    array<object>

    Yes

    Parameter untuk output yang telah dikodekan ulang.

    object

    No

    The parameters for a transcoded output stream.

    ChannelId

    string

    Yes

    The ID of the channel to which the transcoded stream is pushed. The ID can contain uppercase letters, lowercase letters, digits, underscores (_), and hyphens (-). The maximum length is 64 characters. (Pushing streams to a different channel is not supported. This setting is invalid.)

    myChannel
    UserId

    string

    Yes

    The user ID for the transcoded stream in the destination channel. This ID must be unique within the channel.

    userA_360p
    UserToken

    string

    Yes

    The token required to push the transcoded stream to the channel. For more information, see Token-based authentication.

    eyJhcHBpZCI********
    TranscodeTemplate

    string

    Yes

    The name of the transcoding template. Valid values:

    • alimcopy

    • lld

    • lsd

    • lhd

    • lud

    lhd
    MaxIdleTime

    integer

    No

    Periode batas waktu idle dalam detik. Jika sebuah Tugas tidak dapat Berlangganan aliran Streamer yang ditentukan dan tetap idle lebih lama dari periode ini, Tugas tersebut akan otomatis berhenti. Nilai harus berupa bilangan bulat dari 10 hingga 14.400. Nilai default adalah 300.

    600

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The response.

    RequestId

    string

    The request ID.

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

    string

    The ID of the cloud transcoding job.

    ******73-8501-****-8ac1-72295a******

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "TaskId": "******73-8501-****-8ac1-72295a******"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter%s %s.
    400 MissingParameter%s %s.
    400 TooManyRequests %s.
    500 InternalError %s.
    403 Forbidden %s.
    404 NotFound%s %s.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.