---
title: "Base64 File Upload"
method: POST
path: "/api/v1/files/upload/base64"
tags: ["File Upload"]
---

# Base64 File Upload

`POST /api/v1/files/upload/base64`

- Supports Base64 encoding and Data URL formats
- Automatically identifies file types and categorizes storage
- Returns accessible file URLs and download links
- Files will expire after 72 hours
- Current user quota is limited. Uploads will fail when quota is exhausted. Please save locally if persistent storage is needed

**Note:**
The file upload API base URL is`https://files-api.evolink.ai`

## Request body

- Base64UploadRequest
  - `base64_data` string, required — Base64 encoded file data **Supported Formats:** - Data URL format: `data:image/png;base64,iVBORw0KGgo...` - Pure Base64 encoding: `iVBORw0KGgo...` **Note:** - Maximum `1` image per request - Currently supports uploading files in: `image/jpeg`, `image/png`, `image/gif`, `image/webp` formats only
  - `upload_path` string — Custom upload path **Note:** - If not specified, system will automatically categorize based on file type
  - `file_name` string — Custom file name **Note:** - If not specified, system will automatically generate a unique file name

## Response `200`

File uploaded successfully

- FileUploadResponse
  - `success` boolean — Whether the request was successful
  - `code` integer — Response status code
  - `msg` string — Response message
  - `data` FileData
    - `file_id` string — Unique file identifier
    - `file_name` string — Stored file name
    - `original_name` string — Original file name
    - `file_size` integer — File size (bytes)
    - `mime_type` string — File MIME type
    - `upload_path` string — File storage path
    - `file_url` string, uri — File access URL
    - `download_url` string, uri — File download URL
    - `upload_time` string, date-time — Upload time (ISO 8601 format)
    - `expires_at` string, date-time — File expiration time (ISO 8601 format)

---

[API](https://skmtc.dev/evolink/apis/get-credits-usage-api.md) · [All operations](https://skmtc.dev/evolink/apis/get-credits-usage-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evolink/get-credits-usage-api/revisions/88edb0ec881f/schema)