文件上传 API

MuAPI 提供统一的媒体素材上传接口，可上传图像和视频，并将其作为各种 AI 模型和工作流的输入。

端点

1. 直接上传文件

POST /upload_file

使用 multipart/form-data 直接上传文件。

请求：

  • 方法： POST
  • 身份验证： x-api-key 请求头
  • Content-Type： multipart/form-data
  • 请求体： file（要上传的文件）

限制：

  • 图像： 10MB（格式：.jpg、.png、.webp 等）
  • 视频： 50MB（格式：.mp4、.mov 等）

示例（Curl）：

curl -X POST "https://api.muapi.ai/api/v1/upload_file" \
     -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: multipart/form-data" \
     -F "file=@/path/to/your/image.jpg"

示例（Python）：

import requests

url = "https://api.muapi.ai/api/v1/upload_file"
headers = {"x-api-key": "YOUR_API_KEY"}
files = {"file": open("image.jpg", "rb")}

response = requests.post(url, headers=headers, files=files)
print(response.json())

响应：

{
  "url": "https://s3.amazonaws.com/muapi-assets/outputs/abc123_image.jpg"
}

使用要求

  • 身份验证： 所有请求都必须使用有效的 API Key 进行身份验证。
  • 积分余额： 文件上传免费（不会扣除积分），但使用这些端点时账户积分余额必须大于 0。这样可以防止滥用并确保服务稳定。
  • 有效期： 预签名 URL 在 1 小时后过期。上传的文件通常只会临时保存，用于后续 AI 生成任务。

支持的文件类型

类别大小限制常见扩展名
图像10 MB.jpg、.png、.webp
视频50 MB.mp4、.mov
其他10 MB.zip、.pdf、.json
文件上传 API — Muapi Docs