---
url: /docs/objs_to_str_list.zh.md
---
# OBJS\_TO\_STR\_LIST API 接口文档

## 🌐 语言切换

[中文版](/docs/objs_to_str_list.zh) | [English](/docs/objs_to_str_list)

## 接口信息

```
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 | 未知异常 | 内部处理异常 | 联系技术支持 |

## 注意事项

1. **参数要求**: outputs参数为必填项
2. **返回值**: 将输入的对象列表中的output字段提取出来组成字符串列表

## 工作流程

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

## 相关接口

* [创建草稿](/docs/create_draft)

***

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