基于 URL 上传文件

POST

/api/open/api/v1/upload/url

限频：1

每个用户/每个API/每秒钟内请求 1 次，超出频率的请求会被拦截掉。

配额：200 次/天

调用成功才计为 1 次，即：每天可以上传 200 个文件（含图片、音频、PDF等）

限制

类型	文件大小检测	MIME检测
图片	小于 30MB	image/gif image/jpeg image/jpg image/png image/webp
音频	小于 100MB	audio/mpeg audio/mp4 audio/x-m4a audio/m4a audio/mp4a-latm
PDF	小于 50MB	application/pdf application/x-pdf

声明

原理和本地文件上传类似，只是由墨问完成了远程文件的下载，而后上传到墨问。受限于远程文件的下载速度（可能会超时）、在墙外不可访问，或者远程站点有自己的防盗链、防下载机制等等原因，并不能保证一定会成功。开发者应该有自己的容错机制。

不建议使用 URL 的方式远程上传较大的文件。

请求参数

Header 参数

Body 参数application/json

示例

{
    "fileType": 0,
    "url": "string",
    "fileName": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/open/api/v1/upload/url' \
--header 'Authorization: Bearer {{API-KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fileType": 0,
    "url": "string",
    "fileName": "string"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "file": {
        "uid": "string",
        "fileId": "string",
        "name": "string",
        "path": "string",
        "type": 0,
        "format": "string",
        "extra": "string",
        "size": "string",
        "mime": "string",
        "hash": "string",
        "url": "string",
        "styleUrls": {
            "property1": "string",
            "property2": "string"
        },
        "risky": true
    }
}

🔴500服务器错误

修改于 2026-03-22 07:48:07

文件投递示例

GoogleProtobufAny