Codex免费接API实操：不花一杯奶茶钱，生图生视频全搞定

Codex集成免费API指南：对话、生图、生视频一站式打通

无需付费，通过配置兼容Chat Completions协议的免费API，即可在Codex中实现文本对话、图像生成及视频创作。全程仅需3分钟，无需绑定信用卡，单Key即可调用多模态能力。

一、核心原理与适用场景

架构逻辑：外壳与内核分离

Codex本质为交互界面（壳），具备工具调用和文件读写能力；大模型则为可替换的内核（芯）。通过供应商配置，可将任何兼容Chat Completions协议的模型接入。Agnes AI免费API即基于此逻辑，提供以下能力：

• 文本模型 (agnes-2.0-flash)：支持100万上下文，最大输出6.5万token，可直接处理80页PDF无需切片。
• 图像模型 (agnes-image-2.1-flash)：支持1K至4K四档分辨率、8种画幅，具备背景替换和局部修改功能。
• 视频模型 (agnes-video-2.5)：支持文生视频。

适用人群与注意事项

适合群体：需批量制作小红书封面、抖音竖版素材、口播脚本的内容创作者及独立开发者。

不适用群体：高并发生产环境团队，或涉及核心代码、隐私数据上传的企业用户（因Prompt需经过第三方服务器）。

重要提示：免费API存在速度限制和排队机制，不适合批量渲染车间式的高负载任务。“永久免费”多为平台拉新活动，建议趁可用期间熟练掌握工作流配置，以便未来灵活切换其他兼容模型。

二、实操流程：五步快速接入

1. 获取API Key：访问 platform.agnes-ai.cn，使用手机号或邮箱注册（无需绑卡）。进入左侧菜单「API密钥」创建新密钥，复制以 sk- 开头的字符串。
2. 安装 Codex++：在GitHub搜索 CodexPlusPlus（超2万 Star），根据系统下载对应版本：Windows选 windows-x64-setup.exe，Intel Mac选 macos-x64.dmg，Apple Silicon选 macos-arm64.dmg。
3. 配置供应商：打开Codex++管理工具 → 供应商配置 → 添加供应商。
   名称：Agnes
   访问模式：API Only
   模型名称：agnes-3.0-flash
   Base URL：https://api.agnes-ai.cn/v1
   Key：填入步骤1获取的密钥
   上游协议：必须选择 Chat Completions
4. 启动验证：保存配置，选中Agnes并点击「使用」，右上角启动。发送“你好，介绍一下你自己”，收到回复即表示连接成功。
5. 解锁多模态功能：克隆技能包至Codex skills目录：
   git clone https://github.com/jomeswang/agnes-ai-skill.git
cp -R agnes-ai-skill ~/.codex/skills/
   配置环境变量 AGNES_API_KEY 和 AGNES_BASE_URL，重启后即可通过对话调用生图和视频功能。

常用参数参考：

• 小红书封面：ratio 3:4 + size 4K
• 抖音竖版：ratio 9:16
• B站横版封面：ratio 16:9

建议将高频操作封装为Skill，如“读取PDF输出脚本”、“图片背景替换”、“首帧生成视频”等，实现模型自动路由，提升单人内容产能。

三、常见错误排查

以下五点为高频报错原因，请仔细核对：

• Key格式错误：仅填写 sk- 开头部分，切勿包含 "Bearer" 前缀。
• Base URL多余后缀：URL只需填至 /v1，严禁添加 /chat/completions。
• 协议选择错误：上游协议必须选 Chat Completions，误选 Responses API 会导致404错误。
• 代理干扰：若使用Clash/V2Ray等全局代理，可能导致连接超时。请尝试关闭代理，或为本地地址设置 NO_PROXY 变量。
• CC Switch路由未开启：若使用CC Switch，需在设置→路由配置中，同时开启总开关和Codex开关。

安全与建议：切勿在公共群组共享API Key；为避免生成失败，建议在完成图片生成后，开启新对话再进行视频生成。

四、必备工具与资源

• Agnes平台：注册账号及创建API密钥。
• Codex++：GitHub开源项目，提供插件支持、会话导出及时间线视图。
• Agnes技能包：GitHub项目 jomeswang/agnes-ai-skill，集成文本、生图、生视频功能，支持自动模型路由。
• CC Switch：备选接入工具，适用于不愿安装Codex++的用户，可伪装自定义API地址。
• 关键环境变量：AGNES_API_KEY、AGNES_BASE_URL (https://api.agnes-ai.cn/v1)、NO_PROXY (localhost,127.0.0.1,::1)。

五、行动建议

掌握Codex架构的核心价值在于灵活性。建议立即执行以下三步：

1. 注册Agnes并获取Key，按照上述步骤配置Codex++，3分钟内完成对话测试。
2. 安装Skill包，测试生成一张9:16比例的抖音封面图。
3. 将日常高频使用的提示词模板（如封面风格、脚本结构）封装为专属Skill，实现一键出活。

如遇配置问题，可在评论区提供报错截图以便进一步排查。

霖哥电商｜专注跨境工业品出海、电商自动化、AI成片流水线，持续分享可落地实操方案