搜索 VisionStory 开发者文档

没有找到匹配的文档“”。

可以尝试功能或资源名称,例如

VisionStory开发者

列出素材

GET/api/v1/assets

列出已上传的素材,按时间从新到旧排列。使用上一页的 next_cursor 分页(next_cursor=0 表示没有更多页面),可选按 kindimage / video / audio)筛选。

请求头

X-API-Keystring必填

你的 VisionStory API Key(sk-vs-...),请仅保存在服务端。可在 API Key 管理 中创建或管理,需要 Pro 或更高方案。

查询参数

kindstring | null

按媒体类型筛选。省略时返回所有类型的素材。

可选值: imagevideoaudio

cursorinteger

上一页返回的 next_cursor 分页游标。省略或传入 0 时,从最新素材开始查询。

默认值: 0

limitinteger

每页最多返回的素材数,范围为 1–100,默认 20。

默认值: 20

响应

200请求成功

application/json

dataGetAssetsResponse | null必填可为空

当前接口的响应数据,字段定义见该接口的响应结构。仅当操作不返回数据时为 null。

assetsAssetDto[]必填

当前账户上传的素材,按时间从新到旧排列。

asset_idstring必填

素材的唯一标识符,在生成请求中作为 asset_id 引用。

created_atinteger

素材上传时的 Unix 时间戳,单位为秒。

默认值: 0

duration_secnumber

视频或音频素材的时长,单位为秒;图像为 0。

默认值: 0

heightinteger

图像或视频素材的像素高度;不适用时为 0。

默认值: 0

kindstring必填

识别出的媒体类型,为 image / video / audio 之一。

mimestring

识别出的素材 MIME 类型,例如 image/png

默认值:

widthinteger

图像或视频素材的像素宽度;不适用时为 0。

默认值: 0

next_cursorinteger

获取下一页的游标,将其作为 cursor 传回。0 表示没有更多页面。

默认值: 0

messagestring

便于阅读的状态消息;调用成功时为 "success"

默认值: success

server_timestring · date-time必填

服务端生成响应时的时间戳,使用 ISO 8601 格式(UTC)。

default错误响应。所有失败均使用统一结构:error 对象包含数字错误码 code、便于阅读的 message、可选的 details 字符串,以及提供后续处理建议的可选 hint(便于 AI Agent 使用)。

application/json

errorErrorDetail必填
codeinteger必填

机器可读的错误码。传输层失败时对应 HTTP 状态码(例如 401、404、422、500),其他情况可能使用业务专用错误码。

detailsstring | null可为空

可选的结构化错误详情,例如 422 响应中逐字段校验错误的 JSON 字符串。无补充信息时不返回。

hintstring | null可为空

供用户和 AI Agent 参考的错误处理建议,例如如何修正请求或在哪里获取 API Key。可能不返回此字段。

messagestring必填

便于阅读的错误原因说明,可安全记录到日志或展示给最终用户;此返回值未本地化。