API Fichiers

L’API Fichiers vous permet de télécharger et de gérer des fichiers à utiliser avec l’API Anthropic sans avoir à retélécharger le contenu à chaque requête. Cela est particulièrement utile lors de l’utilisation de l’outil d’exécution de code pour fournir des entrées (par exemple, des ensembles de données et des documents) puis télécharger des sorties (par exemple, des graphiques). Vous pouvez également utiliser l’API Fichiers pour éviter d’avoir à retélécharger continuellement des documents et des images fréquemment utilisés à travers plusieurs appels API.

​

Modèles pris en charge

La référence à un file_id dans une requête Messages est prise en charge dans tous les modèles qui supportent le type de fichier donné. Par exemple, les images sont prises en charge dans tous les modèles Claude 3+, les PDF dans tous les modèles Claude 3.5+, et divers autres types de fichiers pour l’outil d’exécution de code dans Claude 3.5 Haiku ainsi que tous les modèles Claude 3.7+.

L’API Fichiers n’est actuellement pas prise en charge sur Amazon Bedrock ou Google Vertex AI.

​

Comment fonctionne l’API Fichiers

L’API Fichiers offre une approche simple de création unique et d’utilisation multiple pour travailler avec des fichiers :

• Téléchargez des fichiers vers notre stockage sécurisé et recevez un file_id unique
• Téléchargez des fichiers qui sont créés par l’outil d’exécution de code
• Référencez des fichiers dans les requêtes Messages en utilisant le file_id au lieu de retélécharger le contenu
• Gérez vos fichiers avec des opérations de liste, de récupération et de suppression

​

Comment utiliser l’API Fichiers

​

Téléchargement d’un fichier

Téléchargez un fichier pour y faire référence dans de futurs appels API :

curl -X POST https://api.anthropic.com/v1/files \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14" \
  -F "file=@/path/to/document.pdf"

​

Types de fichiers et blocs de contenu

L’API Fichiers prend en charge différents types de fichiers qui correspondent à différents types de blocs de contenu :

​

Blocs de document

Pour les PDF et les fichiers texte, utilisez le bloc de contenu document :

{
  "type": "document",
  "source": {
    "type": "file",
    "file_id": "file_abc123"
  },
  "title": "Titre du document", // Optionnel
  "context": "Contexte sur le document", // Optionnel  
  "citations": {"enabled": true} // Optionnel, active les citations
}

​

Blocs d’image

Pour les images, utilisez le bloc de contenu image :

{
  "type": "image",
  "source": {
    "type": "file",
    "file_id": "file_xyz789"
  }
}

​

Gestion des fichiers

​

Liste des fichiers

Récupérez une liste de vos fichiers téléchargés :

curl https://api.anthropic.com/v1/files \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14"

​

Obtenir les métadonnées d’un fichier

Récupérez des informations sur un fichier spécifique :

curl https://api.anthropic.com/v1/files/file_abc123 \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14"

​

Supprimer un fichier

Supprimez un fichier de votre espace de travail :

curl -X DELETE https://api.anthropic.com/v1/files/file_abc123 \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14"

​

Téléchargement d’un fichier

Téléchargez des fichiers qui ont été créés par l’outil d’exécution de code :

curl -X GET "https://api.anthropic.com/v1/files/file_abc123/content" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14" \
  --output downloaded_file.txt

​

Stockage de fichiers et limites

​

Limites de stockage

• Taille maximale de fichier : 32 Mo par fichier
• Stockage total : 100 Go par organisation

​

Cycle de vie des fichiers

• Les fichiers sont limités à l’espace de travail de la clé API. D’autres clés API peuvent utiliser des fichiers créés par n’importe quelle autre clé API associée au même espace de travail
• Les fichiers persistent jusqu’à ce que vous les supprimiez
• Les fichiers supprimés ne peuvent pas être récupérés
• Les fichiers sont inaccessibles via l’API peu après la suppression, mais ils peuvent persister dans les appels API Messages actifs et les utilisations d’outils associées

​

Gestion des erreurs

Les erreurs courantes lors de l’utilisation de l’API Fichiers comprennent :

• Fichier non trouvé (404) : Le file_id spécifié n’existe pas ou vous n’y avez pas accès
• Type de fichier invalide (400) : Le type de fichier ne correspond pas au type de bloc de contenu (par exemple, utiliser un fichier image dans un bloc de document)
• Fichier trop volumineux (413) : Le fichier dépasse la limite de 500 Mo
• Limite de stockage dépassée (403) : Votre organisation a atteint la limite de stockage de 100 Go
• Nom de fichier invalide (400) : Le nom du fichier ne répond pas aux exigences de longueur (1-255 caractères) ou contient des caractères interdits (<, >, :, ", |, ?, *, \, /, ou caractères unicode 0-31)

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "File not found: file_abc123"
  }
}

​

Utilisation et facturation

Les opérations de l’API Fichiers sont gratuites :

• Téléchargement de fichiers
• Téléchargement de fichiers
• Liste des fichiers
• Obtention des métadonnées de fichiers
• Suppression de fichiers

Le contenu des fichiers utilisé dans les requêtes Messages est facturé en tokens d’entrée. Vous ne pouvez télécharger que les fichiers créés par l’outil d’exécution de code.

​

Limites de débit

Pendant la période bêta :

• Les appels API liés aux fichiers sont limités à environ 100 requêtes par minute
• Contactez-nous si vous avez besoin de limites plus élevées pour votre cas d’utilisation