AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu
Docs Home
/
AI 모델
Docs Home
/
AI 모델
Docs Home
/
AI 모델

모델 API 키

모델 API 키는 임베딩 및 리랭킹 API 에 대한 인증 및 권한 부여 메커니즘 제공 을 하며, 이를 통해 API 통해 Voyage AI 모델에 액세스 할 활성화 . 이 페이지에서는 Atlas UI 에서 API 키를 생성하고 관리 방법을 설명합니다.

참고

Atlas 의 다른 API 키와 구별하기 위해 모델 API 키 로 명명됩니다. 이 키는 다른 모델 제공자의 API 키와 동일한 방식으로 사용합니다.

모델 API 키 생성 및 관리

조직 및 프로젝트 수준의 Atlas UI 에서 모델 API 키를 만들고 관리 할 수 있습니다. 비율 제한 은 조직 또는 프로젝트 수준에서 생성했는지 여부에 따라 API 키에 적용.

필수 권한

모델 API 키를 생성, 업데이트 및 삭제 하려면 다음을 수행합니다.

모델 API 키를 보려면 다음을 수행합니다.

  • 조직 및 프로젝트 수준에서 Atlas 에 대한 Organization Read Only 이상의 액세스 있어야 합니다.

  • 프로젝트 수준에서만 Atlas 에 대한 Project Read Only 이상의 액세스 있어야 합니다.

각 역할에 대한 전체 권한 목록은 조직 및 프로젝트 액세스를 참조하세요.

API 키 생성

조직 수준에서 모델 API 키를 생성 하는 경우 키를 프로젝트에 연결합니다. 키를 생성한 후에는 키가 연결된 프로젝트 변경할 수 없습니다. 비율 제한은 프로젝트 의 각 키에 적용 .

참고

다음 절차에 설명된 대로 Atlas 통해 모델 API 키를 생성하는 경우 키는 https://ai.mongodb.com/v1/embeddings에 대한 요청만 인증합니다. 반대로VoyageAI를 통해 직접 키를 생성하면 https://api.voyageai.com/v1/embeddings에 대한 요청이 인증됩니다.

조직 수준에서 모델 API 키를 생성하려면 다음 단계를 완료하세요.

1

Atlas에 로그인합니다.

2

Atlas UI 에서 AI Models 페이지로 고 (Go) .

  1. 아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.

  2. 조직 수준에서 탐색 표시줄의 Services 헤더 아래에 있는 Model API Keys 을 클릭합니다.

3

모델 API 키를 생성합니다.

  1. Create new model API key를 클릭합니다.

  2. 키의 이름을 입력합니다.

    모델 API 키는 250 자를 초과할 수 없습니다.

  3. 드롭다운에서 프로젝트 선택하여 API 키와 연결합니다.

  4. Create를 클릭합니다.

4

API 키를 저장합니다.

  1. 모델 API 키를 복사하여 안전한 위치 에 저장 .

    키가 표시된 페이지를 벗어나면 다시 볼 수 없습니다. 분실한 경우 새로 생성합니다.

  2. Done를 클릭합니다.

프로젝트 수준에서 모델 API 키를 만들려면 다음 단계를 완료하세요.

1

Atlas에 로그인합니다.

2

Atlas UI 에서 AI Models 페이지로 고 (Go) .

  1. 아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 프로젝트 수준에서 탐색 표시줄의 Services 헤더 아래에 있는 AI Models 을 클릭합니다.

3

모델 API 키를 생성합니다.

  1. 아직 표시되지 않은 경우 탐색 모음에서 Model API Keys 을(를) 선택합니다.

  2. Create model API key를 클릭합니다.

  3. 키의 이름을 입력합니다.

    모델 API 키는 250 자를 초과할 수 없습니다.

  4. Create를 클릭합니다.

4

API 키를 저장합니다.

  1. 모델 API 키를 복사하여 안전한 위치 에 저장 .

    키가 표시된 페이지를 벗어나면 다시 볼 수 없습니다. 분실한 경우 새로 생성합니다.

  2. Done를 클릭합니다.

API 키 보기

조직 소유자는 조직 수준에서 조직의 모든 모델 API 키를 보고 편집 할 수 있습니다. 프로젝트 소유자는 액세스 있는 프로젝트의 모델 API 키만 보고 편집할 수 있습니다.

조직 수준에서 모델 API 키를 보려면 다음 단계를 완료하세요.

1

Atlas에 로그인합니다.

2

Atlas UI 에서 AI Models 페이지로 고 (Go) .

  1. 아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.

  2. 조직 수준에서 탐색 표시줄의 Services 헤더 아래에 있는 Model API Keys 을 클릭합니다.

각 모델 API 키에 대해 페이지에 다음이 표시됩니다.

열 이름
열 값 설명
Name
모델 API 키 이름입니다.

Secret Key

모델 API 키 이름과 연결된 수정된 모델 API 키.

Created On (UTC)

