获取模型列表

获取公共和个人语音模型列表

获取模型列表接口

接口地址

POST /api/open/list-models

请求头

Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN  // API Key

请求参数

{
  "modelType": string,        // 可选，undefined
  "includePersonal": boolean, // 可选，undefined
  "page": number,            // 可选，undefined
  "pageSize": number         // 可选，undefined
}

返回数据

// 成功响应 - 200
{
  "total": number,       // undefined
  "page": number,        // undefined
  "pageSize": number,    // undefined
  "totalPages": number,  // undefined
  "items": [            // undefined
    {
      "modelId": string,      // undefined
      "title": string,        // undefined
      "description": string,  // undefined
      "created_at": string,   // undefined
      "updated_at": string,   // undefined
      "isPersonal": boolean   // undefined
    }
  ]
}

// 错误响应
{
  "error": string     // 错误提示信息
}

CURL 示例

curl -X POST https://kittaai.com/api/open/list-models \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "modelType": "all",
    "page": 1,
    "pageSize": 10
  }'

在线调试

状态码说明

状态码说明：
200 OK                  - 请求成功
400 Bad Request         - 请求参数错误
401 Unauthorized        - API Token 无效
403 Forbidden          - 禁止访问
404 Not Found          - 资源不存在
413 Payload Too Large  - 上传文件过大
429 Too Many Requests  - 请求频率超限/积分不足
500 Server Error       - 服务器内部错误

错误响应格式：
{
  "error": string,      // 错误信息
  "details": string,    // 详细错误信息（可选）
  "code": string       // 错误代码（可选）
}