跳转到主要内容
POST
/
v1
/
uploads
/
images
curl --request POST \
  --url https://api.apimart.ai/v1/uploads/images \
  --header 'Authorization: Bearer <token>' \
  --form 'file=@/path/to/your/image.jpg'

{
  "url": "https://upload.apimart.ai/f/image/9990000123456-a1b2c3d4-photo.jpg",
  "filename": "photo.jpg",
  "content_type": "image/jpeg",
  "bytes": 235680,
  "created_at": 1743436800
}
文档 Playground 不支持文件上传：请使用下方的 cURL、Python 或 JavaScript 代码示例进行测试。
重要变更： 为了更好的性能和成本控制，我们不再支持在生成接口中直接传入 base64 图片数据。请使用本接口上传图片，获取 URL 后再调用生成接口。

​
为什么需要先上传图片？

  1. 性能优化 - base64 编码会使数据膨胀 33%，先上传可显著减少请求体大小
  2. 复用图片 - 上传一次，URL 可多次使用，无需重复传输

​
使用流程

curl --request POST \
  --url https://api.apimart.ai/v1/uploads/images \
  --header 'Authorization: Bearer <token>' \
  --form 'file=@/path/to/your/image.jpg'

{
  "url": "https://upload.apimart.ai/f/image/9990000123456-a1b2c3d4-photo.jpg",
  "filename": "photo.jpg",
  "content_type": "image/jpeg",
  "bytes": 235680,
  "created_at": 1743436800
}

​
Authorizations

​
Authorization
string
必填
所有接口均需要使用Bearer Token进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
Body

​
file
file
必填
图片文件支持格式：JPEG (.jpg, .jpeg)、PNG (.png)、WebP (.webp)、GIF (.gif)最大文件大小：20MB

​
Response

​
url
string
图片的公开访问 URL，可直接用于生成接口（72 小时有效）
​
filename