跳转到内容
中文
获取 API 密钥
API 指南

文件

以 Markdown 查看 已更新

接受图像、视频或音频的模型支持三种形式。每个模型页面都会标记其文件参数（例如 image、images、videos、audios）。

1. 公开 URL

模型可以下载的任何 https://（或 http://）URL：

JSON
{ "image": "https://example.com/photos/product.jpg" }

文件必须无需 Cookie 或登录即可访问，并且在请求开始前保持可访问。每个模型页面都会列出其文件参数的大小和尺寸限制。

2. 数据 URI

小型文件可以内嵌为最大 10 MB 的 data: URI：

JSON
{ "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." }

Base64 会使请求体比文件大约增加三分之一，因此较大文件应优先使用上传。

3. 上传

对于本地文件，请获取上传 URL，向其 PUT 字节数据，然后将返回的 file_url 传给模型。创建上传 URL 是免费的。

1 · 获取上传 URL
curl -X POST "https://api.doitong.com/v1/files" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "product.jpg", "content_type": "image/jpeg", "size": 482113}'
201 Created · 上传
{
  "object": "upload",
  "upload_url": "https://…signed upload URL…",
  "file_url": "https://content.doitong.com/…/product.jpg",
  "method": "PUT",
  "headers": { "Content-Type": "image/jpeg" },
  "content_type": "image/jpeg",
  "expires_in": 3600,
  "max_bytes": 15728640
}
2 · 使用完全相同的返回标头上传字节数据
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · 将 file_url 用作模型输入
curl -X POST "https://api.doitong.com/v1/run/{model_id}?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://content.doitong.com/…/product.jpg", "prompt": "..."}'
  • 支持的上传格式：.jpg、.jpeg、.png、.webp（最大 15 MB）以及 .mp4、.mov、.webm（最大 200 MB）。扩展名决定类型；content_type 必须与其匹配。
  • 上传 URL 的有效期为一小时。file_url 会保持有效。
  • 对于音频，请使用公开 URL 或数据 URI。

输出文件

你可以选择输出文件的保留时长：

  • 永久（permanent，默认）：直到你删除它们；每 GB 每月 100 API 积分（$0.10），每天从 API 余额中扣费（1 GB = 1024³ 字节）。
  • 7 天（temporary）：免费，然后从我们的存储中删除。

在控制台中使用“永久保存文件”开关，或使用 PATCH /account/storage 设置默认值；也可以通过 ?storage=temporary（或 permanent）按运行覆盖：

终端
curl -X PATCH "https://api.doitong.com/v1/account/storage" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "temporary"}'

每个请求都会显示自己的 storage（mode、bytes、expires_at、expired）。该设置仅适用于新请求；已永久保留的文件会一直存在，直到你使用 DELETE /requests/{id}/files 删除它们（参见请求）。如果 API 余额无法支付存储费用，你会收到邮件，并有 30 天时间充值，然后保留的文件会变为临时文件。