Volver a la documentación

Cargar Archivos

Aprende a subir y adjuntar archivos a tus consultas de la API

por Arkangel AI Team•1 min de lectura

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

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

Próximos Pasos