메인 콘텐츠로 건너뛰기

​
개요

이 엔드포인트는 현재 관리 토큰에 연결된 조직 안에 새로운 type=user API 키를 생성합니다.

​
요청 본문

필드타입기본값 / 제한설명
namestring필수, 기본값 Default Key, 길이 1-50표시 이름. 서버에서 앞뒤 공백을 제거합니다
limitAmountnumber | null최소 0, 최대 100000null 또는 생략 = 무제한, 0 = 사용 가능 한도 0, 양수 = USD 사용 한도
limitCurrencyenum기본값 USD선택 사항: USD 또는 CNY. CNY로 설정하면 limitAmount를 RMB로 해석하고 저장 전에 서버에서 USD로 환산합니다
modelsstring[]기본값 []선택적 논리 모델 허용 목록
expiresAtstring | nullRFC3339 datetimenull 은 만료 없음 의미

​
참고 사항

  • 전체 API 키 값은 응답에서 한 번만 표시됩니다.
  • models: [] 는 조직 정책 외에 추가 모델 제한이 없음을 의미합니다.
  • limitAmount: 0 은 유효하지만 사용할 수 있는 한도가 없는 키를 만들며, 이후 업데이트가 필요합니다.
  • 기본적으로 limitAmount는 USD로 해석됩니다. limitCurrency: "CNY"를 보내면 한도가 RMB로 처리되고, 현재 환율로 자동 환산된 USD 값이 저장됩니다.
  • 응답에는 exchange_rate와 RMB 표시 필드인 limit_amount_cny, used_amount_cny가 함께 포함됩니다.

​
예시

curl -X POST "https://api.lemondata.cc/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Backend Worker",
    "limitAmount": 500,
    "models": ["veo3.1", "sora-2"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

​
요청 / 응답

정확한 스키마와 응답 필드는 상단의 인터랙티브 OpenAPI 패널을 참고하세요.