인증
Studio에서 Direct API 키를 만들고, 범위와 크레딧 한도를 정한 다음, 모든 요청에 키를 포함해 보냅니다.
모든 요청에는 조직 API 키가 베어러 토큰으로 포함됩니다.
Authorization: Bearer mor_live_9f2c…키는 키를 만든 사람이 아니라 조직에 속합니다. 조직의 모든 관리자가 키를 보고 폐기할 수 있으며, 키를 만든 사람이 팀을 떠나도 계속 작동합니다. 키는 폐기되었을 때, 만료되었을 때, 만든 사람의 계정이 정지되었을 때, 또는 Morphic이 조직의 Direct API를 비활성화했을 때 작동을 멈춥니다.
키 만들기
Direct API 범위는 Morphic이 조직의 Direct API를 활성화한 후에만 표시됩니다. 액세스 받기를 참조하세요.
- Morphic Studio에서 조직 드롭다운(왼쪽 상단의 Morphic 로고)을 열고 '설정'을 선택합니다.
- 왼쪽 사이드바에서 'API 키'를 클릭합니다. 이 탭은 관리자에게만 표시됩니다.
- '새 키'를 클릭합니다.
- '이름'을 입력하고, 키에 필요한 '범위'를 선택한 다음, 영구적으로 사용할 키가 아니라면 '만료' 시점을 정합니다.
- '크레딧 한도'에서 키가 사용할 수 있는 총액을 설정하고, 필요하면 일일 한도와 월간 한도도 설정합니다.
- 'Morphic 이용약관(개발자 API 섹션 포함)에 동의합니다'에 체크합니다. 이로써 조직을 대표하여 이용약관에 동의하게 됩니다.
- '키 만들기'를 클릭한 다음, 비밀값을 비밀 관리자에 복사해 두세요. 비밀값은 한 번만 표시됩니다.
비밀값을 가진 사람은 누구든 키의 한도까지 조직의 크레딧을 사용할 수 있습니다. 키를 브라우저, 모바일 앱, 공개 저장소에 절대 넣지 마세요.
키 형식
mor_live_<64 hex characters>접두사를 보면 사용자와 비밀 스캐너가 이 키가 어느 배포 환경용인지 알 수 있습니다.
범위
키는 범위가 허용하는 도구에만 접근할 수 있습니다. 가장 좁은 범위를 선택하세요.
| 범위 | Studio 표시 이름 | 허용 항목 |
|---|---|---|
projects:read | 프로젝트와 파일 읽기 | 프로젝트, 워크플로, Compose 타임라인 목록 조회 |
assets:read | 에셋 검색 및 읽기 | 라이브러리 목록 조회, 생성 작업과 상태 읽기, 캐릭터 |
assets:write | 에셋 업로드 및 편집 | URL로 미디어 전달, Compose 타임라인 만들기 |
generations:write | 이미지, 동영상, 오디오 생성 (크레딧 사용) | 미디어를 생성, 편집, 분석하는 모든 도구 |
키의 범위 밖에 있는 도구를 호출하면 403 insufficient_scope로 응답하며, 누락된 범위를 data.required_scopes에 표시합니다. list_voices와 /me처럼 범위가 필요 없는 엔드포인트와 도구는 모든 키에 열려 있습니다. 각 도구에 필요한 범위는 도구 카탈로그에 나와 있습니다.
크레딧 한도
모든 키에는 생성할 때 설정한 사용 한도가 있습니다. 관리자는 나중에 '한도 편집'으로 이를 변경할 수 있습니다.
| 한도 | 필수 | 기간 |
|---|---|---|
total_credit_limit | 예 | 키의 전체 수명 |
monthly_credit_limit | 아니요 | 달력 기준 월, UTC |
daily_credit_limit | 아니요 | 달력 기준 일, UTC |
- 키의 한도를 하나라도 넘게 되는 유료 호출은 아무것도 시작하기 전에
402 api_key_credit_limit_reached로 거부되며, 어느 한도인지는data.period에 표시됩니다. - 조직 자체의 잔액도 함께 적용됩니다. 잔액으로 지불할 수 없는 호출은
402 insufficient_credits로 거부됩니다. GET /v1/direct/me는 키의 한도와 현재 사용량을 반환합니다. 크레딧과 사용량을 참조하세요.
키 교체
- 새 키를 만듭니다.
- 새 키를 배포합니다.
- '키 폐기'로 이전 키를 폐기합니다.
조직은 활성 키를 최대 10개까지 보유할 수 있으므로, 교체하는 동안 공백이 생기지 않습니다.
문제가 있거나 궁금한 점이 있으면 언제든지 연락해 주세요. 기꺼이 도와드리겠습니다. 다음 주소로 이메일을 보내 주세요: support@morphic.com.