SuperAPI AI 工具集

atlas-cloud-media

智能体与模型

查看项目

更新于 10-16 09:28

技能介绍

用途:当用户明确要求用 Atlas Cloud 生成图片或视频,或现有流程需要发起 Atlas Cloud 媒体生成请求时使用。不适用于 OpenAI 兼容的文本对话,其基础 URL 与契约不同。

主要能力:以 schema 优先方式发现模型,提交付费的图片或视频生成任务,对任务进行有截止时间的轮询,并在本地校验下载的输出文件。相关接口为:GET https://api.atlascloud.ai/api/v1/models 列出模型;POST https://api.atlascloud.ai/api/v1/model/generateImage 生成图片;POST https://api.atlascloud.ai/api/v1/model/generateVideo 生成视频;GET https://api.atlascloud.ai/api/v1/model/prediction/{id} 轮询任务。请求头使用 Authorization: Bearer $ATLASCLOUD_API_KEY 与 Content-Type: application/json。

使用方式:先确认用户授权与付费批准,要求环境中存在 ATLASCLOUD_API_KEY,并约定输出目录与生成类型。随后建立私有临时工作目录,获取公开模型目录,按类型筛选并读取模型 schema 校验参数,避免猜测 size、ratio、aspect_ratio、image、image_url 等模型专属字段。构建 JSON 请求体后提交一个任务,确认 .data.id 非空再每三秒轮询,成功状态为 completed 或 succeeded,failed 或 timeout 停止,最长十分钟。输出 URL 为临时链接,需及时下载;下载时不要携带 Atlas 认证头,并校验内容类型与大小,最后原子写入用户批准的目录。

限制:这是纯说明性技能,不附带已安装的客户端、脚本、队列或重试服务。可用模型、schema、价格与输出保留策略会变化,以在线目录为准。生成异步,可能耗时数分钟。基础文件检查不能替代对质量、事实、版权与安全的人工审核。401/403 应停止并验证访问权限;400/422 应重新拉取 schema 修正载荷;429 应尊重 Retry-After;5xx 或网络超时先轮询已知任务,除非用户批准可能的重复扣费,不要自动重试付费请求。