API 키
조직의 API 키를 만들고, 확인하고, 폐기합니다. Direct API와 파트너 API에 모두 사용할 수 있습니다.
API 키를 사용하면 아무도 Morphic을 열지 않아도 다른 시스템이 Morphic을 사용할 수 있습니다. 파트너 API로 워크플로를 시작하거나, Direct API로 미디어를 생성하고 편집할 수 있습니다. 'API 키' 탭은 관리자에게만 표시됩니다.
바로 이동: studio.morphic.com/settings/api-keys

키는 조직에 속합니다
키를 만든 사람이 아니라 조직에 속합니다. 그 사람이 떠나도 계속 작동하며, 모든 관리자는 목록에서 이를 보고 취소할 수 있고, 이 키로 시작된 모든 실행은 조직에 청구됩니다.
키 만들기
범위를 선택하세요
키에 필요한 것만 고르세요. 처음 세 가지는 파트너 API용이고, 나머지는 Direct API용입니다. Direct API용 범위는 Morphic이 조직에서 Direct API를 켠 뒤에 나타납니다.
workflows:read: 워크플로와 그 입력을 읽기runs:write: 실행을 시작하고 웹훅 엔드포인트를 등록하기runs:read: 실행 상태와 완료된 자산을 읽고 웹훅 엔드포인트를 나열하기projects:read: 프로젝트와 그 파일을 읽기assets:read: 자산을 찾고 읽기assets:write: 자산을 업로드하고 편집하기generations:write: 이미지, 비디오, 오디오를 생성하기(크레딧이 사용됩니다)
그런 다음 개발자 API 섹션을 포함한 Morphic 이용약관에 동의하는 확인란을 체크하세요.
특정 워크플로로 제한하기
선택 사항이지만 해둘 가치가 있습니다. '이 키를 특정 워크플로로 제한'을 체크한 다음 워크플로를 선택하세요. 그 외의 작업은 실행이 거부되므로, 키가 유출되더라도 피해를 제한할 수 있습니다. 체크하지 않으면 이 키는 조직이 실행할 수 있는 모든 워크플로를 실행할 수 있습니다.

크레딧 한도를 설정하세요
'이 키가 사용할 수 있는 총 크레딧'을 설정하거나 '총 한도 없음(무제한)'을 선택하세요. 일별 및 월별 상한은 선택 사항이며, 해당 기간에 한도를 두지 않으려면 비워 두세요.
총 한도를 설정해 두는 것이 좋습니다. 통합이 다시 확인되기 전까지 지출할 수 있어야 하는 금액을 기준으로 정하세요. 실제로 쓸 금액이 아니라 차단 장치이기 때문입니다. 기간별 한도는 총 한도보다 높을 수 없습니다. 총 한도가 먼저 적용되기 때문입니다.
키로 시작된 실행의 크레딧은 조직에 청구되며 해당 키의 한도에 포함됩니다. 나중에 누군가 채팅에 들어와 이어받더라도, 키가 시작한 실행은 계속 그 키에 대해 차감됩니다. 그렇지 않으면 동료가 질문 하나를 답한 것만으로 나머지 실행 비용이 조직의 일반 풀로 넘어가게 됩니다. 그 사람에게 자신의 크레딧 한도가 있다면 그것도 여전히 적용됩니다.
하루는 UTC 기준 하루이고, 한 달은 UTC 기준 달력 월입니다. 키의 한도를 초과하게 되는 청구는 거부되며, 메시지에는 키와 도달한 한도가 표시됩니다.
만료 기간을 선택하세요
없음, 30일, 90일 또는 1년. 만료된 키는 자동으로 인증이 중단되며, 이는 가장 저렴한 순환 방식입니다.
비밀값 복사
비밀 값은 한 번만 표시됩니다. Morphic는 해당 값의 해시만 보관하므로 다시 표시할 수 없습니다. 대화 상자를 닫기 전에 비밀 관리자에 복사하세요.
키를 가진 사람은 누구나 조직의 크레딧을 사용하는 실행을 시작할 수 있습니다. 절대 커밋하지 말고, 브라우저에 넣지 말고, 이메일이나 채팅으로 보내지 마세요. 유출되면 폐기하세요.
목록에 표시되는 항목
각 키에는 이름, 실사용 키인지 테스트 키인지 여부, 비밀 값의 앞부분(자신의 기록과 대조하기에 충분한 정도), 범위, 실행할 수 있는 워크플로 수, 크레딧 한도, 마지막 사용 시점이 표시됩니다. 만료되었거나 취소된 키도 목록에 남아 있으므로 어떤 일이 있었는지 확인할 수 있습니다.
조직은 인증에 사용할 수 있는 키를 최대 10개까지 한 번에 보유할 수 있습니다. 만료되었거나 폐기된 키는 이에 포함되지 않습니다.
키의 크레딧 한도를 변경하기
- 목록에서 키를 찾으세요.
- 옆의 '…' 메뉴를 클릭하고 '한도 편집'을 선택하세요.
- 총 한도, 일별 또는 월별 한도를 변경하고 저장하세요. 한도를 없애려면 비워 두세요.
새 한도는 키의 다음 청구 시점부터 적용되며, 이미 시작된 실행에도 적용됩니다. 따라서 실행이 키의 한도에서 멈췄을 때 이 방법으로 수정할 수 있으며, 취소된 키에도 적용됩니다. 해당 키의 실행은 여전히 그 키에 대해 차감되므로, 한도를 낮추는 것이 이를 멈추는 방법입니다.
키 취소하기
- 목록에서 키를 찾으세요.
- 옆의 '…' 메뉴를 클릭하고 '키 폐기'를 선택하세요.
- 확인하세요.
이를 사용한 호출은 몇 초 내로 실패하기 시작합니다. 이미 진행 중인 실행은 완료되며, 그에 대한 청구는 계속됩니다. 폐기는 되돌릴 수 없습니다. 키를 교체하려면 먼저 대체 키를 만들고, 트래픽을 새 키로 옮긴 다음, 이전 키를 폐기하세요.
비용이 표시되는 위치
API로 사용한 크레딧은 조직에 청구되며, 그 크레딧을 사용한 키에 귀속됩니다. 크레딧 사용량에서 API 사용량은 멤버 한 명처럼 'API'로 표시되고, 이름이 있는 키의 사용은 'API · '와 키 이름으로 표시됩니다.
- '개요'에서 'API를 키별로 보기'를 켜면 API 사용량을 키별로 나누어 볼 수 있습니다.
- 회원이 아닌
user_email로 시작한 파트너 API 실행은 '사용 내역'에서 해당 이메일 아래에 표시되므로, 자체 사용자가 각각 얼마나 썼는지 확인할 수 있습니다.user_email이 멤버의 이메일인 실행은 그 멤버의 사용량입니다. 워크플로 실행 시작을 참고하세요.
문제가 있거나 궁금한 점이 있으면 언제든지 연락해 주세요. 기꺼이 도와드리겠습니다. 다음 주소로 이메일을 보내 주세요: support@morphic.com.

