Para una guía de migración más directa al código, consulte nuestra guía de migración de referencia de la API.

A medida que continuamos mejorando y expandiendo nuestras capacidades de IA, nos complace presentar nuestra nueva API de Messages, que ofrece varias ventajas sobre nuestra API heredada de Text Completions.

Esta guía le ayudará a migrar sus aplicaciones existentes de la API de Text Completions a la API de Messages, asegurando una transición sin problemas y desbloqueando el acceso a nuestras últimas características y mejoras.


¿Por qué actualizar a la API de Messages?

La API de Messages ofrece varios beneficios clave:

  1. Procesamiento de imágenes: La API de Messages es la única forma de procesar imágenes con Claude, lo que le permite aprovechar nuestras avanzadas capacidades de visión por computadora para tareas como clasificación de imágenes, detección de objetos y más.
  2. Construyendo con modelos Claude 3: Nuestros últimos y más potentes modelos Claude 3 (Haiku, Sonnet y Opus) solo se pueden llamar a través de la API de Messages. Al actualizar, podrá aprovechar su rendimiento y capacidades mejoradas.
  3. Manejo de errores mejorado: La API de Messages nos permite devolver mensajes de error más informativos y útiles, lo que facilita el diagnóstico y la resolución de problemas en sus solicitudes.
  4. Mejor validación de solicitudes: Con la API de Messages, podemos validar sus solicitudes de API de manera más efectiva, asegurando que reciba los resultados de la más alta calidad y el mejor rendimiento posible de nuestros modelos.

Cómo actualizar a la API de Messages

La forma más fácil de actualizar de la API de Text Completions a la API de Messages es usar nuestra Consola web para convertir sus prompts. Al usar la Consola, puede migrar rápida y fácilmente sus prompts y solicitudes a la API de Messages sin tener que reescribir manualmente su código.

Simplemente siga estos pasos:

1. Vaya a la Consola y seleccione el modelo que desea usar

Dentro de la Consola, hay un panel de configuración de modelo en la parte inferior derecha del área de mensajes. Ese panel alberga un menú desplegable donde puede seleccionar el modelo correcto para su prompt migrado.

Aquí también puede ajustar cualquier parámetro adicional según sea necesario, como la temperatura y el número máximo de tokens a muestrear. Para obtener más información sobre nuestros parámetros, consulte la documentación de la API de Messages.

2. Transfiera su prompt a los campos de mensaje apropiados de la Consola

Los prompts de la API de Text Completions son cadenas multilínea que abarcan todas las partes de un prompt, como el prompt del sistema y el turno del usuario. La API de Messages divide las distintas partes de un prompt, como el prompt del sistema y el turno del usuario, en campos separados.

Por ejemplo, tomemos este prompt de la API de Text Completions:

Text
Today is March 4, 2024.

H: What are 3 ways to cook apples?

A:

Sin usar la Consola, la transición de este prompt requeriría que reescriba completamente su código en la API de Messages. Sin embargo, colocar las partes separadas de su prompt (prompt del sistema y prompt del usuario) en los campos correspondientes de la Consola le permite extraer código preformateado correcto de inmediato.

En la Consola, el prompt anterior se vería así:

Tenga en cuenta que no hay texto Human: o Assistant:, y que el prompt del sistema y el prompt del usuario pertenecen a diferentes campos de mensaje.

3. Copie el código preformateado

Una vez que todas las partes de su prompt estén en su lugar y los parámetros se hayan ajustado, haga clic en el botón </> Get Code en la parte superior derecha para ver y copiar el fragmento de código correspondiente de la API de Messages, tanto para Python como para TypeScript.

Para nuestro prompt de ejemplo, la salida automatizada de Python del menú </> Get Code sería:

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)

Nota: La Consola aún no permite precompletar la respuesta de Claude (es decir, precompletar texto en el turno del Assistant), pero la API de Messages subyacente sí lo hace. Consulte nuestra guía sobre precompletar la respuesta de Claude para ver ejemplos de cómo formatear una solicitud de la API de Messages con esta técnica.


Migrando desde otros modelos

Si actualmente está utilizando una plataforma o modelo de IA diferente y desea cambiar a Claude con la API de Messages, hemos creado una guía completa para ayudarlo en el proceso. Consulte migrando desde otros modelos para obtener instrucciones detalladas sobre cómo adaptar sus prompts y código a nuestra plataforma.


Documentación de la API

Para obtener más información sobre la API de Messages y sus capacidades, consulte nuestra documentación de la API:

Si tiene alguna pregunta o necesita más ayuda para actualizar a la API de Messages, no dude en comunicarse con nuestro equipo de soporte. Estamos aquí para ayudarlo a aprovechar al máximo nuestras capacidades de IA y garantizar una transición sin problemas a Claude.