SuperAPI AI 工具集

image-files

设计与创作

查看项目

更新于 10-15 23:32

技能介绍

用途:列出并浏览存储在 Lab Nocturne 上的已上传图片,查看文件名、大小、类型和 CDN URL,支持分页与排序,面向 AI 图像资产管理场景。

主要能力:通过 /files 命令或自然语言触发(如“列出我托管的图片”“显示我的图片上传”)。支持参数:limit(1-100,默认 100)、offset(默认 0)、sort(uploaded_at_desc 默认、uploaded_at_asc、size_desc、size_asc)。自然语言可映射排序,如“最新优先”对应 uploaded_at_desc,“最大优先”对应 size_desc;请求“第 N 页”时 offset 按 (N-1)*limit 计算。

使用方式:先按 references/auth.md 解析 API key 与 base URL,再执行: curl -s -w '\n%{http_code}'
-H "Authorization: Bearer <api_key>"
"<base_url>/files?limit=<limit>&offset=<offset>&sort=<sort>" 最后一行解析为 HTTP 状态码,之前内容为响应体。成功(HTTP 200)返回 files 数组(含 id、url、filename、size、mime_type、uploaded_at)与 pagination(total、limit、offset、next)。展示时每个文件显示 ID、文件名、人类可读大小、类型、相对上传时间,并显示“Showing X-Y of Z files”;若存在 pagination.next,提示用 /files page 2 查看下一页;列表为空则提示尚无上传文件,建议使用 /upload <path>。

限制:错误码见 references/auth.md;若服务器返回非 JSON 或异常 HTTP 状态,提示 API 可能暂时不可用。其他功能、收费与平台信息暂未提供。