Retour à la documentation

Télécharger des Fichiers

Apprenez à télécharger et joindre des fichiers à vos requêtes API

par Arkangel AI Team•1 min de lecture

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

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

Prochaines Étapes