워크스페이스워크스페이스감사 로그

API 키 업데이트

서비스 계정의 기존 API 키를 업데이트합니다

경로 매개변수

service_account_user_idstring필수
api_key_idstring필수

헤더

xi-api-keystring선택 사항

요청

This endpoint expects an object.
is_enabledboolean or "no_update"선택 사항기본값 no_update

API 키를 활성화 또는 비활성화할지 여부입니다.

namestring or null선택 사항

사용할 XI API 키 이름입니다(식별 용도로만 사용).

permissionslist of enums or enum선택 사항기본값 no_update

XI API의 권한입니다.

character_limitinteger or enum or null선택 사항기본값 no_update

XI API 키의 문자 제한입니다. 제공하면 이 API 키의 사용량이 선택한 값 n에 따라 월 n자로 제한됩니다. 이 월간 한도에 도달하면 요금이 발생하는 요청은 실패합니다.

allowed_ipslist of strings or enum선택 사항기본값 no_update

이 API 키 사용이 허용된 IP 주소 또는 CIDR 범위 목록입니다. 각 항목은 CIDR 범위(예: ‘10.0.0.0/24’) 또는 IP 주소 자체(/32 또는 /128로 정규화됨)일 수 있습니다. 생성 시 생략하거나 null을 전달하면 모든 IP가 허용됩니다. 업데이트 시 생략하면 허용 목록이 변경되지 않으며, 제거하려면 “clear”를 전달하세요.

third_party_disable_allowedboolean or enum선택 사항기본값 no_update

이 키의 보유자가 자체 비활성화 엔드포인트를 통해 키를 비활성화할 수 있는지 여부입니다. 생성 시 생략하거나 null을 전달하면 워크스페이스 기본값을 사용합니다(엔터프라이즈 외 요금제에서는 활성화되고 엔터프라이즈 요금제에서는 비활성화됨). 업데이트 시 변경하지 않으려면 생략하고, 워크스페이스 기본값으로 재설정하려면 “clear”를 전달하세요. 자체 비활성화 액세스가 활성화된 워크스페이스에서만 적용됩니다.

tts_concurrency_limitinteger or enum or null선택 사항기본값 no_update

이 API 키의 최대 동시 텍스트 음성 변환/음성 변환 요청 수입니다. 엔터프라이즈 고객만 사용할 수 있습니다.

dubbing_concurrency_limitinteger or enum or null선택 사항기본값 no_update

이 API 키의 최대 동시 더빙 요청 수입니다. 엔터프라이즈 고객만 사용할 수 있습니다.

music_concurrency_limitinteger or enum or null선택 사항기본값 no_update

이 API 키의 최대 동시 음악 생성 요청 수입니다. 엔터프라이즈 고객만 사용할 수 있습니다.

응답

성공 응답

오류

422
Unprocessable Entity Error