描述

本接口用于云端处理视频去字幕请求。

版本

1.0

图片要求

输入媒体为 MP4 格式视频。

调用 URL

    正式环境：https://openapi.meitu.com
    任务提交接口：https://openapi.meitu.com/api/v1/sdk/sync/push
    任务名称(task)：/v1/videosubtitle_remove/485023
    任务类型(task_type)：formula

调用方法

POST

Content-Type: application/json

权限

开放平台接口签名

请求参数

是否必选	参数名	类型	参数说明
必选	params	string	算法参数（JSON 字符串）
必选	init_images	object[]	视频文件列表
必选	task	string	固定 `/v1/videosubtitle_remove/485023`
必选	task_type	string	固定 `formula`
可选	sync_timeout	int	默认 30；同步超时后返回 status=9，可使用查询接口查询

init_images 多媒体文件参数，结构说明如下

是否必选	参数名	类型	参数说明
必选	url	string	视频 URL 或 base64
必选	profile	object	属性信息描述

profile 属性信息描述

是否必选	参数名	类型	参数说明
必选	media_profiles	object	媒体属性信息
必选	version	string	固定 `v1`

media_profiles 媒体属性信息

是否必选	参数名	类型	参数说明
必选	media_data_type	string	`url` 表示 URL；对应媒体类型表示 base64

params 推理参数是 JSON 字符串，其结构说明如下

是否必选	字段	类型	说明
可选	rsp_media_type	string	默认 `url`，表示结果以 URL 返回
必选	parameter	object	算法核心参数对象

parameter 算法参数详情

是否必选	字段	类型	说明
可选	version	string	算法版本，支持 `1.0.0`、`2.0.0` 等，默认 `1.0.0`
可选	userboxes	string	用户交互框坐标；从左上角开始，按顺时针到左下角给出四个点的归一化坐标；默认无

输入值示例

{
  "task": "/v1/videosubtitle_remove/485023",
  "task_type": "formula",
  "init_images": [
    {
      "url": "https://xxx.mp4",
      "profile": {
        "media_profiles": {
          "media_data_type": "url"
        },
        "version": "v1"
      }
    }
  ],
  "params": "{\"rsp_media_type\":\"url\",\"parameter\":{\"userboxes\":\"[[[0, 0.5], [1, 0.5], [1, 0.8], [0, 0.8]]]\"}}",
  "sync_timeout": 30
}

返回值说明

注意，生成的结果，会定期清理，请及时下载保存

字段	类型	说明
request_id	string	请求标识
trace_id	string	链路追踪标识
code	int	业务状态码，`0` 表示请求受理成功
error_code	int	错误码，成功时为 `0`
message	string	业务信息
tips	any	补充提示，可为 null
data	object	任务状态和算法结果

data 中单个元素的字段说明

字段	类型	说明
status	int	状态码：`-1` 未找到任务；`0` 创建成功；`1` 执行中；`2` 失败；`9` 超时，使用查询接口查询；`10` 成功
result	object	算法结果
progress	number	任务进度
predict_elapsed	int	预计耗时，毫秒
create_time	int64	创建时间戳，毫秒
task_id	string	任务 ID
custom_task_id	string	客户自定义任务 ID
trace_id	string	data 内链路标识
client_info	string	客户端信息
init_images	object[]/null	输入媒体回显

result 中单个元素的字段说明

字段	类型	说明
id	string	结果任务 ID
urls	array	输出视频 URL 列表
images	array	输出图像或视频 URL 列表
parameters	object	请求参数回显
data	object	结果内部数据，包括耗时和媒体信息
msg	string	返回消息
msg_id	string	消息 ID
mtlab_res	object	MTLab 兼容结果字段，包含错误信息等
media_info_list	array	媒体信息列表

result.parameters 字段说明

字段	类型	说明
exist_text	bool	是否存在字幕文本
rsp_media_type	string	返回媒体类型，如 `url`
version	string	算法版本信息，如 `VideoSubtitleRemove version: 2.0.3`

result.data 字段说明

