v1에서 v2로 마이그레이션하기
v1에서 v2로 마이그레이션하기
이 페이지는 Cohere의 v1과 v2 API 사이의 마이그레이션 세부 사항을 설명해요. v2 API의 변경 사항과 메시지 기반 형식, 도구 호출의 구조화된 출력 등을 함께 살펴볼게요.
출처: 문서
본문
이 페이지는 v2 API에 대한 자세한 개요와 v1에서 v2로 마이그레이션하는 데 필요한 사항을 제공해요.
v2 API 이해하기 (Understanding the v2 API)
v2 API는 API와의 상호 작용 모델에 여러 가지 변경 사항을 도입해요. 여기에는 메시지 기반 형식의 도입, 도구 호출에 대한 구조화된 출력, 기타 API 개선이 포함돼요.
메시지 기반 채팅 API (Message-based chat API)
v2 채팅 API는 다운스트림 시스템과 더 호환되는 메시지 기반 형식을 채택해요. 일관성을 가져다 주죠: v1 chat은 텍스트 입력-텍스트 출력이었지만, v2 chat은 메시지 배열을 받아요. 지원되는 언어와 플랫폼의 양이 달라져요.
메시지 기반 (LangGraph에 최적화)
OpenAI, Anthropic 등처럼 메시지를 배열로 받아요.
기타 개선 사항 (Other improvements)
- v2는 타이핑이 개선되었고 SDK가 강력하게 타입 지정돼요
- SDK가 메시지 유형(system, user, assistant)과 도구 호출 유형을 다시 추가했어요
- v2는 더 호환되는 API예요. 예를 들어 도구 호출 구조화된 출력이에요
- SDK가 도구 매개변수와 도구 반환 유형을 구조적으로 캡처해요
마이그레이션 (Migration)
포괄적인 마이그레이션 가이드는 v1-to-v2 마이그레이션 가이드를 참조하세요.
FAQ
- API 키: 대시보드에서 API 키를 받아요.
- Command 모델을 위한 해결 방법: 커뮤니티 포럼
- v2 API 안정화 예상 출시일:
- 처음부터 시작하기: 새 버전의 SDK가 이제 공개적으로 사용 가능하며, 하위 호환성 패치를 포함해요
- 권장 업그레이드 경로:
- 권장 업그레이드: 모든 v1 호출을 v2로 마이그레이션해요.
- 현재 v1 호출 상태: v2 SDK는 계속해서 v1 호출을 지원해요
- 마이그레이션 속도: 대체로 며칠에서 몇 주 내
- v2 호출을 직접 확인하는 방법: v2 SDK를 사용해요
- v1과 v2에 대한 문서: Cohere Docs를 참조하세요