---
title: "Files API：Responses API 用に PDF・画像をアップロード"
description: "PDF、画像、documents を upload し、Responses API から file_id で参照する。"
source: https://lazu.ai/docs/ja/endpoints/files
updated: 2026-10-02
---

# Files API

**POST** `/v1/files`

documents と images を一度 upload し、Responses API から file\_id で参照できます。OpenAI-compatible に寄せつつ、Lazu の retention と purpose rules を明示します。

## リクエスト例

```bash
curl https://api.lazu.ai/v1/files \
  -H "Authorization: Bearer $LAZU_API_KEY" \
  -F purpose=user_data \
  -F file=@./paper.pdf
```

## レスポンス例

```json
{
  "id": "file-lazu-01ABCDEF",
  "object": "file",
  "bytes": 421337,
  "filename": "paper.pdf",
  "purpose": "user_data",
  "created_at": 1765980000
}
```

## File endpoints

| Method | Path                    | Purpose        |
| ------ | ----------------------- | -------------- |
| POST   | `/v1/files`             | Upload         |
| GET    | `/v1/files`             | List           |
| GET    | `/v1/files/:id`         | Metadata       |
| GET    | `/v1/files/:id/content` | Download bytes |
| DELETE | `/v1/files/:id`         | Delete         |

すべて `Authorization: Bearer $LAZU_API_KEY` を使います。

## Upload request

- `purpose` `string` (必須) — file の用途。 指定可能な値: `user_data`, `vision`
- `file` `multipart file` (必須) — upload する file bytes。

## Supported purposes

- **user\_data** — 最大 512 MB。PDF、text、structured data を Responses の
  `input_file` として渡す用途。
- **vision** — 最大 20 MB。`image/png`、`image/jpeg`、
  `image/gif`、`image/webp` を許可。

OpenAI の `batch`、`fine-tune`、`assistants`
purposes はまだ support していません。実行ファイル拡張子は purpose に関係なく拒否します。

## Upload response

- `id` `string` — File ID。例：`file-lazu-01KSBV4MC6THZ9TCZEM38KPYRX`。
- `object` `string` — 常に `file`。
- `bytes` `integer` — upload byte size。
- `filename` `string` — original filename。
- `purpose` `string` — stored purpose。
- `status` `string` — 通常 `processed`。

成功時は `201 Created` を返します。client SDK が 200 のみを想定している場合は
201 を success として扱ってください。

## Responses から参照する

Lazu は [Responses](https://lazu.ai/docs/ja/endpoints/responses) でのみ `file_id`
を dereference します。Chat completions は file content を自動取得しません。