API 참조

음성 복제 작업 취소 요청

POST/v1/audio-clone/tasks/{task_id}/cancel

취소를 요청하지만 취소나 환불을 보장하지는 않습니다. 동일 키의 일반 인증을 사용합니다.

인증과 권한

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

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

경로 매개변수

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

응답과 오류

HTTP 200

요청에 성공했습니다.

application/json

유형: object
필수 필드: idcancel_requested

idstring필수
cancel_requestedboolean필수
열거형
[true]

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 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"]