SDK de Python de Anthropic v2.7.0: modelos nuevos y webhooks

Anthropic ha publicado la versión 2.7.0 de su SDK para Python, la biblioteca oficial que permite a los desarrolladores llamar a la API de Claude desde sus aplicaciones. La novedad más visible es la incorporación de dos modelos, claude-fable-5-2 y claude-mythos-5-2, junto con un nuevo evento de webhook, user_profile.program_status_updated, que las organizaciones pueden recibir en sus endpoints. La versión incluye además filtrado y agrupación por organización padre en los informes de uso y coste, y un nuevo código de error, sandbox_egress_restricted, en los métodos de escritura de la Admin API.

Qué hay detrás

El SDK de Python es una de las vías habituales para integrar Claude en sistemas propios. Anthropic lo mantiene en paralelo a los SDK de otros lenguajes y lo distribuye con el mismo esquema de versiones semánticas, de modo que cada cambio aparece en un registro de novedades dividido en funcionalidades, correcciones y tareas de mantenimiento. Esta versión sigue ese patrón.

El SDK no solo sirve para la API directa de Anthropic. También da acceso a Claude a través de Amazon Bedrock, Google Cloud Vertex AI y Microsoft Foundry, y muchas de las correcciones de esta versión afectan precisamente a esos clientes. Por ejemplo, los clientes de Bedrock, Mantle y Vertex ahora leen la variable ANTHROPIC_CUSTOM_HEADERS, y los de Bedrock Mantle serializan las listas en consultas como a[]=1&a[]=2, igual que hace Anthropic. Son detalles menores para quien usa la API directa, pero importan cuando un equipo depende de un proveedor cloud concreto.

La Admin API es la interfaz para administrar la organización: gestionar miembros, claves y, en este caso, consultar uso y coste. El filtrado por organización padre facilita agregar esos datos cuando una empresa tiene varias organizaciones bajo una misma estructura, algo que hasta ahora obligaba a consolidar las cifras a mano.

En cuanto a los webhooks, el nuevo evento permite reaccionar a cambios de estado de un perfil de usuario sin tener que consultar la API de forma periódica. Es una pieza pequeña, pero marca la dirección de integrar la plataforma en flujos de trabajo automatizados.

Claves

• Modelos nuevos: claude-fable-5-2 y claude-mythos-5-2 se añaden al SDK. Conviene revisar la documentación oficial para conocer sus capacidades y precios antes de usarlos en producción.
• Webhooks: el evento user_profile.program_status_updated se acepta en los endpoints de organización, lo que permite automatizar respuestas a cambios de estado.
• Informes de coste: el filtrado y la agrupación por organización padre simplifican el control de gasto en estructuras con varias organizaciones.
• Compatibilidad cloud: se corrigen varios fallos en los clientes de Bedrock, Mantle, Vertex y Foundry, incluidos métodos que faltaban en las respuestas en bruto y el manejo de cabeceras.
• Mantenimiento: se eliminan algunos tipos de detalle de error y se actualizan descripciones, por lo que el código que dependa de esos tipos debería comprobarse tras la actualización.

La nota fuente no detalla el alcance de cada cambio ni su fecha de disponibilidad en cada plataforma, así que cualquier adopción debería apoyarse en la documentación y el registro de cambios completos.