Cloudinary Upload API — 媒体资产上传
CloseCloudinary Upload API — 媒体资产上传
官方 Upload API 提供上传及资产相关动作,REST 上传使用 POST /:resource_type/upload,目标云名、资源类型和区域需按账户确定。支持服务端 Basic/签名认证及受 preset 限制的 unsigned 上传;未上传文件或执行资产变更。
Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.
- Stable ID
- cap-44edf7738cb33289be010bfc
- Card version
- 2
- Updated
- 2026-10-24T18:31:50.9778878+00:00
- Ownership state
- unclaimed
- Processing
- unknown
- Evidence level
- unknown
- Business execution
- unknown
Keep this fixed version · Original public source · Complete machine record
Published description
默认接口模板为 https://api.cloudinary.com/v1_1/:cloud_name/:action,上传动作另含 resource_type。SDK 封装请求和认证;普通 REST 调用需要自行按所选方式提供认证。file 输入可含 SDK 本地文件路径等受支持来源;unsigned 上传必须使用预配置 upload_preset,并非任意匿名写入。此 API 还包含 explicit、rename、destroy 等修改/删除动作,不能视为纯读接口。页面提醒响应将来可能增加字段,解析应兼容未知字段。
Inputs
- 具体 Cloudinary cloud_name、resource_type 及账户区域
- 受支持的文件来源和上传参数
- 服务端 API key/secret 或签名;unsigned 路线需已配置 upload_preset
Outputs
- 操作执行信息及相关资产数据的 JSON 响应,未实际获取
- 上传后资产标识与交付信息依具体端点和参数确认
Invocation and authentication
unknown
{
"authentication": {
"kind": "api_key",
"notes": "\u670D\u52A1\u7AEF\u652F\u6301 API key\u002BAPI secret \u7684 HTTP Basic\uFF08\u672C\u9875\u63A8\u8350\uFF09\u6216\u5E26 timestamp \u7684 SHA \u7B7E\u540D\uFF1B\u5BA2\u6237\u7AEF\u53E6\u53EF\u4F7F\u7528\u5141\u8BB8 unsigned \u7684 upload_preset\u3002\u5404\u65B9\u5F0F\u6761\u4EF6\u4E0D\u540C\uFF0C\u4E0D\u89C6\u4E3A\u65E0\u8BA4\u8BC1\u901A\u7528\u5199\u5165\u53E3\u3002"
},
"command": null,
"entry_url": null,
"kind": "http_api",
"method": "POST",
"requirements": [
"\u9009\u62E9\u5B9E\u9645\u8D26\u6237 cloud_name\u3001resource_type\u3001\u533A\u57DF\u548C\u5177\u4F53\u52A8\u4F5C",
"\u5B89\u5168\u4FDD\u5B58 secret\uFF1B\u6309\u65B9\u5F0F\u751F\u6210\u7B7E\u540D\u6216\u4F7F\u7528\u9884\u5148\u5141\u8BB8\u7684 preset",
"\u6838\u5BF9\u8D44\u4EA7\u4E0A\u4F20/\u4FEE\u6539/\u5220\u9664\u526F\u4F5C\u7528\u4E0E\u8D26\u6237\u9650\u5236"
]
}Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.
Third-party pricing and data handling
{
"model": "unknown",
"notes": "\u6B63\u6587\u5C06 EU/AP \u6570\u636E\u4E2D\u5FC3\u6807\u4E3A premium feature\uFF0C\u4F46\u672A\u7ED9\u5F53\u524D\u8D26\u6237\u4E0A\u4F20\u3001\u8F6C\u6362\u3001\u5B58\u50A8\u3001\u6D41\u91CF\u6216\u514D\u8D39\u989D\u5EA6\u7684\u5B8C\u6574\u4EF7\u683C\u3002\u5BFC\u822A\u4E2D\u7684\u8BD5\u7528\u5BA3\u4F20\u4E0D\u4F5C\u514D\u8D39\u4FDD\u8BC1\u3002",
"source_url": null
}{
"location": "provider_server",
"notes": "\u4E0A\u4F20\u8D44\u4EA7\u53D1\u9001\u5230 Cloudinary \u4EA7\u54C1\u73AF\u5883\u3002\u6B63\u6587\u79F0\u9ED8\u8BA4\u8D26\u6237\u4F7F\u7528\u7F8E\u56FD\u6570\u636E\u4E2D\u5FC3\uFF0CEU/AP \u53EF\u53E6\u914D\u7F6E\u4E14\u4E3A premium\uFF1B\u4E0D\u80FD\u636E\u6B64\u4FDD\u8BC1\u5177\u4F53\u8D26\u6237\u7684\u9A7B\u7559\u3001\u4FDD\u5BC6\u6216\u4FDD\u7559\u671F\u3002"
}Unknown is not a claim that a service is free, anonymous, private or unavailable.
Limitations
- 没有上传文件、生成签名、调用 API 或修改/删除资产。
- entry_url 保持空:实际 URL 含账户 cloud_name、资源类型和区域,不能把模板当可直接调用的已配置入口。
- unsigned 只限允许的 preset 和参数,不代表公共无限制上传。
- API secret 不得暴露在公开客户端代码;本轮未读取或保存任何账户凭据。
- 资源大小、格式、转换及速率等限制可能依端点和套餐,本次没有确定统一数字。
- SDK 的本地路径输入不是普通远端 REST 服务可直接读取任意本机路径的承诺。
Unknowns
- 实际账户 host、完整单端点 schema、文件上限和数值速率未知。
- 未验证任何上传、转换、交付、删除或客户端能力。
- v1_1 为接口模板代际,不是本地安装版本;现有账户套餐和计费未知。
Fixed profiles, conditions and evidence
Read state: not_checked; review state: unknown. Do not combine different profiles.
资料与来源声明不等于本站实测;未列出的条件仍未知。
结构化配方只按公开声明检查约束与接口,不执行任务或授予权限;缺失记录保持未知,接口兼容不证明实际成功。
Contributor-reported verification
{
"checked_at": "2026-10-24T18:28:34.2692697\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://cloudinary.com/documentation/image_upload_api_reference"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.
Dynamic observations and corrections
null
null
Add a public correction or observation
Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.
Propose a sourced summary correction
Report a conditional public observation
Complete fixed public record and original source fields
This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.
{
"author_name": null,
"availability": "unknown",
"callability": "documentation_only",
"category": "development",
"data_handling": {
"location": "provider_server",
"notes": "\u4E0A\u4F20\u8D44\u4EA7\u53D1\u9001\u5230 Cloudinary \u4EA7\u54C1\u73AF\u5883\u3002\u6B63\u6587\u79F0\u9ED8\u8BA4\u8D26\u6237\u4F7F\u7528\u7F8E\u56FD\u6570\u636E\u4E2D\u5FC3\uFF0CEU/AP \u53EF\u53E6\u914D\u7F6E\u4E14\u4E3A premium\uFF1B\u4E0D\u80FD\u636E\u6B64\u4FDD\u8BC1\u5177\u4F53\u8D26\u6237\u7684\u9A7B\u7559\u3001\u4FDD\u5BC6\u6216\u4FDD\u7559\u671F\u3002"
},
"description": "\u9ED8\u8BA4\u63A5\u53E3\u6A21\u677F\u4E3A https://api.cloudinary.com/v1_1/:cloud_name/:action\uFF0C\u4E0A\u4F20\u52A8\u4F5C\u53E6\u542B resource_type\u3002SDK \u5C01\u88C5\u8BF7\u6C42\u548C\u8BA4\u8BC1\uFF1B\u666E\u901A REST \u8C03\u7528\u9700\u8981\u81EA\u884C\u6309\u6240\u9009\u65B9\u5F0F\u63D0\u4F9B\u8BA4\u8BC1\u3002file \u8F93\u5165\u53EF\u542B SDK \u672C\u5730\u6587\u4EF6\u8DEF\u5F84\u7B49\u53D7\u652F\u6301\u6765\u6E90\uFF1Bunsigned \u4E0A\u4F20\u5FC5\u987B\u4F7F\u7528\u9884\u914D\u7F6E upload_preset\uFF0C\u5E76\u975E\u4EFB\u610F\u533F\u540D\u5199\u5165\u3002\u6B64 API \u8FD8\u5305\u542B explicit\u3001rename\u3001destroy \u7B49\u4FEE\u6539/\u5220\u9664\u52A8\u4F5C\uFF0C\u4E0D\u80FD\u89C6\u4E3A\u7EAF\u8BFB\u63A5\u53E3\u3002\u9875\u9762\u63D0\u9192\u54CD\u5E94\u5C06\u6765\u53EF\u80FD\u589E\u52A0\u5B57\u6BB5\uFF0C\u89E3\u6790\u5E94\u517C\u5BB9\u672A\u77E5\u5B57\u6BB5\u3002",
"inputs": [
"\u5177\u4F53 Cloudinary cloud_name\u3001resource_type \u53CA\u8D26\u6237\u533A\u57DF",
"\u53D7\u652F\u6301\u7684\u6587\u4EF6\u6765\u6E90\u548C\u4E0A\u4F20\u53C2\u6570",
"\u670D\u52A1\u7AEF API key/secret \u6216\u7B7E\u540D\uFF1Bunsigned \u8DEF\u7EBF\u9700\u5DF2\u914D\u7F6E upload_preset"
],
"invocation": {
"authentication": {
"kind": "api_key",
"notes": "\u670D\u52A1\u7AEF\u652F\u6301 API key\u002BAPI secret \u7684 HTTP Basic\uFF08\u672C\u9875\u63A8\u8350\uFF09\u6216\u5E26 timestamp \u7684 SHA \u7B7E\u540D\uFF1B\u5BA2\u6237\u7AEF\u53E6\u53EF\u4F7F\u7528\u5141\u8BB8 unsigned \u7684 upload_preset\u3002\u5404\u65B9\u5F0F\u6761\u4EF6\u4E0D\u540C\uFF0C\u4E0D\u89C6\u4E3A\u65E0\u8BA4\u8BC1\u901A\u7528\u5199\u5165\u53E3\u3002"
},
"command": null,
"entry_url": null,
"kind": "http_api",
"method": "POST",
"requirements": [
"\u9009\u62E9\u5B9E\u9645\u8D26\u6237 cloud_name\u3001resource_type\u3001\u533A\u57DF\u548C\u5177\u4F53\u52A8\u4F5C",
"\u5B89\u5168\u4FDD\u5B58 secret\uFF1B\u6309\u65B9\u5F0F\u751F\u6210\u7B7E\u540D\u6216\u4F7F\u7528\u9884\u5148\u5141\u8BB8\u7684 preset",
"\u6838\u5BF9\u8D44\u4EA7\u4E0A\u4F20/\u4FEE\u6539/\u5220\u9664\u526F\u4F5C\u7528\u4E0E\u8D26\u6237\u9650\u5236"
]
},
"limitations": [
"\u6CA1\u6709\u4E0A\u4F20\u6587\u4EF6\u3001\u751F\u6210\u7B7E\u540D\u3001\u8C03\u7528 API \u6216\u4FEE\u6539/\u5220\u9664\u8D44\u4EA7\u3002",
"entry_url \u4FDD\u6301\u7A7A\uFF1A\u5B9E\u9645 URL \u542B\u8D26\u6237 cloud_name\u3001\u8D44\u6E90\u7C7B\u578B\u548C\u533A\u57DF\uFF0C\u4E0D\u80FD\u628A\u6A21\u677F\u5F53\u53EF\u76F4\u63A5\u8C03\u7528\u7684\u5DF2\u914D\u7F6E\u5165\u53E3\u3002",
"unsigned \u53EA\u9650\u5141\u8BB8\u7684 preset \u548C\u53C2\u6570\uFF0C\u4E0D\u4EE3\u8868\u516C\u5171\u65E0\u9650\u5236\u4E0A\u4F20\u3002",
"API secret \u4E0D\u5F97\u66B4\u9732\u5728\u516C\u5F00\u5BA2\u6237\u7AEF\u4EE3\u7801\uFF1B\u672C\u8F6E\u672A\u8BFB\u53D6\u6216\u4FDD\u5B58\u4EFB\u4F55\u8D26\u6237\u51ED\u636E\u3002",
"\u8D44\u6E90\u5927\u5C0F\u3001\u683C\u5F0F\u3001\u8F6C\u6362\u53CA\u901F\u7387\u7B49\u9650\u5236\u53EF\u80FD\u4F9D\u7AEF\u70B9\u548C\u5957\u9910\uFF0C\u672C\u6B21\u6CA1\u6709\u786E\u5B9A\u7EDF\u4E00\u6570\u5B57\u3002",
"SDK \u7684\u672C\u5730\u8DEF\u5F84\u8F93\u5165\u4E0D\u662F\u666E\u901A\u8FDC\u7AEF REST \u670D\u52A1\u53EF\u76F4\u63A5\u8BFB\u53D6\u4EFB\u610F\u672C\u673A\u8DEF\u5F84\u7684\u627F\u8BFA\u3002"
],
"outputs": [
"\u64CD\u4F5C\u6267\u884C\u4FE1\u606F\u53CA\u76F8\u5173\u8D44\u4EA7\u6570\u636E\u7684 JSON \u54CD\u5E94\uFF0C\u672A\u5B9E\u9645\u83B7\u53D6",
"\u4E0A\u4F20\u540E\u8D44\u4EA7\u6807\u8BC6\u4E0E\u4EA4\u4ED8\u4FE1\u606F\u4F9D\u5177\u4F53\u7AEF\u70B9\u548C\u53C2\u6570\u786E\u8BA4"
],
"pricing": {
"model": "unknown",
"notes": "\u6B63\u6587\u5C06 EU/AP \u6570\u636E\u4E2D\u5FC3\u6807\u4E3A premium feature\uFF0C\u4F46\u672A\u7ED9\u5F53\u524D\u8D26\u6237\u4E0A\u4F20\u3001\u8F6C\u6362\u3001\u5B58\u50A8\u3001\u6D41\u91CF\u6216\u514D\u8D39\u989D\u5EA6\u7684\u5B8C\u6574\u4EF7\u683C\u3002\u5BFC\u822A\u4E2D\u7684\u8BD5\u7528\u5BA3\u4F20\u4E0D\u4F5C\u514D\u8D39\u4FDD\u8BC1\u3002",
"source_url": null
},
"provider_claimed": false,
"record_kind": "public_source",
"representative_queries": [],
"sources": [
{
"basis": "public_record",
"checked_at": "2026-10-24T18:28:34.2692697\u002B00:00",
"title": "Upload API Reference | Documentation",
"url": "https://cloudinary.com/documentation/image_upload_api_reference"
}
],
"summary": "\u5B98\u65B9 Upload API \u63D0\u4F9B\u4E0A\u4F20\u53CA\u8D44\u4EA7\u76F8\u5173\u52A8\u4F5C\uFF0CREST \u4E0A\u4F20\u4F7F\u7528 POST /:resource_type/upload\uFF0C\u76EE\u6807\u4E91\u540D\u3001\u8D44\u6E90\u7C7B\u578B\u548C\u533A\u57DF\u9700\u6309\u8D26\u6237\u786E\u5B9A\u3002\u652F\u6301\u670D\u52A1\u7AEF Basic/\u7B7E\u540D\u8BA4\u8BC1\u53CA\u53D7 preset \u9650\u5236\u7684 unsigned \u4E0A\u4F20\uFF1B\u672A\u4E0A\u4F20\u6587\u4EF6\u6216\u6267\u884C\u8D44\u4EA7\u53D8\u66F4\u3002",
"tags": [
"Cloudinary",
"\u5A92\u4F53\u4E0A\u4F20",
"REST API",
"\u56FE\u7247",
"\u8D44\u4EA7\u7BA1\u7406"
],
"terms_url": null,
"title": "Cloudinary Upload API \u2014 \u5A92\u4F53\u8D44\u4EA7\u4E0A\u4F20",
"unknowns": [
"\u5B9E\u9645\u8D26\u6237 host\u3001\u5B8C\u6574\u5355\u7AEF\u70B9 schema\u3001\u6587\u4EF6\u4E0A\u9650\u548C\u6570\u503C\u901F\u7387\u672A\u77E5\u3002",
"\u672A\u9A8C\u8BC1\u4EFB\u4F55\u4E0A\u4F20\u3001\u8F6C\u6362\u3001\u4EA4\u4ED8\u3001\u5220\u9664\u6216\u5BA2\u6237\u7AEF\u80FD\u529B\u3002",
"v1_1 \u4E3A\u63A5\u53E3\u6A21\u677F\u4EE3\u9645\uFF0C\u4E0D\u662F\u672C\u5730\u5B89\u88C5\u7248\u672C\uFF1B\u73B0\u6709\u8D26\u6237\u5957\u9910\u548C\u8BA1\u8D39\u672A\u77E5\u3002"
],
"verification": {
"checked_at": "2026-10-24T18:28:34.2692697\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://cloudinary.com/documentation/image_upload_api_reference"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
},
"schema_version": "navonavo.capability.v1",
"service_id": "cap-44edf7738cb33289be010bfc",
"version": 2,
"source_url": "https://cloudinary.com/documentation/image_upload_api_reference",
"ownership_state": "unclaimed",
"submitted_by": {
"kind": "importer",
"name": "NAVONAVO public material importer"
},
"submitter_identity_verified": false,
"source_check": {
"url": "https://cloudinary.com/documentation/image_upload_api_reference",
"final_url": "https://cloudinary.com/documentation/image_upload_api_reference",
"status_code": 200,
"title": "Upload API Reference | Documentation",
"description": null,
"checked_at": "2026-10-24T18:28:34.2692697\u002B00:00",
"warnings": [
"\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
]
},
"created_at": "2026-10-24T18:28:38.2119974\u002B00:00",
"updated_at": "2026-10-24T18:31:50.9778878\u002B00:00",
"read_url": "https://navonavo.com/api/v1/capabilities/cap-44edf7738cb33289be010bfc?version=2",
"page_url": "https://navonavo.com/capabilities/cap-44edf7738cb33289be010bfc?version=2",
"verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
"library_material": {
"organization": "organized",
"semantic_state": "classified",
"semantic_category": "\u5A92\u4F53\u8D44\u4EA7\u4E0A\u4F20 API",
"evidence_grade": "documentation_only",
"attachments": [
{
"material_id": "material-875109295c038161c8c7cdbcc6ad085a",
"source_url": "https://cloudinary.com/documentation/image_upload_api_reference",
"content_sha256": "d51e54eaaa68ab255e2aa2fcbc59f37d5ea8bea07b3c1069e5c22d25f86580fb",
"decoded_bytes": 886777,
"content_type": "text/html",
"captured_at": "2026-10-24T18:28:34.2692697\u002B00:00",
"text_representation": "decoded_text_utf8",
"text_utf8_sha256": "d51e54eaaa68ab255e2aa2fcbc59f37d5ea8bea07b3c1069e5c22d25f86580fb",
"text_utf8_bytes": 886777,
"capture_body_reconstructed": true,
"read_path": "/api/v1/capabilities/cap-44edf7738cb33289be010bfc/materials/material-875109295c038161c8c7cdbcc6ad085a?version=1"
}
]
},
"last_correction": {
"contribution_id": "contribution-325fa3cfb5d941dfaa506079e58ed19e",
"reason": "\u4EC5\u4F9D\u636E\u672C\u6B21\u5DF2\u4FDD\u5B58\u5B98\u65B9\u516C\u5F00\u6B63\u6587\u6574\u7406\u7528\u9014\u3001\u5165\u53E3\u3001\u6761\u4EF6\u548C\u672A\u77E5\u9879\uFF1B\u4FDD\u7559\u539F\u6587\u8BC1\u636E\uFF0C\u4E0D\u5C06\u8BF4\u660E\u6587\u6863\u5192\u5145\u5B9E\u9645\u63A5\u901A\u3001\u529F\u80FD\u5B9E\u6D4B\u6216\u53EF\u7528\u6027\u4FDD\u8BC1\u3002",
"source_urls": [
"https://cloudinary.com/documentation/image_upload_api_reference"
],
"reported_by": "contributor"
},
"version_read_basis": "archived_revision",
"deep_read": {
"schema_version": "navonavo.capability-read.v1",
"card_id": "cap-44edf7738cb33289be010bfc",
"card_version": 2,
"selected_profile_id": null,
"state": "not_checked",
"review_state": null,
"read_url": "https://navonavo.com/api/v1/capabilities/cap-44edf7738cb33289be010bfc?version=2",
"page_url": "https://navonavo.com/capabilities/cap-44edf7738cb33289be010bfc?version=2",
"profiles": [],
"warnings": [
"\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
"\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
]
}
}