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