字段	类型	说明
duration	object	各类耗时信息
error_code	int	错误码
error_msg	string	错误信息
extra	object	额外数据
media_info_list	array	媒体数据列表
msg_id	string	消息 ID
parameter	object	参数，与 parameters 相同

result.data.duration 字段说明

字段	类型	说明
alg_process_time	int	算法处理时间
created_timestamp	int64	创建时间戳
pull_timestamp	int64	拉取时间戳
repost_time	int	转发时间
upload_time	int	上传耗时
waiting_time	int	等待时长

result.data.extra.trans_meta.rsp_meta 数组字段说明

字段	类型	说明
data_rate	float	数据码率
duration	int	时长
frame_num	int	帧数
frame_rate	float	帧率
height	int	高度
media_type	string	媒体类型
size	int	文件大小
width	int	宽度

media_info_list 数组元素字段说明

字段	类型	说明
media_data	string	媒体 URL
media_extra	object/null	额外信息
media_profiles	object	媒体属性

media_profiles 字段说明

字段	类型	说明
media_data_fps	float	帧率
media_data_height	int	高度
media_data_size	int	文件大小
media_data_type	string	类型，如 `url`
media_data_width	int	宽度

mtlab_res 字段说明

字段	类型	说明
ErrorCode	int	错误码
ErrorMsg	string	错误信息
error_code	int	错误码
error_msg	string	错误信息
media_info_list	array/null	媒体信息
msg_id	string	消息 ID
parameter	object/null	参数

返回值示例

请求成功返回示例

{
  "request_id": "request_id",
  "trace_id": "trace_id",
  "code": 0,
  "error_code": 0,
  "message": "success",
  "tips": null,
  "data": {
    "status": 10,
    "result": {
      "id": "task_id",
      "urls": [
        "https://obs-large.mtlab.meitu.com/mtopen/30f1b44ea57c4d94bbdfda14005b7332/e034c450-6ca4-4b2e-409d-b594a35cce50/e034c450-6ca4-4b2e-409d-b594a35cce50.mp4"
      ],
      "images": [
        "https://obs-large.mtlab.meitu.com/mtopen/30f1b44ea57c4d94bbdfda14005b7332/e034c450-6ca4-4b2e-409d-b594a35cce50/e034c450-6ca4-4b2e-409d-b594a35cce50.mp4"
      ],
      "parameters": {
        "exist_text": true,
        "rsp_media_type": "url",
        "version": "VideoSubtitleRemove version: 2.0.3"
      },
      "data": {
        "duration": {
          "alg_process_time": 158283,
          "created_timestamp": 1765098852,
          "pull_timestamp": 1765098852,
          "repost_time": 0,
          "upload_time": 1135,
          "waiting_time": 153
        },
        "error_code": 0,
        "error_msg": "success",
        "extra": {
          "trans_meta": {
            "rsp_meta": [
              {
                "data_rate": 51369.922,
                "duration": 0,
                "frame_num": 1537,
                "frame_rate": 29.92023277282715,
                "height": 720,
                "media_type": "video",
                "size": 33731714,
                "width": 960
              }
            ]
          }
        },
        "media_info_list": [
          {
            "media_data": "https://obs-large.mtlab.meitu.com/mtopen/30f1b44ea57c4d94bbdfda14005b7332/e034c450-6ca4-4b2e-409d-b594a35cce50/e034c450-6ca4-4b2e-409d-b594a35cce50.mp4",
            "media_extra": null,
            "media_profiles": {
              "media_data_fps": 29.92023277282715,
              "media_data_height": 720,
              "media_data_size": 33731714,
              "media_data_type": "url",
              "media_data_width": 960
            }
          }
        ],
        "msg_id": "msg_id",
        "parameter": {
          "exist_text": true,
          "rsp_media_type": "url",
          "version": "VideoSubtitleRemove version: 2.0.3"
        }
      },
      "msg": "success",
      "msg_id": "msg_id",
      "mtlab_res": {
        "ErrorCode": 0,
        "ErrorMsg": "",
        "error_code": 0,
        "error_msg": "",
        "media_info_list": null,
        "msg_id": "msg_id",
        "parameter": null
      },
      "media_info_list": [
        {
          "media_data": "https://obs-large.mtlab.meitu.com/mtopen/30f1b44ea57c4d94bbdfda14005b7332/e034c450-6ca4-4b2e-409d-b594a35cce50/e034c450-6ca4-4b2e-409d-b594a35cce50.mp4",
          "media_extra": null,
          "media_profiles": {
            "media_data_fps": 29.92023277282715,
            "media_data_height": 720,
            "media_data_size": 33731714,
            "media_data_type": "url",
            "media_data_width": 960
          }
        }
      ]
    },
    "progress": 1,
    "predict_elapsed": 10000,
    "create_time": 1765098852464,
    "task_id": "task_id",
    "custom_task_id": "",
    "trace_id": "",
    "client_info": "",
    "init_images": null
  }
}

