ファイルを削除

DELETE https://api.inoneapi.com/v1/files/{file_id}

現在のキーに属する COS オブジェクトと DB メタデータを削除します。その ID を新たに参照できなくなります。上流へ送信済みの内容の回収や、実行中の生成タスクのキャンセルは行いません。

Authorization: Bearer $INONEAPI_API_KEY を指定し、リクエスト本文は送信しません。アップロードしたキーのみ操作できます。同じユーザーやプロジェクトの別キーでもアクセスできません。推論料金や残高は不要ですが、キーのレート・同時実行制限とプロジェクトの状態は適用されます。

リクエスト項目

パラメーター場所型説明
file_idpathstring必須。アップロードで返された完全な ID。file_ioa_ と小文字の 16 進数 32 桁。Playground やプロバイダーの ID は不可。

リクエスト例

JavaScript は Node.js 20+ のサーバーで INONEAPI_API_KEY を設定して実行します。

curl  -X DELETE https://api.inoneapi.com/v1/files/file_ioa_0123456789abcdef0123456789abcdef \
  -H "Authorization: Bearer $INONEAPI_API_KEY"

応答内容

{
  "id": "file_ioa_0123456789abcdef0123456789abcdef",
  "object": "file",
  "deleted": true
}

HTTP 200 で id、object: file、deleted: true を返します。HTTP 204 ではありません。再度削除すると通常 404 となり、毎回同じ成功結果が返る保証はありません。

エラーと制約

HTTP / code原因と対処
404 FILE_NOT_FOUND不正・不存在・別キーの ID。後片付けではアクセス不可として扱えますが、別キーの存在確認には使えません。
409 FILE_NOT_READY作成から 5 分未満の uploading。実行中アップロードとの競合を避け、待って再試行。
503 FILE_STORAGE_UNAVAILABLEオブジェクトまたはメタデータの削除失敗。ID を保存して状態確認後に回数を制限して再試行。

ready はすぐに削除可能です。中断した uploading は作成から 5 分後に削除できます。オブジェクトを先に削除し、その後メタデータを削除するため、原子的ではありません。503 やタイムアウト後にレコードだけ残る場合があります。

COS が削除した後の古いメタデータも削除できます。キーを削除すると ID は無効化され、残りのオブジェクトはライフサイクルで回収されます。非同期プロバイダーが素材を読む場合があるため、タスクが不要になってから削除してください。

ファイルガイド · POST /v1/files · エラーコード

ファイルを削除 · ドキュメント · InOneAPI