Télécharger des Fichiers - Documentation

L'API Arkangel AI vous permet de joindre des fichiers à vos requêtes pour une analyse contextuelle.

Types de Fichiers Supportés

Type	Extensions	Taille Max
Documents	`.pdf`, `.doc`, `.docx`	10 Mo
Images	`.jpg`, `.png`, `.webp`	5 Mo
Texte	`.txt`, `.md`	2 Mo

Télécharger un Fichier

Point d'Accès

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

Exemple cURL

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

Exemple 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 votre_cle_api'
  },
  body: formData
});

const result = await response.json();
console.log('Fichier téléchargé:', result.file_id);

Réponse de Téléchargement

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

Utiliser les Fichiers dans les Requêtes

Une fois le fichier téléchargé, vous pouvez le référencer dans vos messages :

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

Lister les Fichiers

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

Réponse

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

Supprimer un Fichier

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

Gestion des Erreurs

Code	Erreur	Description
400	`invalid_file_type`	Type de fichier non supporté
400	`file_too_large`	Le fichier dépasse la taille maximale
404	`file_not_found`	Le fichier n'existe pas
422	`file_processing_failed`	Erreur lors du traitement du fichier

Bonnes Pratiques

Validez le type de fichier avant de télécharger
Compressez les grandes images avant le téléchargement
Supprimez les fichiers dont vous n'avez plus besoin
Utilisez des noms descriptifs pour vos fichiers

Prochaines Étapes

Consulter les Chats - Gérez les conversations avec fichiers joints
Exemples d'Utilisation - Voir des exemples complets