List Tasks

Get all lip-sync task lists and statistics

List Lip Sync Tasks API

Endpoint

GET /api/open/lip-sync/list?page=1&limit=10&status=completed

// Or use POST request
POST /api/open/lip-sync/list

Request Headers

Authorization: Bearer YOUR_API_TOKEN  // API key

Request Parameters

{
  "page": number,    // Optional, page number starting from 1, default 1
  "limit": number,   // Optional, page size, default 10, max 50
  "status": string   // Optional, status filter: "pending" | "processing" | "completed" | "failed"
}

Response Data

// Success response - 200
{
  "success": true,
  "data": {
    "tasks": [...],
    "pagination": {
      "page": number,
      "limit": number,
      "total": number,
      "total_pages": number,
      "has_more": boolean
    },
    "statistics": {
      "total": number,
      "pending": number,
      "processing": number,
      "completed": number,
      "failed": number
    }
  }
}

CURL Example

curl -X GET "https://fishaudio.net/api/open/lip-sync/list?page=1&limit=10" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Online Debug

API Key

Status Filter

Page

Items Per Page

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)
}