Capacités

API Files

L'API Files vous permet de télécharger et de gérer des fichiers à utiliser avec l'API Claude sans avoir à retélécharger le contenu à chaque demande.

L'API Files vous permet de télécharger et de gérer des fichiers à utiliser avec l'API Claude sans avoir à retélécharger le contenu à chaque demande. Ceci 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 Files pour éviter de devoir retélécharger continuellement des documents et des images fréquemment utilisés sur plusieurs appels API. Vous pouvez explorer la référence API directement, en plus de ce guide.

L'API Files est actuellement en version bêta. Veuillez nous contacter via notre formulaire de commentaires pour partager votre expérience avec l'API Files.

Modèles pris en charge

Le référencement d'un file_id dans une demande Messages est pris en charge dans tous les modèles qui prennent en charge 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 Haiku 4.5 plus tous les modèles Claude 3.7+.

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

Comment fonctionne l'API Files

L'API Files fournit une approche simple de création unique et d'utilisation multiple pour travailler avec des fichiers :

Télécharger des fichiers vers notre stockage sécurisé et recevoir un file_id unique
qui sont créés à partir de compétences ou de l'outil d'exécution de code

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"

{
  "id": "file_011CNha8iCJcU1wXNR6q4V8w",
  "type": "file",
  "filename": "document.pdf",
  "mime_type": "application/pdf",
  "size_bytes": 1024000,
  "created_at": "2025-01-01T00:00:00Z",
  "downloadable": false
}

curl -X POST https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Please summarize this document for me."          
          },
          {
            "type": "document",
            "source": {
              "type": "file",
              "file_id": "file_011CNha8iCJcU1wXNR6q4V8w"
            }
          }
        ]
      }
    ]
  }'

Type de fichier	Type MIME	Type de bloc de contenu	Cas d'utilisation
PDF	`application/pdf`	`document`	Analyse de texte, traitement de documents
Texte brut	`text/plain`	`document`	Analyse de texte, traitement
Images	`image/jpeg`, `image/png`, `image/gif`, `image/webp`	`image`	Analyse d'images, tâches visuelles
Ensembles de données, autres	Varie	`container_upload`	Analyser les données, créer des visualisations

# Exemple : Lecture d'un fichier texte et envoi en tant que texte brut
# Remarque : Pour les fichiers avec des caractères spéciaux, envisagez l'encodage base64
TEXT_CONTENT=$(cat document.txt | jq -Rs .)

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d @- <<EOF
{
  "model": "claude-sonnet-4-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Here's the document content:\n\n${TEXT_CONTENT}\n\nPlease summarize this document."
        }
      ]
    }
  ]
}
EOF

{
  "type": "document",
  "source": {
    "type": "file",
    "file_id": "file_011CNha8iCJcU1wXNR6q4V8w"
  },
  "title": "Document Title", // Optionnel
  "context": "Context about the document", // Optionnel  
  "citations": {"enabled": true} // Optionnel, active les citations
}

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

curl -X GET "https://api.anthropic.com/v1/files/file_011CNha8iCJcU1wXNR6q4V8w/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

API Files

Modèles pris en charge

Comment fonctionne l'API Files

API Files

Modèles pris en charge

Comment fonctionne l'API Files

Comment utiliser l'API Files

Télécharger un fichier

Utiliser un fichier dans les messages

Types de fichiers et blocs de contenu

Travailler avec d'autres formats de fichiers

Blocs de document

Blocs d'image

Gérer les fichiers

Lister les fichiers

Obtenir les métadonnées du fichier

Supprimer un fichier

Télécharger un fichier

Stockage des fichiers et limites

Limites de stockage

Cycle de vie des fichiers

Gestion des erreurs

Utilisation et facturation

Limites de débit