Files API

La Files API te permite subir y administrar archivos para usarlos con la Claude API sin volver a subir el contenido con cada solicitud. Esto es particularmente útil cuando usas la herramienta de ejecución de código para proporcionar entradas (por ejemplo, conjuntos de datos y documentos) y luego descargar salidas (por ejemplo, gráficos). Puedes explorar la referencia de la API directamente, además de esta guía.

Compatibilidad de tipos de archivo

Hacer referencia a un file_id en una solicitud de Messages es compatible con todos los modelos que admiten el tipo de archivo dado. Las imágenes son compatibles con todos los modelos actuales de Claude. Para PDFs y otros tipos de archivo con la herramienta de ejecución de código, consulta las páginas enlazadas para conocer la compatibilidad de modelos.

Cómo funciona la Files API

La Files API proporciona un enfoque de crear una vez y usar muchas veces para trabajar con archivos:

• Sube archivos al almacenamiento seguro de Anthropic y recibe un file_id único
• Descarga archivos creados por skills o la herramienta de ejecución de código
• Haz referencia a archivos en solicitudes de Messages usando el file_id en lugar de volver a subir el contenido
• Administra tus archivos con operaciones de listar, recuperar y eliminar

Cómo usar la Files API

Subir un archivo

Sube un archivo para hacer referencia a él en futuras llamadas a la API:

uploaded = client.files.upload(
    file=("document.pdf", open("/path/to/document.pdf", "rb"), "application/pdf"),
)
file_id = uploaded.id
print(file_id)

La respuesta al subir un archivo incluye:

{
  "id": "file_011CNha8iCJcU1wXNR6q4V8w",
  "type": "file",
  "filename":