エンドポイント / Storage
Files API
POST
/v1/filesdocuments と images を一度 upload し、Responses API から file_id で参照できます。OpenAI-compatible に寄せつつ、Lazu の retention と purpose rules を明示します。
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
purposestringrequired
user_datavisionfile の用途。
filemultipart filerequired
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
idstringFile ID。例：file-lazu-01KSBV4MC6THZ9TCZEM38KPYRX。
objectstring常に file。
bytesintegerupload byte size。
filenamestringoriginal filename。
purposestringstored purpose。
statusstring通常 processed。
成功時は 201 Created を返します。client SDK が 200 のみを想定している場合は
201 を success として扱ってください。
Responses から参照する
Lazu は Responses でのみ file_id
を dereference します。Chat completions は file content を自動取得しません。