Blog

Cohere API 사용 방법

Young-jae

Young-jae

14 July 2025

Cohere API 사용 방법

Cohere는 개발자에게 인간과 유사한 텍스트를 이해하고 생성할 수 있는 정교한 대형 언어 모델(LLM)에 대한 접근을 제공합니다. 이 모델과 프로그래밍 방식으로 상호작용하기 위해서는 API 키가 필요합니다. 이 키는 고유한 식별자 및 비밀번호 역할을 하여 Cohere의 시스템이 귀하의 요청을 인증하고 사용량을 추적할 수 있도록 합니다.

이 가이드는 API 키를 획득하는 방법, 키 유형 간의 주요 차이점(특히 비용과 사용 제한에 관한 사항)을 이해하고, 귀하의 키가 제대로 작동하는지 확인하기 위해 Apidog 도구를 사용하여 간단한 초기 테스트를 수행하는 필수 단계를 안내합니다.

1단계: Cohere API 키 획득하기

키를 얻는 것은 첫 번째이자 가장 중요한 단계입니다. Cohere는 온라인 대시보드를 통해 이 과정을 비교적 간단하게 만들어줍니다.

  1. Cohere 대시보드로 이동: 웹 브라우저를 열고 Cohere 플랫폼의 주요 접근 지점으로 가십시오. 일반적으로 로그인 또는 가입 페이지를 찾을 수 있습니다.
  2. 계정에 접근하기:

API 키 섹션 찾기: Cohere 대시보드에 성공적으로 로그인하면 API 키 관리를 위한 특별한 섹션을 찾아보십시오. 이는 계정 설정, 개발자 섹션 아래에 있거나 "API 키"라는 메뉴 항목을 통해 직접 접근할 수 있을 것입니다. 인터페이스는 사용자 친화적으로 설계되어 있어 눈에 잘 띌 것입니다.

키 생성 시작하기: API 키 섹션 내에서 새로운 키를 생성할 수 있는 옵션을 찾을 수 있습니다. 키 유형을 구분하는 선택지가 보일 것이며, 특히 "체험 키"와 "프로덕션 키"가 있습니다. 초기 테스트와 학습을 위해 체험 키 생성 옵션을 선택하십시오.

이름 지정하기: 키 이름을 지정하라는 프롬프트가 나타납니다. 나중에 용도를 기억하는 데 도움이 될 수 있도록 설명적인 이름을 선택하십시오. 예를 들어 "MyFirstTestKey", "LearningProjectKey", 또는 "ApidogTestingKey"와 같이 이름을 붙일 수 있습니다.

키 생성 및 보안: 키를 생성하기 위해 버튼을 클릭하십시오 (예: "체험 키 생성"). Cohere는 새로 생성된 API 키를 표시할 것입니다. 이것이 전체 키가 표시되는 유일한 시간입니다. 이 키를 즉시 복사하고 비밀번호 관리자 또는 안전한 메모와 같은 매우 안전한 위치에 저장하는 것이 절대적으로 필수적입니다. 비밀번호와 동일한 수준의 보안으로 취급하십시오. 공개적으로 공유하지 않거나 클라이언트 측 코드에 직접 포함시키거나 Git과 같은 버전 관리 시스템에 커밋하지 마십시오. 팝업 창을 닫거나 다른 페이지로 이동하면 보안상의 이유로 전체 키를 다시 검색할 수 없습니다 (대시보드에서 키의 이름과 그 첫 문자/마지막 몇 개 문자만 볼 수 있습니다). 만약 이를 잃어버리면 새로 생성해야 합니다.

API 키가 복사되고 안전하게 저장되면 이 키로 무엇을 할 수 있는지 및 관련 규칙을 이해할 준비가 된 것입니다.

2단계: 키 유형, 비용 및 사용 제한 이해하기

모든 Cohere API 키가 동일하게 만들어진 것은 아닙니다. 귀하가 보유한 키 유형에 따라 API 사용량, 속도 및 비용 발생 여부가 결정됩니다. 이러한 차이를 이해하는 것은 예상치 못한 중단이나 요금을 피하는 데 중요합니다.

A. 체험 API 키: 평가를 위한 무료 키

