导入媒资文件

1. 接口描述

接口请求域名： ivld.tencentcloudapi.com 。

将URL指向的媒资视频文件导入系统之中。

请注意，本接口为异步接口。接口返回MediaId仅代表导入视频任务发起，不代表任务完成，您可调用读接口(DescribeMedia/DescribeMedias)接口查询MediaId

URL字段推荐您使用COS地址，其形式为https://${Bucket}-${AppId}.cos.${Region}.myqcloud.com/${ObjectKey}，其中${Bucket}为您的COS桶名称，Region为COS桶所在可用区，${ObjectKey}为指向存储在COS桶内的待分析的视频的ObjectKey

另外，目前产品也支持使用外部URL地址，但是当传入URL为非COS地址时，需要您指定额外的WriteBackCosPath以供产品回写结果数据。

分析完成后，本产品将在您的${Bucket}桶内创建名为${ObjectKey}_${task-create-time}的目录(task-create-time形式为1970-01-01T08:08:08)并将分析结果将回传回该目录，也即，结构化分析结果(包括图片，JSON等数据)将会写回https://${Bucket}-${AppId}.cos.${Region}.myqcloud.com/${ObjectKey}_${task-create-time}目录

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 导入图片

输入示例

POST / HTTP/1.1
Host: ivld.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ImportMedia
<公共请求参数>

{
    "URL": "https://ai-media-251202827.cos.ap-guangzhou.myqcloud.com/phye-debug/male.png",
    "Name": "male.png",
    "MediaType": "1"
}

输出示例

{
    "Response": {
        "MediaId": "media-9DfyyCOZ",
        "RequestId": "a642b499-9ebd-4601-a57e-a8cf5c2bee49"
    }
}

示例2 发起导入任务成功

输入示例

POST / HTTP/1.1
Host: ivld.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ImportMedia
<公共请求参数>

{
    "URL": "https://ai-media-1256936300.cos.ap-guangzhou.myqcloud.com/ai-media/test/test-news-6mins.mp4",
    "Name": "demo-video-0"
}

输出示例

{
    "Response": {
        "MediaId": "media-a1b2c3d4",
        "RequestId": "50f3df82-beae-4f5f-9b47-23e8302f62ae"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。