API 참조

음성 복제 작업 생성

POST/v1/audio-clone/tasks

일반 TokenAuth를 사용합니다. 영구 보관 이미지/동영상의 완화된 인증과 달리 할당량이 소진되면 조회도 거부될 수 있습니다. 생성 기본값은 audio-clone-v1이며 백그라운드 폴링을 사용합니다. 결과가 불명확한 제출을 무조건 재전송하지 마세요.

복제 작업의 복구 범위

복제 생성과 후속 조회는 일반 인증을 사용합니다. 충분한 할당량을 확보하고 원래 API 키를 보관하세요. 이미지/동영상이 허용한다는 이유로 복제도 할당량이 소진된 키의 조회를 허용한다고 가정하지 마세요.

복제에는 영구 보관 이미지와 동등한 요청 키 복구 엔드포인트가 없습니다. 네트워크 시간 초과 후 진단 정보와 알려진 작업 정보를 보존하고 진행 전에 작업을 조사하세요. 무조건 다시 제출하지 마세요. 실행 성공과 결과 저장 상태도 별도로 판단하세요.

인증과 권한

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

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

요청 헤더

Idempotency-Keystring선택 사항
최대 길이
191
패턴
"^[\\x20-\\x7E]{0,191}$"

요청 본문 · application/json

유형: object
필수 필드: textreference_audio_urlreference_text

요청 본문 필수

modelstring선택 사항
현재 키의 카탈로그에 있는 공개 모델 ID입니다.

기본값
"audio-clone-v1"
열거형
["audio-clone-v1"]
textstring필수
합성할 텍스트입니다.

최소 길이
1
최대 길이
5000
reference_audio_urlstring필수
공개 HTTPS 참조 오디오 URL입니다. 사용자 정보는 금지되며 SSRF 검사가 적용됩니다.
reference_textstring필수
참조 오디오에 해당하는 텍스트입니다.

최소 길이
1
최대 길이
5000
remove_silenceboolean선택 사항null 허용
무음 제거 여부이며 생략하면 true입니다.

기본값
true

응답과 오류

HTTP 202

작업이 접수되었으며 완료를 뜻하지는 않습니다.

application/json

유형: object
필수 필드: idstatuscreated_at

idstring필수
statusstring필수
열거형
["queued"]
created_atinteger필수
형식
"int64"

HTTP 400

요청 매개변수가 유효하지 않습니다.

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 401

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

application/json

유형: object
필수 필드: error

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

HTTP 402

계정 또는 키의 사용 가능한 할당량이 부족합니다.

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 403

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

application/json

유형: object
필수 필드: error

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

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