립싱크

립싱크 작업은 소스 비디오와 오디오 트랙을 동기화된 결과 비디오로 결합합니다. 비디오 처리가 일반 HTTP 요청보다 오래 걸릴 수 있으므로 엔드포인트는 비동기식입니다.

작업 생성

POST /api/open/v1/media/lip-sync/jobs
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: application/json

요구

{
  "videoUrl": "https://example.com/video.mp4",
  "audioUrl": "https://example.com/audio.mp3"
}

두 URL 모두 API 서비스로 연결할 수 있어야 합니다. 비공개 미디어에는 단기 서명 URL을 사용하고 작업자가 파일을 다운로드할 수 있을 만큼 오랫동안 유효한 상태를 유지하세요.

curl https://fishaudio.org/api/open/v1/media/lip-sync/jobs \
  -H "Authorization: Bearer FISHAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"videoUrl":"https://example.com/video.mp4","audioUrl":"https://example.com/audio.mp3"}'

응답

{
  "success": true,
  "message": "Job created",
  "data": {
    "id": "job_123",
    "status": "queued"
  }
}

사용자에게 표시되는 상태를 업데이트하기 전에 작업 ID를 유지하세요. 브라우저가 닫히더라도 백엔드는 여전히 최종 결과를 폴링하고 원본 프로젝트에 연결할 수 있어야 합니다.

채용정보 나열

GET /api/open/v1/media/lip-sync/jobs?page=1&limit=20&status=completed
Authorization: Bearer FISHAUDIO_API_KEY

지원되는 필터에는 page, limit 및 status가 포함됩니다. 고주파 폴링 루프가 아닌 백오피스 복구 및 프로젝트 기록을 위해 목록을 사용합니다.

취업

GET /api/open/v1/media/lip-sync/jobs/{jobId}
Authorization: Bearer FISHAUDIO_API_KEY

완료된 작업에는 data의 결과 메타데이터가 포함됩니다. 실패한 작업에는 오류 코드나 메시지가 포함됩니다. 반복적인 폴링으로 인해 기록 결과 레코드가 다시 작성되지 않도록 자체 데이터베이스에서 터미널 상태를 변경할 수 없도록 유지하세요.

청구 및 크레딧

립싱크 작업은 일반적으로 승인된 작업이나 완료된 처리 기간에 따라 비용이 청구됩니다. 제출하기 전에 비디오 길이와 오디오 길이를 확인하고 설문 조사 요청 시간이 초과되면 자동으로 두 번째 작업이 생성되지 않도록 하세요.

사용자가 많은 작업을 시작할 수 있는 경우 자체 대기열 및 동시성 제한을 적용하십시오. 값비싼 배치를 수락하기 전에 프로필을 사용하여 잔액 부족을 감지하세요.

오류

상태	의미	액션
`400`	잘못된 미디어 URL, 페이로드 또는 상태 필터	요청 수정
`401`	API 키가 잘못되었습니다	자격 증명 새로 고침
`402`	크레딧 또는 할당량이 부족합니다	대기열 일시 중지
`404`	이 API 키에 대한 작업 ID를 알 수 없습니다.	계정 및 저장된 아이디 확인
`422`	미디어에 연결할 수 있지만 처리할 수 없습니다	다양한 소스 미디어 요청

립싱크

이 페이지