メインコンテンツへスキップ
POST
/
api
/
v1
/
files
/
upload
/
stream
ファイルストリームアップロード
curl --request POST \
  --url https://files-api.evolink.ai/api/v1/files/upload/stream \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'
{
  "success": true,
  "code": 200,
  "msg": "ファイルのアップロードに成功しました",
  "data": {
    "file_id": "file_abc123",
    "file_name": "photo.png",
    "original_name": "photo.png",
    "file_size": 2048,
    "mime_type": "image/png",
    "upload_path": "photos",
    "file_url": "https://files.evolink.ai/photos/photo.png",
    "download_url": "https://files.evolink.ai/api/v1/files/download/file_abc123",
    "upload_time": "2025-10-09T00:00:00+08:00",
    "expires_at": "2025-10-12T00:00:00+08:00"
  }
}

承認

​
Authorization
string
header
必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得：

APIキー管理ページにアクセスしてAPIキーを取得してください

リクエストヘッダーに追加：

Authorization: Bearer YOUR_API_KEY

ボディ

multipart/form-data
​
file
file
必須

ファイルバイナリデータ

注意：

  • form-data形式でアップロード
  • システムがファイルタイプを自動識別
  • リクエストあたり最大1枚の画像
  • 現在アップロード可能なファイル形式：image/jpeg、image/png、image/gif、image/webpのみ
​
upload_path
string

カスタムアップロードパス

注意：

  • アンダースコア命名に対応：upload_path
  • キャメルケース命名に対応：uploadPath
  • 指定しない場合、システムがファイルタイプに基づいて自動的に分類します
例:

"photos"

​
file_name
string

カスタムファイル名

注意：

  • アンダースコア命名に対応：file_name
  • キャメルケース命名に対応：fileName
  • 指定しない場合、システムが自動的に一意のファイル名を生成します
例:

"photo.png"

レスポンス

200 - application/json

ファイルのアップロードに成功しました

​
success
boolean

リクエストが成功したかどうか

例:

true

​
code
integer

レスポンスステータスコード

例:

200

​
msg
string

レスポンスメッセージ

例:

"ファイルのアップロードに成功しました"

​
data
object