需要查询返回示例

使用查询接口查询。

Response Status：200

content-type 为 application/json; charset=utf-8

{
  "request_id": "request_id",
  "trace_id": "trace_id",
  "code": 0,
  "error_code": 0,
  "message": "processing timeout",
  "tips": null,
  "data": {
    "status": 9,
    "result": {},
    "progress": 0,
    "predict_elapsed": 0,
    "create_time": 1765098852464,
    "task_id": "task_id",
    "custom_task_id": "",
    "trace_id": "trace_id",
    "client_info": "",
    "init_images": null
  }
}

请求失败返回示例

Response Status：400

content-type 为 application/json; charset=utf-8

{
  "request_id": "request_id",
  "trace_id": "trace_id",
  "code": 20001,
  "error_code": 20001,
  "message": "PROCESS_ERROR",
  "tips": null,
  "data": {
    "status": 2,
    "result": {
      "ErrorCode": 20001,
      "ErrorMsg": "PROCESS_ERROR",
      "Data": null
    },
    "progress": 0,
    "predict_elapsed": 0,
    "create_time": 1765098852464,
    "task_id": "task_id",
    "custom_task_id": "",
    "trace_id": "trace_id",
    "client_info": "",
    "init_images": null
  }
}

通用的错误代码与信息

详见 API 错误码

SDK 调用示例

Python

import json

import requests
from sign_sdk import sign

def api_call_example():
    key = "your_api_key"
    secret = "your_api_secret"
    url = "https://openapi.meitu.com/api/v1/sdk/sync/push"
    method = "POST"

    headers = {
        "Content-Type": "application/json",
        sign.HeaderHost: "openapi.meitu.com",
    }
    inner_params = {
        "rsp_media_type": "url",
        "parameter": {
            "userboxes": "[[[0, 0.5], [1, 0.5], [1, 0.8], [0, 0.8]]]"
        },
    }
    payload = {
        "task": "/v1/videosubtitle_remove/485023",
        "task_type": "formula",
        "init_images": [
            {
                "url": "https://xxx.mp4",
                "profile": {
                    "media_profiles": {"media_data_type": "url"},
                    "version": "v1",
                },
            }
        ],
        "params": json.dumps(inner_params, ensure_ascii=False),
        "sync_timeout": 30,
    }
    body = json.dumps(payload, ensure_ascii=False)

    signer = sign.Signer(key, secret)
    signed_request = signer.sign(url, method, headers, body)
    response = requests.Session().send(signed_request)
    print(f"Status: {response.status_code}")
    print(f"Response: {response.text}")

if __name__ == "__main__":
    api_call_example()

Go

package main

import (
	"fmt"
	"io"
	"net/http"

	"github.com/mtlab/api/signer"
)

