https://api.lazu.ai/v1/filesFiles API
documents と 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
purposestringrequiredfile の用途。
user_datavisionfilemultipart filerequiredupload する 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 を自動取得しません。
curl https://api.lazu.ai/v1/files \
-H "Authorization: Bearer $LAZU_API_KEY" \
-F purpose=user_data \
-F file=@./paper.pdf
{
"id": "file-lazu-01ABCDEF",
"object": "file",
"bytes": 421337,
"filename": "paper.pdf",
"purpose": "user_data",
"created_at": 1765980000
}
課金リクエストの完了後、ゲートウェイのリクエスト ID で使用量、課金項目、所要時間を確認できます。
実際のリクエスト明細を見る →