보다 직접적인 코드 마이그레이션 가이드를 보려면, API 참조 마이그레이션 가이드를 참조하세요.

AI 기능을 계속 개선하고 확장함에 따라, 기존 Text Completions API보다 여러 가지 이점을 제공하는 새로운 Messages API를 소개하게 되어 기쁩니다.

이 가이드는 기존 애플리케이션을 Text Completions API에서 Messages API로 마이그레이션하는 데 도움이 될 것이며, 원활한 전환을 보장하고 최신 기능과 개선 사항에 대한 액세스를 제공할 것입니다.


Messages API로 업그레이드해야 하는 이유

Messages API는 다음과 같은 몇 가지 주요 이점을 제공합니다:

  1. 이미지 처리: Messages API는 Claude로 이미지를 처리할 수 있는 유일한 방법으로, 이미지 분류, 객체 감지 등과 같은 고급 컴퓨터 비전 기능을 활용할 수 있습니다.
  2. Claude 3 모델로 구축: 최신이자 가장 강력한 Claude 3 모델(Haiku, Sonnet, Opus)은 Messages API를 통해서만 호출할 수 있습니다. 업그레이드하면 향상된 성능과 기능을 활용할 수 있습니다.
  3. 개선된 오류 처리: Messages API를 사용하면 보다 유용하고 도움이 되는 오류 메시지를 반환할 수 있어 요청의 문제를 더 쉽게 진단하고 해결할 수 있습니다.
  4. 더 나은 요청 검증: Messages API를 사용하면 API 요청을 보다 효과적으로 검증할 수 있어 최고 품질의 결과와 모델의 최상의 성능을 보장할 수 있습니다.

Messages API로 업그레이드하는 방법

Text Completions API에서 Messages API로 업그레이드하는 가장 쉬운 방법은 웹 Console을 사용하여 프롬프트를 변환하는 것입니다. Console을 사용하면 코드를 수동으로 다시 작성할 필요 없이 프롬프트와 요청을 Messages API로 빠르고 쉽게 마이그레이션할 수 있습니다.

다음 단계를 따르기만 하면 됩니다:

1. Console로 이동하여 사용할 모델 선택

Console 내에는 메시지 영역의 오른쪽 하단에 모델 설정 패널이 있습니다. 해당 패널에는 마이그레이션된 프롬프트에 맞는 모델을 선택할 수 있는 드롭다운 메뉴가 있습니다.

여기에서 temperature 및 샘플링할 최대 토큰 수와 같은 추가 매개변수를 필요에 따라 조정할 수도 있습니다. 매개변수에 대한 자세한 내용은 Messages API 문서를 참조하세요.

2. 프롬프트를 적절한 Console 메시지 필드로 전송

Text Completions API 프롬프트는 시스템 프롬프트와 사용자 턴과 같은 프롬프트의 모든 부분을 포함하는 여러 줄 문자열입니다. Messages API는 시스템 프롬프트와 사용자 턴과 같은 프롬프트의 다양한 부분을 별도의 필드로 분할합니다.

예를 들어, 다음과 같은 Text Completions API 프롬프트를 살펴보겠습니다:

Text
Today is March 4, 2024.

H: What are 3 ways to cook apples?

A:

Console을 사용하지 않고 이 프롬프트를 전환하려면 코드를 Messages API로 완전히 다시 작성해야 합니다. 그러나 프롬프트의 별도 부분(시스템 프롬프트 및 사용자 프롬프트)을 해당 Console 필드에 삽입하면 즉시 올바르게 사전 포맷된 코드를 추출할 수 있습니다.

Console에서 위의 프롬프트는 다음과 같이 보일 것입니다:

Human: 또는 Assistant: 텍스트가 없으며 시스템 프롬프트와 사용자 프롬프트가 서로 다른 메시지 필드에 속한다는 점에 유의하세요.

3. 사전 포맷된 코드 복사

프롬프트의 모든 부분이 제자리에 있고 매개변수가 조정되면 오른쪽 상단의 </> Get Code 버튼을 클릭하여 Python과 TypeScript 모두에 대한 해당 Messages API 코드 스니펫을 보고 복사할 수 있습니다.

예제 프롬프트의 경우 </> Get Code 메뉴에서 자동 생성된 Python 출력은 다음과 같습니다:

Python
import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0,
    system="Today is March 4, 2024.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "What are 3 ways to cook apples?"
                }
            ]
        }
    ]
)
print(message.content)

참고: Console은 아직 Claude의 응답 미리 채우기(즉, Assistant 턴에 텍스트 미리 채우기)를 허용하지 않지만 기본 Messages API는 허용합니다. 이 기술을 사용하여 Messages API 요청을 포맷하는 방법에 대한 예제는 Claude의 응답 미리 채우기 가이드를 참조하세요.


다른 모델에서 마이그레이션

현재 다른 AI 플랫폼이나 모델을 사용 중이고 Messages API로 Claude로 전환하려는 경우 프로세스를 안내할 종합 가이드를 만들었습니다. 프롬프트와 코드를 당사 플랫폼에 적용하는 방법에 대한 자세한 지침은 다른 모델에서 마이그레이션을 참조하세요.


API 문서

Messages API와 그 기능에 대한 자세한 내용은 API 문서를 참조하세요:

Messages API로 업그레이드하는 데 질문이 있거나 추가 지원이 필요한 경우 언제든지 지원팀에 문의하십시오. 당사의 AI 기능을 최대한 활용하고 Claude로 원활하게 전환할 수 있도록 도와드리겠습니다.