獲取模型列表

獲取公共和個人語音模型列表

獲取模型列表接口

接口地址

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       // 錯誤代碼（可選）
}