tencent cloud

APIs

문서APIsVideo on DemandMedia Upload APIsPullUpload

PullUpload

다운로드
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-09-22 21:55:51

1. API Description

Domain name for API request: vod.intl.tencentcloudapi.com.

This API is used to pull a video from the network to the VOD platform.

A maximum of 100 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: PullUpload.
Version Yes String Common Params. The value used for this API: 2018-07-17.
Region No String Common Params. This parameter is not required.
MediaUrl Yes String

Media URL to be pulled. Pulling Dash format is not currently supported (HLS is supported).
For supported extensions, see Media Type. Please ensure the media URL can be accessed.
MediaType No String

Media file type (extension). For supported types, see Media Type.
If MediaType is not specified or is an empty string, the file type is automatically obtained based on MediaUrl.
SubAppId No Integer

Video-on-demand (VOD) application ID. For customers who activate VOD services on or after December 25, 2023, this field must be set to the app ID when accessing resources in VOD applications, whether in the default application or a newly created application.
MediaName No String

Media name.
CoverUrl No String

Video cover URL to fetch. Supported file formats: gif, jpeg (jpg), png.
Procedure No String

For media subsequent task operation, see Upload specified task flow.
ExpireTime No Timestamp ISO8601

Media file expiry time. The format follows the ISO 8601 standard. For details, see ISO date format description.
StorageRegion No String

Specify an upload park. This is applicable only to users with special requirements for upload regions:

  • If left empty, files are uploaded to your default region by default.
  • If you specify an upload park, please confirm that the corresponding storage regions have been enabled in upload storage settings.
    		•
    ClassId No Integer

    Category ID, used to categorize and manage media. You can create a category through the create category API to obtain the category ID.
    TasksPriority No Integer

    Task priority. The higher the value, the higher the priority. The value range is from -10 to 10. If this is not specified, the default value is 0.
    SessionContext No String

    Source context. This is used to pass user request information. When specifying a Procedure task, the task flow status change callback returns the value of this field. The maximum length is 1000 characters.
    SessionId No String

    Identifier for deduplication. If a request with the same identifier has been sent within the past three days, an error is returned for the current request. The maximum length is 50 characters. If this is not specified or left empty, deduplication is not performed.
    ExtInfo No String

    Reserved field, used for special purpose.
    SourceContext No String

    Source context. This is used to pass user request information. The upload completion callback returns the value of this field. The maximum length is 250 characters.
    MediaStoragePath No String

    Media storage path, starting with /.
    Only sub-apps in FileID + Path mode can specify a storage path.

    3. Output Parameters

    Parameter Name Type Description
    TaskId String

    Task ID for pulling and uploading videos. This can be used to query the pull upload task status.
    RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

    4. Example

    Example1 Pull and upload an MP4 video with the URL

    http://www.abc.com/abc.mp4

    .

    Pull and upload an MP4 video

    Input Example

    POST / HTTP/1.1
Host: vod.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: PullUpload
<Common request parameters>

{
    "MediaUrl": "http://www.abc.com/abc.mp4"
}

    Output Example

    {
    "Response": {
        "RequestId": "5ca61e3a-6b8e-4b4e-9256-fdc701190064ef0",
        "TaskId": "125xxxxxx07-pull-893dc41e6fdc22dcf24aa6e9c61cp94"
    }
}

    Example2 Pull and upload an MP4 video with a Chinese mainland URL

    http://www.abc.com/abc.mp4

    to the Chongqing park.

    Pull upload MP4 videos to the Chongqing park

    Input Example

    POST / HTTP/1.1
Host: vod.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: PullUpload
<Common request parameters>

{
    "StorageRegion": "ap-chongqing",
    "MediaUrl": "http://www.abc.com/abc.mp4"
}

    Output Example

    {
    "Response": {
        "RequestId": "6ca61e3a-6b8e-4b4e-9256-fdc701190064ef0",
        "TaskId": "125xxxxxx07-pull-793dc41e6fdc22dcf24aa6e9c61cp94"
    }
}

    Example3 Pull upload an MP4 video from an overseas URL

    http://www.abc.com/abc.mp4

    to the Singapore industrial park.

    Pull upload MP4 to the Singapore industrial park

    Input Example

    POST / HTTP/1.1
Host: vod.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: PullUpload
<Common request parameters>

{
    "StorageRegion": "ap-singapore",
    "MediaUrl": "http://www.abc.com/abc.mp4"
}

    Output Example

    {
    "Response": {
        "RequestId": "5ca61e3a-6b8e-4b4e-9256-fdc701190064ef0",
        "TaskId": "125xxxxxx07-pull-693dc41e6fdc22dcf24aa6e9c61cp94"
    }
}

    5. Developer Resources

    SDK

    TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

    Command Line Interface

    6. Error Code

    The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

    Error Code Description
    FailedOperation Operation failed.
    FailedOperation.CoverType Operation failed: Unsupported cover type.
    FailedOperation.InvalidVodUser VOD service is not enabled.
    FailedOperation.MediaType Operation failed: Unsupported media type.
    InternalError Internal error.
    InvalidParameter.ExpireTime Parameter value error: expiration time.
    InvalidParameter.StorageRegion Parameter value error: storage region.
    InvalidParameterValue Parameter value error.
    InvalidParameterValue.CoverUrl Parameter value error: cover URL.
    InvalidParameterValue.ExpireTime Invalid parameter value: Incorrect ExpireTime format.
    InvalidParameterValue.MediaStoragePath Parameter value error: media storage path.
    InvalidParameterValue.MediaUrl Parameter value error: media file URL.
    InvalidParameterValue.SessionContextTooLong SessionContext is too long.
    InvalidParameterValue.SessionId Duplicate recognition code. Request deduplicated.
    InvalidParameterValue.SessionIdTooLong SessionId is too long.
    InvalidParameterValue.StorageRegion Parameter value error: storage region.
    ResourceNotFound.CoverUrl Resource not found: cover does not exist.
    ResourceNotFound.UserNotExist The user does not exist.
    UnauthorizedOperation Unauthorized operation.
    이전 주제: ParseStreamingManifest다음 주제: DeleteMedia

    도움말 및 지원

    문제 해결에 도움이 되었나요?

    피드백

    키워드로 검색
      Enter keywords to search documentation