OpenAI と Anthropic の形式

ai& の Files API は単一エンドポイントで 2 種類の形式のレスポンスを返します — anthropic-version ヘッダの有無で切り替わります。

これにより、公式 openai SDK と anthropic SDK の両方が同じ URL、同じ API キーで、コード変更なしに動作します。

ヘッダによる形式選択

ヘッダ	レスポンス形式
`anthropic-version: <任意>`	Anthropic Files API 形式
(ヘッダなし)	OpenAI Files API 形式

例: 同じファイルを 2 形式で取得

OpenAI 形式
Anthropic 形式

curl https://api.aiand.com/v1/files/file-abc123 \
  -H "Authorization: Bearer sk-..."

{
  "id": "file-abc123",
  "object": "file",
  "bytes": 12345,
  "created_at": 1716960000,
  "filename": "cat.png",
  "purpose": "vision"
}

curl https://api.aiand.com/v1/files/file-abc123 \
  -H "Authorization: Bearer sk-..." \
  -H "anthropic-version: 2023-06-01"

{
  "id": "file-abc123",
  "type": "file",
  "size_bytes": 12345,
  "created_at": "2026-05-18T12:00:00Z",
  "filename": "cat.png",
  "mime_type": "image/png"
}

できること

OpenAI Python SDK の client.files.create(...) がそのまま動作。
Anthropic Python SDK の client.beta.files.upload(...) がそのまま動作。
一方の SDK でアップロードし、もう一方で取得することも可能 — file_id は同一。