即映镜
陈

模型接入

把入口从「演示」改成真实调用,前端只占一小半。下面把前置条件、五步流程、参数映射、请求契约与验收口径逐项写清,能先准备的部分已经做成可核对的结构。

当前站点的图片与视频生成已通过平台 BaaS 直连接口接入,无需边缘函数;数据库与边缘函数仍不可用,因此任务持久化、额度回写、音乐与文本模型接入尚未具备条件。本页列出其余能力的接入前置与准备清单。

六项前置条件

按当前站点版本自检,未满足项给出下一步动作。

已具备 0 / 6

站点版本未满足

当前为轻量版,图片与视频生成已走平台 BaaS 直连;数据库与边缘函数仍不可用,任务持久化与其余模型能力受限。

查看版本与映点
数据库未满足

记录生成任务、额度、资产与失败重试;开通后不可关闭。

升级后由平台侧开通

边缘函数未满足

图片与视频已由平台 BaaS 直连完成;音乐、文本与需要服务端编排的能力仍需边缘函数。

升级后在平台侧开通

模型密钥未满足

百炼或第三方服务商的 API Key,写入「管理 → 秘钥管理」,只作为函数环境变量读取。

拿到密钥后由管理员配置

已开通的模型能力未满足

按分组分别需要图像、视频、语音、音乐与文本模型,具体型号与配额以服务商实际开通为准。

先开一个能力验证链路

文件存储未满足

生成结果需要可长期访问的地址;图片与视频体积较大,建议与数据库一并确认存储方案。

开通时确认存储与访问域名

五步接入

前两步在平台侧完成,后三步可以交给我来做。

  1. 01确认版本与费用你

    轻量版没有数据库与边缘函数,需要升级到标准版或高级版;数据库开通后不可关闭,先在版本对照里算清空间与配额。

    产出 · 账号具备数据库与边缘函数入口

  2. 02开通数据库与边缘函数你 + 平台

    在应用管理里开通,等待资源就绪;开通后建任务表、额度表与资产表,保留创建与更新时间。

    产出 · 可建表、可部署函数、可写结果

  3. 03配置模型密钥你(管理员)

    在「管理 → 秘钥管理」写入服务商密钥,前端代码与页面文案都不出现密钥,也不把密钥拼进 URL。

    产出 · 函数能读到环境变量,浏览器读不到

  4. 04部署生成代理函数我(可代做)

    按能力分路由:校验参数、鉴权、按模型映射参数、提交任务、轮询结果、写回素材地址与用量,失败保留可重试记录。

    产出 · 一条能力先跑通,再批量复制

  5. 05前端切真实态我(可代做)

    把入口的状态从「演示」改为真实调用,补齐排队、超时、限流、审核拒绝与额度不足的提示,保留演示回退开关。

    产出 · 状态、错误与产物都如实展示

待接入的能力

共 22 个演示入口,按所在分组标注需要的模型类型。

图片 8视频 4音乐 4数字人 3社区 1平台 1资产 1
  • 局部重绘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 / size

    9: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 都不出现密钥。
  • 数据库开通后不可关闭,建议先用一个文本类能力验证链路,再逐步接入图片与视频。
  • 模型型号、配额与价格以服务商实际开通为准;本站不承诺具体生成效果与耗时。