进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读

第70章 如何通过预签名 URL 上传图片

如何通过预签名 URL 上传图片

简介

上传初始图像(init image)或数据集图像的 API 端点会返回一个预签名 URL。请使用该 URL 将图像文件上传至 S3。整体流程如下:

  • 调用 API 端点创建新的初始图像或数据集图像。响应中会包含一个预签名 URL,用于上传图像文件。
  • 使用返回的预签名 URL 发起 POST 请求,请求体需携带上一步响应中的所有字段。注意:该请求必须使用 multipart 文件形式,而非 application/json。由于预签名 URL 的有效期仅为 2 分钟,务必在生成后的 2 分钟内完成调用。
  • 在表单中新增一个参数用于提交二进制文件。该参数必须是数据流、缓冲区(buffer)或字节(bytes)类型,不支持其他编码或 base64。
  • 图像格式必须与传递给初始图像方法的扩展名一致,且需缩放至生成方法所规定的最大边界和宽高比范围内,否则图像可能会变形。
  • 最后,调用生成方法,并传入初始图像方法返回的 init image id。

以下是使用图像上传 API 端点时的响应示例:

{
  "uploadDatasetImage": {
    "id": "1234-1234-1234-1234", // 这是最终步骤中使用的初始图像 ID
    "fields": "{\"example\": \"fields\"}",
    "key": "users/1234-1234-1234-1234/datasets/1234-1234-1234-1234/images/1234-1234-1234-1234/example.png",
    "url": "https://example.com/"
  }
}

以下是基于上述响应的图像上传实现示例:

TypeScript 示例:

const uploadDatasetImage = async (file: File, response: any) => {
	const rawFields = response.uploadDatasetImage.fields;
	const fields = JSON.parse(rawFields);
	const url = response.uploadDatasetImage.url;

	const formData = new FormData();

	Object.entries({ ...fields, file }).forEach(([key, value]) => {
		formData.append(key, value as string);
	})

	const request = new XMLHttpRequest();
	request.open('POST', url);

	const result = await request.send(formData);
}

Python 示例:

import json
import requests

def upload_dataset_image(image_file_path: str, response: requests.models.Response) -> requests.models.Response:
    """ 
    通过预签名 URL 将图像文件上传到 Leonardo.ai 数据集。
       
    :image_file_path: 要上传的图像文件路径
    :response: 请求 datasets/{datasetId}/upload 端点后的响应
    """
       
    fields = json.loads(response.json()['uploadDatasetImage']['fields'])
    url = response.json()['uploadDatasetImage']['url']
    files = {'file': open(image_file_path, 'rb')}
       
    return requests.post(url, data=fields, files=files)

更新于约 1 年前 此页面是否有帮助?

评论 (0)