API Key 수정

프로필에서 만든 액세스 토큰을 사용하며 관리 대상 모델 API Key는 사용하지 않습니다. 자격 증명과 전체 절차는 프로그래밍 방식의 API Key 관리를 참조하세요.

할당량 환산: remain_quota = 금액 * 500000. expired_time=-1은 무기한이며 remain_quota=-1, unlimited_quota=true는 무제한입니다.

일반 수정은 생략 필드를 초기화할 수 있습니다. 상세를 먼저 읽고 만료, 할당량 등 유지할 설정을 보존한 뒤 보내세요.

설정과 상태 수정은 같은 endpoint를 사용합니다. 상태만 수정 시 status_only=true를 지정하고 id, status만 보냅니다. 예제와 마찬가지로 Try It에서도 쿼리를 명시하세요.

PUT/api/token/

설정이나 상태를 수정합니다. 일반 수정은 생략 필드를 초기화할 수 있으므로 상세를 읽고 필요한 설정을 유지하세요. 상태만 수정 시 status_only=true와 id/status를 보냅니다.

인증

userAccessToken

인증Bearer <token>

프로필의 보안 영역에서 액세스 토큰을 생성하여 Bearer 인증에 사용하세요. 모델 API Key는 사용하지 마세요.

전달 위치: header

쿼리 매개변수

status_only?boolean

상태만 수정할지 여부.

요청 본문

application/json

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

일반 수정은 생략 설정을 초기화할 수 있습니다. 상세를 먼저 읽고 유지할 설정을 모두 보내세요. 상태만 수정 시 status_only=true입니다.

name?string

토큰 이름.

expired_time?integer

초 단위 Unix 만료 시간. -1은 무기한입니다.

remain_quota?integer

잔여 할당량: remain_quota = 금액 * 500000. -1과 unlimited_quota=true는 무제한입니다.

unlimited_quota?boolean

무제한 할당량 여부.

model_limits_enabled?boolean

모델 제한 활성화 여부.

model_limits?string

허용 모델 ID를 쉼표로 구분하세요. 배열을 보내지 마세요.

allow_ips?string

쉼표로 구분한 허용 IP.

group?string

소속 그룹.

id*integer

Token ID, 필수.

status?integer

상태만 수정할 때 새 상태. 예: 1.

응답 본문

`application/json`

curl -X PUT "https://example.com/api/token/" \
  -H "Authorization: Bearer your-user-token" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 123,
    "name": "Updated Token",
    "expired_time": -1,
    "remain_quota": 2000000,
    "unlimited_quota": false,
    "model_limits_enabled": true,
    "model_limits": "MODEL_ID",
    "allow_ips": "192.168.1.1",
    "group": "vip"
  }'

{
  "success": true,
  "message": "",
  "data": {
    "id": 123,
    "name": "Updated API Key",
    "key": "sk-****example",
    "status": 1,
    "remain_quota": 0,
    "unlimited_quota": false,
    "expired_time": 1792598400,
    "created_time": 1792512000,
    "accessed_time": 0,
    "model_limits_enabled": false,
    "model_limits": "",
    "allow_ips": "",
    "used_quota": 0,
    "group": "",
    "quota_reset_period": "",
    "quota_reset_amount": 0,
    "quota_reset_timezone": "",
    "quota_reset_time": "",
    "quota_reset_weekday": 0,
    "next_quota_reset_at": 0,
    "last_quota_reset_at": 0,
    "quota_reset_version": 0,
    "model_route_enabled": false,
    "model_route_char": "",
    "strong_affinity_enabled": false,
    "auto_groups": null,
    "DeletedAt": null
  }
}

인증

쿼리 매개변수

요청 본문

응답 본문

200application/json

401application/json

`application/json`

`application/json`