처음 가입하거나 청구 설정 없이 키를 생성할 때, 일반적으로 체험 키를 받게 됩니다. 이는 탐색, 학습 및 소규모 테스트를 위해 설계되었습니다.

체험 키는 다음과 같은 목적에 이상적입니다:

한 달 한도에 계속해서 도달하거나 분당 속도 제한을 초과하는 경우, 프로덕션 키로 업그레이드해야 한다는 강력한 신호입니다.

B. 프로덕션 API 키: 구축 및 확장을 위한 키

실제 사용자와 응용 프로그램을 구축할 준비가 되었거나 더 큰 작업 부하를 처리해야 하거나 체험 제한을 넘어설 필요가 있을 때, 프로덕션 키가 필요합니다. 이를 위해서는 Cohere 계정에 결제 정보를 설정해야 합니다.

프로덕션 키는 다음과 같은 용도로 필요합니다:

C. 적절한 키 선택:

좋습니다, 이제 curl 명령을 사용하여 Apidog에서 제공되는 스트리밍 채팅 요청을 테스트하는 데 중점을 두어 수정된 3단계 섹션이 있습니다:

3단계: Apidog를 이용한 스트리밍 채팅을 위한 기본 API 테스트 호출 수행

특히 스트리밍 응답을 위한 복잡한 코드에 API를 통합하기 전에 직접 테스트를 수행하는 것이 유용합니다. Apidog를 사용하여 curl 명령 구조를 복제하여 귀하의 키를 검증하고 스트리밍에 대한 기본 요청/응답 흐름을 이해할 수 있습니다.

  1. Apidog 실행: 컴퓨터에서 Apidog 애플리케이션을 엽니다.
  2. 새 요청 만들기: '+' 버튼 또는 이에 상응하는 버튼을 클릭하여 새 API 요청을 만듭니다. "Cohere Streaming Chat Test"와 같이 설명적인 이름으로 지정하십시오.
  3. 엔드포인트 구성:

4. 헤더 설정:

5. 요청 본문 구성하기 (스트리밍 활성화):

{
  "stream": true,
  "model": "command-r",
  "messages": [
    {
      "role": "user",
      "content": "Hello world!"
    }
  ]
}

(참고: curl 예시는 "role": "user" (소문자)와 모델 "command-a-03-2025"를 사용했습니다. 연속성을 위해 "role": "USER" 및 모델 "command-r"을 유지했지만, 위 JSON에서 테스트할 특정 요청에 맞게 모델 및 역할의 대소문자를 조정해야 합니다.)

6. 요청 실행: Apidog에서 "Send" 버튼을 클릭하십시오.

7. 응답 분석 (스트리밍 세부사항):

이 테스트는 API가 귀하의 스트리밍 요청을 수락하고 귀하의 키가 이 유형의 상호작용에 유효함을 확인하는 데 도움이 됩니다. Apidog 자체가 스트림의 실시간 특성을 시각화하는 데 적합한 도구는 아니지만, 기본 요청 설정이 올바르다는 것을 검증합니다.

결론

이제 Cohere API 키를 보유하고 있으며, 체험 키와 프로덕션 키 간의 중요한 차이점, 특히 체험 키의 월 1,000 호출 한도와 분당 속도 제한과 프로덕션 키의 사용한 만큼 지불하는 토큰 기반 가격 및 더 높은 한도에 대해 이해하고 있습니다. 귀하는 또한 키 작동을 확인하고 간단한 API 호출 구조를 이해하기 위해 Apidog를 사용하여 기본적인 하지만 중요한 테스트를 수행했습니다.

이 기초는 Cohere API와 효과적으로 상호작용하는 데 필수적입니다. 귀하의 키를 안전하게 유지하고, 사용량을 제한(특히 체험 키의 경우)과 비교하여 모니터링하며, 더 정교한 애플리케이션을 구축하기 시작할 때 특정 모델, 고급 매개변수 및 SDK 사용에 관한 자세한 정보는 Cohere의 문서를 참조하는 것을 잊지 마십시오.

Apidog에서 API 설계-첫 번째 연습

API를 더 쉽게 구축하고 사용하는 방법을 발견하세요

무료 회원가입다운로드