メインコンテンツへスキップ
POST
/
api
/
v1
/
files
/
upload
/
url
URL ファイルアップロード
curl --request POST \
  --url https://files-api.evolink.ai/api/v1/files/upload/url \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_url": "https://example.com/image.jpg"
}
'
{
  "success": true,
  "code": 200,
  "msg": "ファイルのアップロードに成功しました",
  "data": {
    "file_id": "file_abc123",
    "file_name": "downloaded.jpg",
    "original_name": "downloaded.jpg",
    "file_size": 2048,
    "mime_type": "image/jpeg",
    "upload_path": "downloads",
    "file_url": "https://files.evolink.ai/downloads/downloaded.jpg",
    "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

ボディ

application/json
​
file_url
string<uri>
必須

リモートファイルURL

要件：

  • 公開アクセス可能なURLである必要があります
  • HTTPおよびHTTPSプロトコルをサポート
  • システムがこのURLからファイルコンテンツを自動的にダウンロードします
  • 1リクエストにつき最大1画像
  • 現在、image/jpeg、image/png、image/gif、image/webp形式のファイルのみアップロード可能
例:

"https://example.com/image.jpg"

​
upload_path
string

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

注意：

  • 指定しない場合、システムがファイルタイプに基づいて自動的に分類します
例:

"downloads"

​
file_name
string

カスタムファイル名

注意：

  • 指定しない場合、システムが自動的に一意のファイル名を生成します
例:

"downloaded.jpg"

レスポンス

200 - application/json

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

​
success
boolean

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

例:

true

​
code
integer

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

例:

200

​
msg
string

レスポンスメッセージ

例:

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

​
data
object