主题切换
OBJS_TO_STR_LIST API 接口文档
🌐 语言切换
接口信息
POST /openapi/capcut-mate/v1/objs_to_str_list功能描述
对象列表转化成字符串列表。该接口用于将输入的对象列表转换为字符串列表格式。
请求参数
json
{
"outputs": [
{
"output": "https://assets.jcaigc.cn/min.mp4"
},
{
"output": "https://assets.jcaigc.cn/max.mp4"
}
]
}参数说明
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| outputs | array[object] | ✅ | - | 数据对象 |
参数详解
outputs
- 类型: array[object]
- 说明: 需要转换的对象列表
- 示例:
[{"output": "https://assets.jcaigc.cn/min.mp4"}, {"output": "https://assets.jcaigc.cn/max.mp4"}]
响应格式
成功响应 (200)
json
{
"code": 0,
"message": "success",
"infos": [
"https://assets.jcaigc.cn/min.mp4",
"https://assets.jcaigc.cn/max.mp4"
]
}响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| infos | array[string] | 字符串列表 |
错误响应
json
{
"code": 1001,
"message": "参数校验失败"
}使用示例
cURL 示例
1. 基本使用
bash
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/objs_to_str_list \
-H "Content-Type: application/json" \
-d '{
"outputs": [
{
"output": "https://assets.jcaigc.cn/min.mp4"
},
{
"output": "https://assets.jcaigc.cn/max.mp4"
}
]
}'错误码说明
| 错误码 | 错误信息 | 说明 | 解决方案 |
|---|---|---|---|
| 1001 | 参数校验失败 | 缺少 outputs 参数（请求体未通过参数校验） | 提供有效的outputs参数 |
| 9999 | 未知异常 | 内部处理异常 | 联系技术支持 |
注意事项
- 参数要求: outputs参数为必填项
- 返回值: 将输入的对象列表中的output字段提取出来组成字符串列表
工作流程
- 验证必填参数（outputs）
- 调用服务层处理业务逻辑
- 返回转换后的字符串列表