通过 URL 上传

上传图像之前，请检查支持的格式和尺寸列表，确认您的图像将被接受。

您可以使用 Images API 使用图像的 URL 而不是上传数据。

使用以下示例作为参考发出 POST 请求。请注意 --form 'file=<FILE>' 和 --form 'url=<URL>' 字段是互斥的。

curl --request POST \
https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1 \
--header "Authorization: Bearer <API_TOKEN>" \
--form 'url=https://[user:password@]example.com/<PATH_TO_IMAGE>' \
--form 'metadata={"key":"value"}' \
--form 'requireSignedURLs=false'

成功上传图像后，您将收到类似于以下示例的响应。

{
	"result": {
		"id": "2cdc28f0-017a-49c4-9ed7-87056c83901",
		"filename": "image.jpeg",
		"metadata": {
			"key": "value"
		},
		"uploaded": "2022-01-31T16:39:28.458Z",
		"requireSignedURLs": false,
		"variants": [
			"https://imagedelivery.net/Vi7wi5KSItxGFsWRG2Us6Q/2cdc28f0-017a-49c4-9ed7-87056c83901/public",
			"https://imagedelivery.net/Vi7wi5KSItxGFsWRG2Us6Q/2cdc28f0-017a-49c4-9ed7-87056c83901/thumbnail"
		]
	},
	"success": true,
	"errors": [],
	"messages": []
}

如果源站服务器在获取图像时返回错误，API 响应将返回 4xx 错误。