---
url: /docs/str_list_to_objs.md
---
# STR\_LIST\_TO\_OBJS API Documentation

## 🌐 Language Switch

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

## Interface Information

```
POST /openapi/capcut-mate/v1/str_list_to_objs
```

## Function Description

Convert string list to object list. This interface is used to convert input string list to object list format.

## Request Parameters

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

### Parameter Description

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| infos | array\[string] |✅ | - | String list |

### Parameter Details

#### infos

* **Type**: array\[string]
* **Description**: String list to convert
* **Example**: `["https://assets.jcaigc.cn/min.mp4", "https://assets.jcaigc.cn/max.mp4"]`

## Response Format

### Success Response (200)

```json
{
  "code": 0,
  "message": "success",
  "infos": [
    {
      "output": "https://assets.jcaigc.cn/min.mp4"
    },
    {
      "output": "https://assets.jcaigc.cn/max.mp4"
    }
  ]
}
```

### Response Field Description

| Field | Type | Description |
|-------|------|-------------|
| infos | array\[object] | Object list |
| output | string | URL address |

### Error Response

```json
{
  "code": 1001,
  "message": "Parameter validation failed"
}
```

## Usage Examples

### cURL Examples

#### 1. Basic Usage

```bash
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/str_list_to_objs \
  -H "Content-Type: application/json" \
  -d '{
    "infos": [
      "https://assets.jcaigc.cn/min.mp4",
      "https://assets.jcaigc.cn/max.mp4"
    ]
  }'
```

## Error Code Description

| Error Code | Error Message | Description | Solution |
|------------|---------------|-------------|----------|
| 1001 | Parameter validation failed | infos is missing (request body failed schema validation) | Provide a valid infos parameter |
| 9999 | Unknown error | Unexpected internal processing error | Contact technical support |

## Notes

1. **Parameter Requirements**: infos parameter is required
2. **Return Value**: Convert input string list to object list containing output fields

## Workflow

1. Validate required parameter (infos)
2. Call service layer to handle business logic
3. Return converted object list

## Related Interfaces

* [Create Draft](/docs/create_draft)

***

📚 **Project Resources**\
**GitHub**: <https://github.com/Hommy-master/capcut-mate>\
**Gitee**: <https://gitee.com/taohongmin-gitee/capcut-mate>