Para um guia de migração mais direto para código, consulte nosso guia de migração de referência da API.

À medida que continuamos a melhorar e expandir nossas capacidades de IA, estamos animados em apresentar nossa nova API de Mensagens, que oferece várias vantagens em relação à nossa API de Conclusões de Texto legada.

Este guia irá ajudá-lo a migrar seus aplicativos existentes da API de Conclusões de Texto para a API de Mensagens, garantindo uma transição suave e desbloqueando o acesso aos nossos recursos e melhorias mais recentes.

​
Por que atualizar para a API de Mensagens?

A API de Mensagens oferece vários benefícios principais:

  1. Processamento de imagem: A API de Mensagens é a única maneira de processar imagens com o Claude, permitindo que você aproveite nossas capacidades avançadas de visão computacional para tarefas como classificação de imagens, detecção de objetos e muito mais.
  2. Construindo com modelos Claude 3: Nossos modelos Claude 3 mais recentes e poderosos (Haiku, Sonnet e Opus) só podem ser chamados por meio da API de Mensagens. Ao atualizar, você poderá aproveitar seu desempenho e recursos aprimorados.
  3. Melhor tratamento de erros: A API de Mensagens nos permite retornar mensagens de erro mais informativas e úteis, facilitando o diagnóstico e a resolução de problemas em suas solicitações.
  4. Melhor validação de solicitação: Com a API de Mensagens, podemos validar suas solicitações de API com mais eficácia, garantindo que você receba os resultados de mais alta qualidade e o melhor desempenho possível de nossos modelos.

​
Como atualizar para a API de Mensagens

A maneira mais fácil de atualizar da API de Conclusões de Texto para a API de Mensagens é usar nosso Console da web para converter seus prompts. Ao usar o Console, você pode migrar rapidamente e facilmente seus prompts e solicitações para a API de Mensagens sem precisar reescrever manualmente seu código.

Basta seguir estas etapas:

​
1. Vá para o Console e selecione o modelo que deseja usar

No Console, há um painel de configurações de modelo na parte inferior direita da área de mensagens. Esse painel contém um menu suspenso onde você pode selecionar o modelo correto para o seu prompt migrado.

Aqui também é onde você pode ajustar quaisquer parâmetros adicionais conforme necessário, como temperatura e tokens máximos para amostragem. Para obter mais informações sobre nossos parâmetros, consulte a documentação da API de Mensagens.

​
2. Transfira seu prompt para os campos de mensagem apropriados do Console

Os prompts da API de Conclusões de Texto são strings de várias linhas que abrangem todas as partes de um prompt, como o prompt do sistema e a vez do usuário. A API de Mensagens divide as várias partes de um prompt, como o prompt do sistema e a vez do usuário, em campos separados.

Por exemplo, vamos pegar este prompt da API de Conclusões de Texto:

Text
Hoje é 4 de março de 2024.

H: Quais são 3 maneiras de cozinhar maçãs?

A:

Sem usar o Console, a transição desse prompt exigiria que você reescrevesse completamente seu código na API de Mensagens. No entanto, soltar as partes separadas do seu prompt (prompt do sistema e prompt do usuário) nos campos correspondentes do Console permite que você extraia o código pré-formatado correto pronto para uso.

No Console, o prompt acima ficaria assim:

Observe que não há texto Human: ou Assistant: e que o prompt do sistema e o prompt do usuário pertencem a campos de mensagem diferentes.

​
3. Copie o código pré-formatado

Depois que todas as partes do seu prompt estiverem no lugar e os parâmetros tiverem sido ajustados, clique no botão </> Get Code no canto superior direito para visualizar e copiar o snippet de código correspondente da API de Mensagens, tanto para Python quanto para TypeScript.

Para nosso prompt de exemplo, a saída Python automatizada do menu </> Get Code seria:

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="Hoje é 4 de março de 2024.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Quais são 3 maneiras de cozinhar maçãs?"
                }
            ]
        }
    ]
)
print(message.content)

Nota: O Console ainda não permite que você preencha previamente a resposta do Claude (ou seja, preencher previamente o texto na vez do Assistant), mas a API de Mensagens subjacente permite. Consulte nosso guia sobre preenchimento prévio da resposta do Claude para obter exemplos de como formatar uma solicitação da API de Mensagens com essa técnica.

​
Migrando de outros modelos

Se você estiver usando atualmente uma plataforma ou modelo de IA diferente e quiser mudar para o Claude com a API de Mensagens, criamos um guia abrangente para ajudá-lo no processo. Consulte migrando de outros modelos para obter instruções detalhadas sobre como adaptar seus prompts e código à nossa plataforma.

​
Documentação da API

Para obter mais informações sobre a API de Mensagens e seus recursos, consulte nossa documentação da API:

Se você tiver alguma dúvida ou precisar de mais assistência para atualizar para a API de Mensagens, não hesite em entrar em contato com nossa equipe de suporte. Estamos aqui para ajudá-lo a aproveitar ao máximo nossas capacidades de IA e garantir uma transição tranquila para o Claude.

Migrando de outros modelosVisão geral