func main() {
	key := "your_api_key"
	secret := "your_api_secret"
	signObj := signer.NewSigner(key, secret)

	url := "https://openapi.meitu.com/api/v1/sdk/sync/push"
	method := http.MethodPost
	headers := make(http.Header)
	headers.Set(signer.HeaderHost, "openapi.meitu.com")
	headers.Set("Content-Type", "application/json")

	body := `{
  "task": "/v1/videosubtitle_remove/485023",
  "task_type": "formula",
  "init_images": [{
    "url": "https://xxx.mp4",
    "profile": {
      "media_profiles": {"media_data_type": "url"},
      "version": "v1"
    }
  }],
  "params": "{\"rsp_media_type\":\"url\",\"parameter\":{\"userboxes\":\"[[[0, 0.5], [1, 0.5], [1, 0.8], [0, 0.8]]]\"}}",
  "sync_timeout": 30
}`

	req, err := signObj.Sign(url, method, headers, body)
	if err != nil {
		fmt.Println("Failed to sign request:", err)
		return
	}

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		fmt.Println("Failed to send request:", err)
		return
	}
	defer resp.Body.Close()

	responseBody, err := io.ReadAll(resp.Body)
	if err != nil {
		fmt.Println("Read response failed:", err)
		return
	}
	fmt.Println("Response:", resp.StatusCode, string(responseBody))
}

PHP

<?php
require 'signer.php';

$key = 'your_api_key';
$secret = 'your_api_secret';
$signer = new Signer($key, $secret);

$url = 'https://openapi.meitu.com/api/v1/sdk/sync/push';
$method = 'POST';
$headers = ['Content-Type' => 'application/json'];

$innerParams = json_encode([
    'rsp_media_type' => 'url',
    'parameter' => [
        'userboxes' => '[[[0, 0.5], [1, 0.5], [1, 0.8], [0, 0.8]]]',
    ],
]);

$body = json_encode([
    'task' => '/v1/videosubtitle_remove/485023',
    'task_type' => 'formula',
    'init_images' => [
        [
            'url' => 'https://xxx.mp4',
            'profile' => [
                'media_profiles' => ['media_data_type' => 'url'],
                'version' => 'v1',
            ],
        ],
    ],
    'params' => $innerParams,
    'sync_timeout' => 30,
]);

$curl = $signer->sign($url, $method, $headers, $body);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);

if ($status === 0) {
    echo 'Error: ' . curl_error($curl);
} else {
    echo "Status: {$status}\n";
    echo "Response: {$response}\n";
}
curl_close($curl);
?>

Java

package com.meitu.openai.common;

import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

public class Main {
    public static void main(String[] args) throws Exception {
        Signer signer = new Signer("your_api_key", "your_api_secret");
        String url = "https://openapi.meitu.com/api/v1/sdk/sync/push";
        String method = "POST";

        Map<String, String> headers = new HashMap<>();
        headers.put("Content-Type", "application/json");
        headers.put(Signer.HeaderHost, "openapi.meitu.com");

        String body = "{\n" +
                "  \"task\": \"/v1/videosubtitle_remove/485023\",\n" +
                "  \"task_type\": \"formula\",\n" +
                "  \"init_images\": [{\n" +
                "    \"url\": \"https://xxx.mp4\",\n" +
                "    \"profile\": {\n" +
                "      \"media_profiles\": {\"media_data_type\": \"url\"},\n" +
                "      \"version\": \"v1\"\n" +
                "    }\n" +
                "  }],\n" +
                "  \"params\": \"{\\\"rsp_media_type\\\":\\\"url\\\",\\\"parameter\\\":{\\\"userboxes\\\":\\\"[[[0, 0.5], [1, 0.5], [1, 0.8], [0, 0.8]]]\\\"}}\",\n" +
                "  \"sync_timeout\": 30\n" +
                "}";

        Map<String, String> signedHeaders = signer.sign(url, method, headers, body);
        HttpURLConnection connection =
                (HttpURLConnection) new URL(url).openConnection();
        connection.setRequestMethod(method);
        for (Map.Entry<String, String> entry : signedHeaders.entrySet()) {
            connection.setRequestProperty(entry.getKey(), entry.getValue());
        }
        connection.setDoOutput(true);
        connection.getOutputStream().write(body.getBytes(StandardCharsets.UTF_8));

        int status = connection.getResponseCode();
        InputStream stream = status >= 400
                ? connection.getErrorStream()
                : connection.getInputStream();
        try (BufferedReader reader =
                     new BufferedReader(new InputStreamReader(stream))) {
            StringBuilder response = new StringBuilder();
            String line;
            while ((line = reader.readLine()) != null) {
                response.append(line);
            }
            System.out.println("Response: " + status + " " + response);
        }
    }
}