API 참조

음성 복제 결과 조회

GET/v1/audio-clone/tasks/{task_id}/result

백그라운드 완료 후 조회하세요. 결과 보관 상태는 성공과 독립적입니다. 실패는 422를, 준비되지 않았거나 불명확한 상태는 409를 반환합니다.

인증과 권한

현재 GloopAPI 키를 사용하세요. 사용 가능한 모델, 기능과 권한은 해당 카탈로그와 엔드포인트 문서에 따라 달라집니다.

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

경로 매개변수

task_idstring필수
동일 키로 생성한 작업의 공개 ID입니다.

응답과 오류

HTTP 200

요청에 성공했습니다.

application/json

유형: object
필수 필드: idstatusresultusage

idstring필수
statusstring필수
열거형
["succeeded"]
resultobject필수
result 하위 필드(6)
- file_idstring선택 사항
  동일 계정/키의 관리형 파일 공개 ID입니다.
- storage_statusstring선택 사항
  파일 보관 상태이며 관리형 다운로드는 ready 이후에만 보장됩니다.
- audio_urlstring필수
  생성된 오디오의 접근 URL입니다. 관리형인 경우 저장 계층이 서명 URL을 제공합니다.
- content_typestring선택 사항
  결과 MIME 유형입니다.
- file_namestring선택 사항
  공개 다운로드 파일명입니다.
- file_sizeinteger선택 사항
  바이트 단위 결과 파일 크기입니다.
usageobject필수
usage 하위 필드(1)
- charactersinteger필수
  최솟값
  0

HTTP 401

키가 없거나 유효하지 않거나 만료 또는 폐기되었습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 403

IP, 계정, 모델 또는 도구 권한이 부족합니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 404

객체 또는 기능을 사용할 수 없습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(3)
- messagestring필수
- typestring필수
  열거형
  ["new_api_error"]
- codestring필수
  열거형
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 409

요청 충돌, 준비되지 않음 또는 제출 결과 불명확입니다. 먼저 원래 기록을 조회하고 무조건 재전송하지 마세요.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(3)
- messagestring필수
- typestring필수
  열거형
  ["new_api_error"]
- codestring필수
  열거형
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 422

생성에 실패했습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(3)
- messagestring필수
- typestring필수
  열거형
  ["new_api_error"]
- codestring필수
  열거형
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 429

요청/대기열 속도 제한입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 500

내부 인증 또는 데이터 저장 오류입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 502

서비스 응답 오류입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(3)
- messagestring필수
- typestring필수
  열거형
  ["new_api_error"]
- codestring필수
  열거형
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]

HTTP 503

서비스, 스토리지, 가격을 일시적으로 사용할 수 없습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(3)
- messagestring필수
- typestring필수
  열거형
  ["new_api_error"]
- codestring필수
  열거형
  ["invalid_request","invalid_reference_audio_url","text_too_long","idempotency_conflict","insufficient_quota","task_not_found","task_not_ready","task_failed","submission_state_unknown","upstream_unavailable","upstream_protocol_error"]