功能简介

CloudGeneral 是通用模型聚合服务，采用「模型选择器」的方式统一接入多种 AI 模型。调用时只需通过 model 指定目标模型，即可在同一个接口下使用歌声转换、语音转换、图像抠图等不同类型的模型能力，无需为每种模型单独对接。

适用场景

• 歌声转换：将一段歌唱音频转换为参考音色的歌声
• 语音转换：将说话人语音转换为目标音色
• 音色迁移：保留原有的旋律与内容，仅替换演唱或说话的音色
• 图像抠图：电商商品图、人像、宠物、Logo 等一键分离主体，输出透明背景或指定底色图片
• 内容创作：为音乐、配音、设计素材等内容快速生成目标音色与透明素材
• 批量生产：统一入口接入多种模型，按需切换不同能力

功能特性

• 统一入口：所有模型共用 cloud_general 一个接口，通过 model 切换
• 模型选择器：请求参数由 model（目标模型）+ config（模型专属字段）+ param（通用参数）组成
• 动态模型列表：通过 /openapi/cloudgeneral/config/models 获取当前支持的模型、参数定义与计费信息
• 计费方式各异：不同模型的计费方式与单位可能不同（如 算力点/分钟、算力点/秒、算力点/次、算力点/张 等），以模型实际配置为准
• 异步处理：提交任务后轮询获取生成结果

支持的模型

当前支持的模型、参数定义与计费信息见下方「支持模型」区块（实时数据以 /openapi/cloudgeneral/config/models 返回为准）。

每个模型都有独立的文档页（地址形如 /m/CloudGeneral/SeedVC），包含该模型的请求参数、返回结果与调用示例，点击模型卡片上的「模型文档」即可查看。

资费标准

• 计费单位：价格统一以「算力点」计费，各模型的具体计费方式以模型配置为准
• 计费方式：不同模型可能按次、按分钟、按秒、按数量、按字符等方式计费，具体见下方「支持模型」区块或 /openapi/cloudgeneral/config/models 返回的 credit 字段
• 示例：Seed-VC 歌声转换按生成音频时长计费，8 算力点/分钟，不足 1 分钟按 1 分钟计；RMBG-2.0 图像抠图按次计费，1 算力点/次

1. 接口基础

使用前请阅读 接口基础 。

CloudGeneral 是通用模型聚合服务，采用「模型选择器」模式：请求时通过 model 指定目标模型，并通过 config（模型专属字段）与 param（通用参数）传入参数，服务端会按目标模型的协议组装后交给执行服务器运行。

不同模型读取参数的位置可能不同（如 SeedVC 从 param 读取 source/target），具体字段请以「获取模型列表」返回的定义为准。

2. 获取模型列表

用于查询当前支持的模型，以及各模型的参数定义（config / param / result）与计费信息（credit）。

请求地址

[GET/POST] https://api.tecmz.com/open_api/cloud_general/config/models

返回

{
    "code": 0,
    "msg": "ok",
    "data": {
        "models": [
            {
                "name": "SeedVC",                // 模型 ID（提交任务时作为 model 传入）
                "serverName": "SeedVC",          // 模型项目名（通常与 name 一致）
                "title": "Seed-VC 歌声转换",      // 模型显示名称
                "description": "基于 Seed-VC 的零样本歌声转换模型",
                "types": ["General"],            // 功能类型
                "config": [ /* 字段定义数组 */ ], // 模型专属字段（请求的 config 子对象）
                "param": [ /* 字段定义数组 */ ],  // 通用参数（请求的 param 子对象）
                "result": [                      // 输出结果定义，仅支持 file / files / text
                    { "type": "file", "name": "url", "title": "转换后音频" }
                ],
                "credit": { "type": "perMinute", "price": 8 } // 计费方式与价格（算力点）
            }
            // 其余模型结构相同，按 name 区分
        ]
    }
}

计费方式说明（credit.type）

3. 任务提交（异步）

请求地址

[POST] https://api.tecmz.com/open_api/cloud_general/queue

请求参数

返回

{
    "code": 0,
    "msg": "ok",
    "data": {
        // 任务ID
        "taskId": "1"
    }
}

4. 任务查询

建议 10 秒查询一次结果。

请求地址

[POST] https://api.tecmz.com/open_api/cloud_general/query

请求参数

返回

{
    "code": 0,
    "msg": "ok",
    "data": {
        "taskId": "1",
        // 任务状态：QUEUE | PROCESS | SUCCESS | FAIL
        "status": "SUCCESS",
        // 状态备注（失败原因等）
        "statusRemark": "",
        "result": {
            // 生成的音频URL
            "url": "http://example.com/result.wav",
            // 生成音频时长（秒）
            "Duration": 15.58
        }
    }
}

5. 可用性检查

请求地址

[POST] https://api.tecmz.com/open_api/cloud_general/available

返回

{
    "code": 0,
    "msg": "ok",
    "data": {
        // 当前可用服务器数量
        "availableCount": 1
    }
}

6. 按模型对接

各模型的请求参数、返回结果与调用示例已拆分为独立的模型文档页，入口见上方「支持模型」中每个模型的「模型文档」按钮（地址形如 /m/CloudGeneral/SeedVC）。

每个模型文档页都包含：

• 该模型 config / param 参数表（必填、类型、默认值、可选值）
• result 返回结果字段说明
• 可直接运行的请求体 JSON 与 PHP 示例代码（含提交任务与轮询结果）

对接时只需固定本模型的三个要素：

• model：该模型的模型 ID，如 SeedVC
• config：模型专属字段（如 type），按模型文档填写
• param：模型通用参数（如 source / target），按模型文档填写