Cargar Archivos - Documentation

La API de Arkangel AI permite adjuntar archivos a tus consultas para análisis contextual.

Tipos de Archivos Soportados

Tipo	Extensiones	Tamaño Máximo
Documentos	`.pdf`, `.doc`, `.docx`	10 MB
Imágenes	`.jpg`, `.png`, `.webp`	5 MB
Texto	`.txt`, `.md`	2 MB

Subir un Archivo

Endpoint

POST https://api.arkangelai.com/v1/files

Ejemplo con cURL

curl -X POST https://api.arkangelai.com/v1/files \
  -H "Authorization: Bearer tu_clave_api" \
  -F "file=@documento.pdf" \
  -F "purpose=analysis"

Ejemplo en JavaScript

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('purpose', 'analysis');

const response = await fetch('https://api.arkangelai.com/v1/files', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer tu_clave_api'
  },
  body: formData
});

const result = await response.json();
console.log('Archivo subido:', result.file_id);

Respuesta de Carga

{
  "file_id": "file_abc123",
  "filename": "documento.pdf",
  "size": 1024000,
  "mime_type": "application/pdf",
  "purpose": "analysis",
  "status": "processed",
  "created_at": "2026-01-19T10:30:00Z"
}

Usar Archivos en Consultas

Una vez subido el archivo, puedes referenciarlo en tus mensajes:

const response = await fetch('https://api.arkangelai.com/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer tu_clave_api',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'Analiza este documento médico',
    file_ids: ['file_abc123']
  })
});

Listar Archivos

curl https://api.arkangelai.com/v1/files \
  -H "Authorization: Bearer tu_clave_api"

Respuesta

{
  "files": [
    {
      "file_id": "file_abc123",
      "filename": "documento.pdf",
      "size": 1024000,
      "created_at": "2026-01-19T10:30:00Z"
    }
  ],
  "total": 1
}

Eliminar un Archivo

curl -X DELETE https://api.arkangelai.com/v1/files/file_abc123 \
  -H "Authorization: Bearer tu_clave_api"

Manejo de Errores

Código	Error	Descripción
400	`invalid_file_type`	Tipo de archivo no soportado
400	`file_too_large`	El archivo excede el tamaño máximo
404	`file_not_found`	El archivo no existe
422	`file_processing_failed`	Error al procesar el archivo

Mejores Prácticas

Valida el tipo de archivo antes de subirlo
Comprime imágenes grandes antes de la carga
Elimina archivos que ya no necesites
Usa nombres descriptivos para tus archivos

Próximos Pasos

Revisar Chats - Gestiona conversaciones con archivos adjuntos
Ejemplos de Uso - Ve ejemplos completos