模型接入
把入口从「演示」改成真实调用,前端只占一小半。下面把前置条件、五步流程、参数映射、请求契约与验收口径逐项写清,能先准备的部分已经做成可核对的结构。
当前站点的图片与视频生成已通过平台 BaaS 直连接口接入,无需边缘函数;数据库与边缘函数仍不可用,因此任务持久化、额度回写、音乐与文本模型接入尚未具备条件。本页列出其余能力的接入前置与准备清单。
六项前置条件
按当前站点版本自检,未满足项给出下一步动作。
已具备 0 / 6
记录生成任务、额度、资产与失败重试;开通后不可关闭。
升级后由平台侧开通
图片与视频已由平台 BaaS 直连完成;音乐、文本与需要服务端编排的能力仍需边缘函数。
升级后在平台侧开通
百炼或第三方服务商的 API Key,写入「管理 → 秘钥管理」,只作为函数环境变量读取。
拿到密钥后由管理员配置
按分组分别需要图像、视频、语音、音乐与文本模型,具体型号与配额以服务商实际开通为准。
先开一个能力验证链路
生成结果需要可长期访问的地址;图片与视频体积较大,建议与数据库一并确认存储方案。
开通时确认存储与访问域名
五步接入
前两步在平台侧完成,后三步可以交给我来做。
- 01确认版本与费用你
轻量版没有数据库与边缘函数,需要升级到标准版或高级版;数据库开通后不可关闭,先在版本对照里算清空间与配额。
产出 · 账号具备数据库与边缘函数入口
- 02开通数据库与边缘函数你 + 平台
在应用管理里开通,等待资源就绪;开通后建任务表、额度表与资产表,保留创建与更新时间。
产出 · 可建表、可部署函数、可写结果
- 03配置模型密钥你(管理员)
在「管理 → 秘钥管理」写入服务商密钥,前端代码与页面文案都不出现密钥,也不把密钥拼进 URL。
产出 · 函数能读到环境变量,浏览器读不到
- 04部署生成代理函数我(可代做)
按能力分路由:校验参数、鉴权、按模型映射参数、提交任务、轮询结果、写回素材地址与用量,失败保留可重试记录。
产出 · 一条能力先跑通,再批量复制
- 05前端切真实态我(可代做)
把入口的状态从「演示」改为真实调用,补齐排队、超时、限流、审核拒绝与额度不足的提示,保留演示回退开关。
产出 · 状态、错误与产物都如实展示
待接入的能力
共 22 个演示入口,按所在分组标注需要的模型类型。
- 局部重绘C-03图片图像生成 / 图像编辑模型工具抽屉
- 一键扩图C-04图片图像生成 / 图像编辑模型工具抽屉
- 智能消除C-05图片图像生成 / 图像编辑模型工具抽屉
- 抠图换背景C-06图片图像生成 / 图像编辑模型工具抽屉
- 商品图C-07图片图像生成 / 图像编辑模型工具抽屉
- 海报排版C-08图片图像生成 / 图像编辑模型工具抽屉
- 图片翻译C-09图片图像生成 / 图像编辑模型工具抽屉
- 风格转绘C-10图片图像生成 / 图像编辑模型工具抽屉
- 首尾帧C-13视频视频生成模型 + 异步任务队列工具抽屉
- 视频延长C-16视频视频生成模型 + 异步任务队列工具抽屉
- 视频超分C-18视频视频生成模型 + 异步任务队列工具抽屉
- 视频插帧C-19视频视频生成模型 + 异步任务队列工具抽屉
- 对口型C-22数字人人像驱动 + 语音合成模型工具抽屉
- 数字人播报C-23数字人人像驱动 + 语音合成模型工具抽屉
- 数字人创作C-24数字人人像驱动 + 语音合成模型创作台
- 文生音乐C-25音乐语音合成 / 音乐生成模型创作台
- 配音C-26音乐语音合成 / 音乐生成模型创作台
- 音效生成C-27音乐语音合成 / 音乐生成模型创作台
- 音色克隆C-28音乐语音克隆模型 + 授权记录资产与主体
- 爆款复刻C-36社区文本模型(结构拆解)灵感详情
- API 服务C-45平台不涉及模型(API 服务本身需先开通)直接进入
- 跨团队引用C-51资产不涉及模型(审批流与数据表)资产详情
模型类型是接口层面的归类,具体型号、配额与价格以服务商实际开通为准;不需要模型的入口仍可用本机处理完成。
参数映射
本站界面参数 → 代理函数需要转出的字段。
- 提示词
prompt按模型要求拼装主体、动作、光线与镜头
- 负向提示
negative_prompt部分模型不支持,需按文档降级为提示词尾注
- 画幅比例
aspect_ratio / size9:16、16:9 等映射到服务商的枚举或宽高
- 出图数量
n单次上限以服务商为准,超出拆成多次请求
- 参考图
image_url / reference_images先上传到存储,传可访问地址而不是本地文件
- 首帧 / 尾帧
first_frame_url / last_frame_url异步视频接口常见字段,两帧尺寸需一致
- 时长
duration按秒或枚举,超出上限要分段生成再拼接
- 运镜
camera_motion + strength并非所有模型支持,映射不了时写进提示词
- 音色 / 语速
voice_id / speed克隆音色需授权记录,随请求一起留痕
- 上传素材
source_url前端先取上传凭证,再提交地址给函数
- 任务跟踪
task_id异步任务用轮询或回调,前端只读状态
验收清单
接入后逐条走一遍,缺一条都不算接通。
成功返回
应当 · 展示素材地址、尺寸与用量,可下载或加入资产
禁止 · 把示例图当成生成结果
排队中
应当 · 显示排队位置与预计时间,可离开页面稍后查看
禁止 · 用进度条假装实时推进
限流 / 额度不足
应当 · 明确提示原因与恢复方式,不静默重试
禁止 · 自动重复提交放大计费
请求超时
应当 · 保留参数,允许手动重试,记录失败原因
禁止 · 显示成功但无产物
内容审核拒绝
应当 · 原样展示拒绝原因,引导修改提示词
禁止 · 改写成「生成失败」掩盖审核
部分片段失败
应当 · 按镜号重跑,已完成片段保留
禁止 · 整段重来覆盖已有结果
请求契约
示意字段,不含密钥;实际名称以所选服务商文档为准。
图片生成(同步返回)
POST /functions/v1/generate-image
请求体
{
"capability": "text-to-image",
"prompt": "深夜便利店门口,霓虹反光,低饱和",
"negative_prompt": "水印, 文字, 畸变手",
"aspect_ratio": "9:16",
"n": 2,
"reference_urls": []
}响应体
{
"ok": true,
"task_id": "img_20261116_0001",
"images": [
{
"url": "存储地址",
"width": 1080,
"height": 1920
}
],
"usage": {
"unit": "张",
"count": 2
},
"model": "按已开通模型返回"
}同步接口超时按 30 秒处理,超时不自动重发,避免重复计费。
现在能先做的事
- 当前站点为轻量版:数据库与边缘函数不可用,生成类入口只能保持「演示」,这不是前端能绕过的限制。
- 密钥只写入「管理 → 秘钥管理」,由边缘函数读取环境变量;前端、页面源码与 URL 都不出现密钥。
- 数据库开通后不可关闭,建议先用一个文本类能力验证链路,再逐步接入图片与视频。
- 模型型号、配额与价格以服务商实际开通为准;本站不承诺具体生成效果与耗时。