List Models

Get public and personal voice model lists

List Models API

Endpoint

POST /api/open/list-models

Request Headers

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

Request Parameters

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

Response Data

// Success Response - 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 Response
{
  "error": string     // Error message
}

CURL Example

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

Online Debug

Status Code Description

Status Code Description:
200 OK                  - Request successful
400 Bad Request         - Invalid request parameters
401 Unauthorized        - Invalid API Token
403 Forbidden          - Access forbidden
404 Not Found          - Resource not found
413 Payload Too Large  - Upload file too large
429 Too Many Requests  - Rate limit exceeded/Insufficient credits
500 Server Error       - Internal server error

Error Response Format:
{
  "error": string,      // Error message
  "details": string,    // Detailed error message (optional)
  "code": string       // Error code (optional)
}