ファイルをアップロード

POST https://api.inoneapi.com/v1/files

ファイルを 1 件アップロードし、モデルリクエストで参照できる InOneAPI の file_id を取得します。保存と形式判定を行う API であり、OCR、変換、文書解析、推論は行いません。

Authorization: Bearer $INONEAPI_API_KEY と multipart/form-data を使用します。ファイルはアップロードしたキー専用です。同じユーザーやプロジェクトの別キーでもアクセスできません。推論料金や残高は不要ですが、キーのレート・同時実行制限とプロジェクトの状態は適用されます。

リクエスト項目

フィールド型要件
filebinary必須。空でないファイル 1 件のみ。ファイル名は Unicode 255 文字以内。NUL、改行、パス区切り文字は禁止。
purposestring必須。user_data のみ。重複指定不可。

cURL の -F または FormData に multipart boundary を生成させてください。Content-Type を手動設定しません。JSON/Base64 アップロードや fine-tune、batch 用途は未対応です。

形式と上限

判定タイプ対応形式1 件の上限
imagePNG、JPEG、WebP、GIF10 MiB
videoMP4、WebM、MOV32 MiB
audioMP3、WAV、OGG、AAC、FLAC、M4A、音声 WebM10 MiB
documentPDF、プレーンテキスト、CSV、JSON10 MiB

内容から形式を判定します。拡張子や申告 MIME を変更しても対応形式は増えません。コンテナやテキストの分類はレスポンスを確認してください。各キーの直近 24 時間に作成された現存レコードは合計 1 GiB、1000 件までで、未完了アップロードも含みます。

リクエスト例

JavaScript は Node.js 20+ のサーバーで実行します。キーをブラウザーに公開しないでください。

curl  https://api.inoneapi.com/v1/files \
  -H "Authorization: Bearer $INONEAPI_API_KEY" \
  -F purpose=user_data \
  -F file=@./sample.pdf

成功レスポンス

{
  "id": "file_ioa_0123456789abcdef0123456789abcdef",
  "object": "file",
  "filename": "sample.pdf",
  "mime_type": "application/pdf",
  "media_type": "document",
  "bytes": 1024,
  "status": "ready",
  "created_at": 1789430400,
  "purpose": "user_data"
}

HTTP 200 でメタデータを返します。id はプラットフォーム ID、object は file、filename は名前、mime_type は判定 MIME、media_type は image/video/audio/document、bytes は元のバイト数、status は ready、created_at は Unix 秒、purpose は user_data です。オブジェクトキー、内容、署名 URL、expires_at は返しません。

エラーと再試行

HTTP / code対処
400 INVALID_FILE_REQUESTmultipart、必須項目、件数、名前を確認。
400 UNSUPPORTED_FILE_TYPE対応する実際の形式を使用。
413 FILE_TOO_LARGEサイズを削減。multipart 全体にも上限があります。
429 FILE_QUOTA_EXCEEDED不要ファイルを削除、または集計期間が進むまで待機。
503 FILE_STORAGE_UNAVAILABLE保存やメタデータ処理の失敗。一覧を確認してから再試行。

タイムアウトしてもアップロードが完了している場合があります。一般的な冪等性の保証はなく、再送すると重複して枠を消費します。中断時の uploading レコードは一覧で確認し、作成から 5 分後に削除できます。認証や一般的なレート制限はエラーコード資料を参照してください。

保存と利用

公開 API のファイルは COS の 1 日ライフサイクル規則で非同期に削除されます。ready は現時点の存在を保証しません。上流への各試行で生成する署名 URL は 5 分間有効です。アップロードは永続化を伴い、ゼロデータモードの対象外です。モデルの受け入れ可否は上流の能力に依存します。

アップロードと参照ガイド · GET /v1/files · DELETE /v1/files/{file_id}

ファイルをアップロード · ドキュメント · InOneAPI