사용자가 모델 API 키를 만든 시점의 UTC 날짜.

Last Used (UTC)

모델 API 키가 마지막으로 사용된 UTC 시간의 날짜입니다. 키가 새로운 거나 사용된 적이 없는 경우 값은 Never 입니다.

Project

모델 API 키와 연결된 프로젝트 이름입니다.

Created By

키를 만든 사용자의 이름

Actions

키에 대해 수행할 수 있는 조치입니다. 다음을 클릭할 수 있습니다.

  • 모델 API 키를 편집합니다.

  • 모델 API 키를 삭제합니다.

프로젝트 수준에서 모델 API 키를 보려면 다음 단계를 완료하세요.

1

Atlas에 로그인합니다.

2

Atlas UI 에서 AI Models 페이지로 고 (Go) .

  1. 아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 프로젝트 수준에서 탐색 표시줄의 Services 헤더 아래에 있는 AI Models 을 클릭합니다.

각 모델 API 키에 대해 페이지에는 해당 키에 대한 다음 정보가 표시됩니다:

열 이름
열 값 설명
Name
모델 API 키 이름입니다.

Secret Key

모델 API 키 이름과 연결된 수정된 모델 API 키.

Created On (UTC)

사용자가 모델 API 키를 만든 시점의 UTC 날짜.

Last Used (UTC)

모델 API 키가 마지막으로 사용된 UTC 시간의 날짜입니다. 키가 새로운 거나 사용된 적이 없는 경우 값은 Never 입니다.

Project

모델 API 키와 연결된 프로젝트 이름입니다.

Created By

키를 만든 사용자의 이름

Actions

키에 대해 수행할 수 있는 조치입니다. 다음을 클릭할 수 있습니다.

  • 모델 API 키를 편집합니다.

  • 모델 API 키를 삭제합니다.

API 키 편집

조직 수준에서 모델 API 키를 편집하려면 다음 단계를 완료하세요.

1

Atlas에 로그인합니다.

2

Atlas UI 에서 AI Models 페이지로 고 (Go) .

  1. 아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.

  2. 조직 수준에서 탐색 표시줄의 Services 헤더 아래에 있는 Model API Keys 을 클릭합니다.

3

키를 편집합니다.

  1. Actions 열에서 편집하려는 키에 해당하는 를 클릭합니다.

  2. Edit Model API Key 페이지에서 모델 API 키의 이름을 수정합니다.

    모델 API 키 이름은 프로젝트 에서 고유해야 하며 최대 250 자까지 가능합니다.

  3. Save를 클릭하여 변경 사항을 적용하세요.

프로젝트 수준에서 모델 API 키를 편집하려면 다음 단계를 완료하세요.

1

Atlas에 로그인합니다.

2

Atlas UI 에서 AI Models 페이지로 고 (Go) .

  1. 아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 프로젝트 수준에서 탐색 표시줄의 Services 헤더 아래에 있는 AI Models 을 클릭합니다.

3

키를 편집합니다.

  1. Actions 열에서 편집하려는 키에 해당하는 를 클릭합니다.

  2. Edit Model API Key 페이지에서 모델 API 키의 이름을 수정합니다.

    이름은 프로젝트 에서 고유해야 하며 최대 250 자까지 가능합니다.

  3. Save를 클릭하여 변경 사항을 적용하세요.

API 키 삭제

When you 모델 API 키를 삭제 하면 MongoDB 즉시 키를 비활성화하고 삭제된 키를 사용하여 이루어진 모든 API 요청을 거부합니다. 키를 삭제 하면 보거나 복원 하거나 수정할 수 없습니다.

조직 수준에서 모델 API 키를 삭제 하려면 다음 단계를 완료하세요.

1

Atlas에 로그인합니다.

2

Atlas UI 에서 AI Models 페이지로 고 (Go) .

  1. 아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.

  2. 조직 수준에서 탐색 표시줄의 Services 헤더 아래에 있는 Model API Keys 을 클릭합니다.

3

키를 삭제합니다.

  1. Actions 열에서 삭제 하려는 키에 해당하는 을(를) 클릭합니다.

  2. 확인 모달에서 Delete key 을 클릭하여 키를 삭제 .

프로젝트 수준에서 모델 API 키를 삭제 하려면 다음 단계를 완료하세요.

1

Atlas에 로그인합니다.

2

Atlas UI 에서 AI Models 페이지로 고 (Go) .

  1. 아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 프로젝트 수준에서 탐색 표시줄의 Services 헤더 아래에 있는 AI Models 을 클릭합니다.

3

키를 삭제합니다.

  1. Actions 열에서 삭제 하려는 키에 해당하는 을(를) 클릭합니다.

  2. 확인 모달에서 Delete key 을 클릭하여 키를 삭제 .

다음 단계

모델 API 키를 만든 후에는 다음을 수행할 수 있습니다.

다음

조직 및 프로젝트 액세스

이 페이지의 내용