텍스트 음성 변환

보이스 클론

립싱크

기타

작업 조회

립싱크 작업 조회 API를 테스트합니다.

립싱크 조회 API

엔드포인트

GET /api/open/lip-sync/query?id=YOUR_TASK_ID

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

요청 헤더

Authorization: Bearer YOUR_API_TOKEN  // API key

요청 파라미터

{
  "id": string  // Required, task ID returned at task creation
}

응답 데이터

// Success response - 200
{
  "success": true,
  "data": {
    "id": string,               // Task ID
    "status": string,           // Task status: "pending" | "processing" | "completed" | "failed"
    "progress": number,         // Progress percentage (0-100)
    "result_url": string,       // Result video URL (returned when completed)
    "error_message": string,    // Error message (returned when failed)
    "created_at": string,       // Created time
    "updated_at": string,       // Updated time
    "completed_at": string,     // Completed time
    "credits_used": number      // Credits consumed
  }
}

// Error response
{
  "error": string               // Error message
}

Polling Suggestion

It is recommended to query the task status every 3-5 seconds until status is "completed" or "failed"

CURL 예시

curl -X GET "https://fishaudio.org/api/open/lip-sync/query?id=YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

온라인 디버그

Polling Suggestion

It is recommended to query the task status every 3-5 seconds until status is "completed" or "failed"

상태 코드

200: Success
400: Bad Request
401: Unauthorized
403: Forbidden
404: Not Found
429: Too Many Requests
500: Internal Server Error