Files API

Files API: gestiona documentos sin reenviarlos en cada petición

La Files API permite subir archivos una vez y referenciarlos por ID en múltiples conversaciones, en lugar de incluir el contenido completo en cada llamada a la API.

Formatos soportados

• Documentos: PDF, TXT, MD, HTML, CSV, JSON, XML
• Imágenes: JPEG, PNG, GIF, WebP
• Código: cualquier extensión de texto plano

Flujo básico

import anthropic

client = anthropic.Anthropic()

# 1. Subir el archivo una sola vez
with open("documentacion.pdf", "rb") as f:
    archivo = client.files.upload(
        file=("documentacion.pdf", f, "application/pdf")
    )

print(archivo.id)  # file_abc123xyz

# 2. Referenciar en múltiples llamadas
respuesta = client.messages.create(
    model="claude-sonnet-4-6-20260217",
    messages=[{
        "role": "user",
        "content": [
            {
                "type": "document",
                "source": {"type": "file", "file_id": archivo.id}
            },
            {"type": "text", "text": "Resume los puntos clave"}
        ]
    }]
)

Gestión de archivos

# Listar archivos subidos
archivos = client.files.list()

# Obtener metadatos
info = client.files.retrieve("file_abc123xyz")
print(info.filename, info.size, info.created_at)

# Eliminar
client.files.delete("file_abc123xyz")

Cuándo usar Files API vs prompt directo

Situación	Recomendación
Mismo doc en múltiples queries	Files API
Documento de un solo uso	Prompt directo
Doc > 10MB	Files API obligatorio
Necesitas cachear el análisis	Files API + Prompt Caching

Límites actuales

• Tamaño máximo por archivo: 32MB
• Archivos por workspace: 100GB total
• Retención: 30 días (renovable con acceso)