图片上传

开发环境

http://dev-cn.your-api-server.com

POST

/api/file/card_image/upload

在讲解卡中上传图片。

使用限制

频率限制：单个 appID 调用上限为 50 次/秒。

容量限制：单个 appID 图片容量为 10000 张。（如果需要更大容量，请跟我们联系）

注意⚠️：单次上传仅支持上传单张图片。

请求 Multipart part

其中 part 的 header 细节:

image_id的 part header 如 Content-Disposition: form-data;name="image_id"。

image_file的 part header 如下：

Content-Disposition: form-data; name="image_file"; filename="xxxxx"

Content-Type: image/jpeg

图片类型支持：jpg、jpeg、 png。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/api/file/card_image/upload' \
--header 'X-Token: xxxxxxxxxx' \
--form 'image_file="/Users/bytedance/images/123456.png"' \
--form 'image_id="123456"'

响应示例

200 - 成功示例

{
    "status": 1
}

请求参数

Header 参数

X-Token

string

必需

通过接口获取的 access_token。详情可参考：getAccessToken

示例值:

xxxxxxxxxx

Content-Type

string

必需

必须为：multipart/form-data

Body 参数multipart/form-data

image_file

string

必需

大小限制不要超过 5M。

示例值:

/Users/bytedance/images/123456.png

image_id

string

必需

图片 ID，需保证唯一性。
当图片 ID 内容在审核中或者审核失败时，可以复用该ID重新上传；
当图片 ID 内容审核通过后，即使删除了该ID的图片，该ID也不能够再次用于上传图片。
特别地，我们将使用 ID 为"default"的图片作为默认图片。默认图片将会替换讲解卡中的无效图片（如已删除的图片）作为显示。

示例值:

123456

返回响应

🟢200成功

application/json

Body

status

integer

必需

图片状态。可选值如下： 1-上传成功，2-审核中，3-审核通过，4-审核失败，5-异常错误，6-已删除

🟠400请求有误

修改于 2023-12-05 08:06:10

查询短视频锚点配置修改记录及状态

图片审核状态查询

图片上传

使用限制#

请求 Multipart part#

请求参数

返回响应

使用限制

请求 Multipart part