Primeros pasos con las nuevas funciones de la API de Claude: interruptor de salida larga, evaluación en el Workbench y panel de costes

Si últimamente estás usando la API de Claude para resumir, escribir código o generar textos largos, el cambio más evidente es que “puede producir salidas más largas”, y al mismo tiempo la consola para desarrolladores es más fácil de usar. En este artículo desglosamos varias novedades de la API de Claude: cómo activar la salida larga, cómo usar el Workbench para evaluar prompts, y cómo entender claramente los costes en el panel.

Salida larga en la API de Claude: Sonnet 3.5 pasa de 4096 a 8192

La API de Claude ya ha aumentado el límite máximo de tokens de salida de Claude Sonnet 3.5 a 8192, pero es necesario activarlo explícitamente. Al llamar a la API de Claude, añade anthropic-beta en el encabezado de la solicitud para habilitar una ventana de salida más larga; es ideal para generar de una sola vez informes más completos, archivos de código extensos o resúmenes en varias secciones.

La forma exacta es muy clara: añade al encabezado anthropic-beta: max-tokens-3-5-sonnet-2024-07-15. Si en la API de Claude te encuentras con que “la salida se corta”, revisa primero si olvidaste este interruptor y si tu max_tokens está configurado lo suficientemente alto.

Workbench más cómodo: generador de prompts y modo de evaluación

En el Workbench de la consola de Claude, la experiencia de depuración de la API de Claude incorpora dos herramientas clave. La primera es el “generador de prompts”: basta con describir el objetivo de la tarea (por ejemplo, “clasificar solicitudes entrantes de atención al cliente”) y te dará un borrador de prompt con una estructura completa, listo para copiar y pegar en la API de Claude.

La segunda es el “modo de evaluación”: ejecuta en paralelo dos o más conjuntos de prompts con el mismo lote de entradas; los resultados se muestran juntos para compararlos, y además puedes puntuar el desempeño con una escala de 5 puntos. Para escenarios de la API de Claude que requieren resultados estables (enrutamiento de soporte, extracción de información, reescritura de cumplimiento), este paso puede reducir significativamente el ajuste “a ojo”.

Panel de uso y costes: calcular claramente el coste de la API de Claude

Tras añadirse las pestañas de “uso” y “costes” en la consola para desarrolladores, la factura de la API de Claude deja de depender solo de sensaciones. Puedes rastrear el consumo por importe en dólares, cantidad de tokens y por API Key, y localizar rápidamente “qué Key está quemando dinero”.

Se recomienda separar distintos entornos en diferentes Keys (por ejemplo, desarrollo/pruebas/producción) y luego revisar con el panel los periodos de mayor pico. Así, si la API de Claude presenta llamadas anómalas o solicitudes en bucle, podrás detectarlo antes de que el coste se dispare.

Documentación y recursos de aprendizaje más completos: notas de versión, cursos y Cookbook

La documentación de la API de Claude incorporó notas de versión más sistemáticas, que abarcan actualizaciones de la API, la consola de Claude y la aplicación de Claude; es útil para que los equipos registren cambios de versión. Al mismo tiempo, la documentación oficial también lanzó cursos sobre fundamentos de la API de Claude y el uso de herramientas, para que los recién llegados completen rápidamente habilidades como la integración y la salida JSON estructurada.

Si estás trabajando en generación aumentada por recuperación, anotación de citas o tareas de clasificación, puedes consultar directamente las guías correspondientes del Claude Cookbook y ahorrarte tiempo de tropiezos repetidos. En conjunto, el foco de esta actualización de la API de Claude no está en “trucos llamativos”, sino en consolidar tres cosas: salida larga, evaluación y gestión de costes.