基于 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 参数

Authorization

string

可选

默认值:

Bearer {{API-KEY}}

Body 参数application/json

fileType

integer

可选

文件类型：必填
1-图片 2-音频 3-PDF

url

string

文件URL

可选

fileName

string

可选

文件名称：选填（未填时，系统生成）

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

file

object

文件信息

可选

uid

string

用户 ID

可选

fileId

string

文件 ID

可选

name

string

文件名

可选

path

string

文件路径

可选

type

integer <sint32>

可选

文件类型 1-图片 2-音频 3-PDF

format

string

文件格式

可选

extra

string

文件附加信息

可选

size

string

文件大小

可选

mime

string

文件 MIME

可选

hash

string

文件 Hash

可选

url

string

文件 URL

可选

styleUrls

object

缩略图 URLs

可选

risky

boolean

是否有风险

可选

示例

{
    "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服务器错误