capcut-mate/docs/str_to_list.md

STR_TO_LIST API 接口文档

接口信息

POST /openapi/capcut-mate/v1/str_to_list

功能描述

字符转列表。该接口用于将输入的字符串转换为列表格式。

更多文档

📖 更多详细文档和教程请访问：https://docs.jcaigc.cn

请求参数

{
  "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)

{
  "infos": [
    "{   \"infos\": [     \"https://assets.jcaigc.cn/min.mp4\",     \"https://assets.jcaigc.cn/max.mp4\"   ] }"
  ]
}

响应字段说明

字段名	类型	说明
infos	array[string]	字符串列表

错误响应 (4xx/5xx)

{
  "detail": "错误信息描述"
}

使用示例

cURL 示例

1. 基本使用

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\"   ] }"
  }'

错误码说明

错误码	错误信息	说明	解决方案
400	obj是必填项	缺少obj参数	提供有效的obj参数
500	字符转列表失败	内部处理错误	联系技术支持

注意事项

1. 参数要求: obj参数为必填项
2. 返回值: 将输入的字符串作为单个元素放入列表中返回

工作流程

1. 验证必填参数（obj）
2. 调用服务层处理业务逻辑
3. 返回转换后的字符串列表

相关接口

• 创建草稿

---

📚 项目资源
GitHub: https://github.com/Hommy-master/capcut-mate
Gitee: https://gitee.com/taohongmin-gitee/capcut-mate