Codex+九马数字人插件教程

功能概览

本页用于说明 Codex+九马数字人插件教程 的核心能力、调用入口和接入要点，帮助开发者快速判断适用场景并完成集成。

适用场景

• 产品原型验证：快速接入模型能力，验证内容生成、理解或编辑流程。
• 生产业务接入：用于批量任务、自动化工作流和多模型组合调用。
• 能力迁移适配：适合从原有模型或 SDK 平滑切换到爱虾AI统一接口。

接入建议

• 优先确认模型名称、请求路径和响应字段，再接入具体业务流程。
• 对异步任务、媒体生成和长耗时请求，建议在业务侧加入重试与状态轮询。
• 上线前建议准备日志追踪、错误处理和内容安全校验，便于稳定运行。

准备工作

1. 安装 Codex / ChatGPT 桌面端。
2. 安装 Node.js 20 或以上版本。Windows 用户建议安装到默认路径 C:\Program Files\nodejs\node.exe。
3. 准备九马数字人插件压缩包，例如 yisu-codex-digital-human.zip。
4. 准备可用的 API Key。

可在 PowerShell 中确认 Node.js 是否可用：

node -v

下载安装包

点击下载Codex-九马数字人技能安装包

下载后请保留压缩包，不需要手动解压或改名。安装时可在 Codex / ChatGPT 桌面端插件页面直接选择该压缩包。

配置 API Key

Windows 用户打开 PowerShell，执行以下命令：

[Environment]::SetEnvironmentVariable("YISU_API_KEY", "<你的API Key>", "User")
[Environment]::SetEnvironmentVariable("YISU_API_BASE_URL", "https://api.yisu.com", "User")

配置完成后，需要完全退出 Codex / ChatGPT 桌面端，再重新打开，让环境变量生效。

macOS / Linux 用户可在 shell 配置文件中加入：

export YISU_API_KEY="<你的API Key>"
export YISU_API_BASE_URL="https://api.yisu.com"

安装插件

推荐直接使用压缩包安装：

1. 打开 Codex / ChatGPT 桌面端。
2. 进入插件管理页面。
3. 点击安装、导入或添加本地插件的按钮。
4. 直接选择下载的 yisu-codex-digital-human.zip 压缩包。
5. 在插件详情页点击安装并启用“九马数字人”插件。
6. 完全关闭并重新打开 Codex / ChatGPT 桌面端。

只有在当前 Codex / ChatGPT 版本不支持直接导入 zip，或导入压缩包失败时，才需要解压压缩包；解压后将 yisu-digital-human 目录放到 Codex 插件目录，再在插件页面中安装并启用。

安装检查

如需检查插件文件是否完整，可在解压后的插件目录执行：

node .\scripts\check-install.mjs

看到类似结果表示插件工具可以正常加载：

MCP tools: ok
Balance tool: ok

如果提示缺少 YISU_API_KEY，请重新设置用户环境变量，并完全重启 Codex / ChatGPT。

在 Codex 中调用

新建 Codex 对话后，可以用 @九马数字人 或插件选择器指定该插件，例如：

@九马数字人 查询我的AI资金池余额

@九马数字人 列出我的数字人形象

@九马数字人 查询数字人任务 89425 的制作状态

创建视频任务时，可以直接描述需求：

@九马数字人 使用数字人形象 53077，文本驱动，音色 6280，文案是“欢迎来到中国广东省，欢迎参观我们的大学。”，生成 Q版数字人视频

创建任务限制

创建数字人视频任务时，engine 可选：

如果 video_id 对应的数字人形象是图片素材创建的形象，不能制作超拟真视频任务，也就是 engine 不能为 standard；可以不传 engine，或传 auto、ultra。

常见问题

如果新建对话中提示找不到插件工具，优先检查：

1. 插件是否已经安装并启用。
2. Node.js 是否能通过 node -v 正常运行。
3. 是否完全重启了 Codex / ChatGPT。
4. YISU_API_KEY 是否设置在用户环境变量中。
5. 如果 Node.js 不在默认路径，需要把插件 .mcp.json 里的 command 改成实际的 node.exe 路径。