Télécharger des Fichiers
Apprenez à télécharger et joindre des fichiers à vos requêtes API
by Arkangel AI Team•1 min read
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