機能

Files API

Files APIを使用してファイルをアップロードおよび管理し、リクエストごとにコンテンツを再アップロードすることなくClaude APIで使用できます。

Files APIを使用すると、リクエストごとにコンテンツを再アップロードすることなく、Claude APIで使用するファイルをアップロードおよび管理できます。これは、コード実行ツールを使用して入力（例：データセットとドキュメント）を提供し、出力（例：チャート）をダウンロードする場合に特に便利です。Files APIを使用して、複数のAPI呼び出しで頻繁に使用されるドキュメントと画像を継続的に再アップロードする必要がなくなります。このガイドに加えて、APIリファレンスを直接探索することもできます。

Files APIは現在ベータ版です。フィードバックフォームを通じてFiles APIの使用体験を共有してください。

サポートされているモデル

Messages リクエストで file_id を参照することは、指定されたファイルタイプをサポートするすべてのモデルでサポートされています。例えば、画像はすべてのClaude 3+モデルでサポートされており、PDFはすべてのClaude 3.5+モデルでサポートされており、その他の様々なファイルタイプはClaude Haiku 4.5およびすべてのClaude 3.7+モデルのコード実行ツールでサポートされています。

Files APIは現在、Amazon BedrockおよびGoogle Vertex AIではサポートされていません。

Files APIの仕組み

Files APIは、ファイルを操作するためのシンプルな「一度アップロード、何度も使用」アプローチを提供します：

ファイルをアップロードして安全なストレージに保存し、一意の file_id を受け取ります
ファイルをダウンロードして、スキルまたはコード実行ツールから作成されたファイルを取得します
ファイルを参照して、Messagesリクエストで file_id を使用し、コンテンツを再アップロードする代わりに使用します
して、リスト、取得、削除操作を実行します

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"
            }
          }
        ]
      }
    ]
  }'

ファイルタイプ	MIMEタイプ	コンテンツブロックタイプ	ユースケース
PDF	`application/pdf`	`document`	テキスト分析、ドキュメント処理
プレーンテキスト	`text/plain`	`document`	テキスト分析、処理
画像	`image/jpeg`, `image/png`, `image/gif`, `image/webp`	`image`	画像分析、ビジュアルタスク
データセット、その他	様々	`container_upload`	データ分析、ビジュアライゼーション作成

# 例：テキストファイルを読み込んでプレーンテキストとして送信
# 注：特殊文字を含むファイルの場合、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", // オプション
  "context": "Context about the document", // オプション  
  "citations": {"enabled": true} // オプション、引用を有効にします
}

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

Files API

サポートされているモデル

Files APIの仕組み

Files API

サポートされているモデル

Files APIの仕組み

Files APIの使用方法

ファイルのアップロード

メッセージでファイルを使用する

ファイルタイプとコンテンツブロック

その他のファイル形式の操作

ドキュメントブロック

画像ブロック

ファイルの管理

ファイルのリスト

ファイルメタデータの取得

ファイルの削除

ファイルのダウンロード

ファイルストレージと制限

ストレージ制限

ファイルライフサイクル

エラーハンドリング

使用とビリング

レート制限