文档/开始接入/API 接入与 Codex

JunFeiAI cf-global API 接入与 Codex

本文档只把生产入口实际调用成功的组合列为“已验证”。公开清单见模型广场；模型目录仍会随 API Key 所属分组变化，接入时必须先调用 /v1/models。

最后更新：2026-08-03

最后验证：2026-07-12（Asia/Shanghai）

价格与视频路由配置核对：2026-08-03（Asia/Shanghai）

1. 接入地址与鉴权

场景Base URL使用建议
标准生产入口https://cf-global.junfeiai.com/v1文本、模型发现、图片生成与 AI 视频首选
全球兼容入口https://global.junfeiai.com/v1只作为边缘排障兼容入口
源站排障入口https://origin-global.junfeiai.com/v1仅用于源站或边缘问题定位
文档中心https://doc.global.junfeiai.com不提供模型调用
http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

API Key 只应保存在服务端或安全环境变量中，不要写入浏览器代码、截图、日志或代码仓库。

2. 已验证范围

能力模型或客户端生产验证结果验证标识
模型发现GET /v1/modelsHTTP 200，返回当前分组模型目录2026-07-12
Responses SSEgpt-5.6-solHTTP 200，收到 response.completedcc92f1a7...ad2b
Chat Completions SSEgpt-5.6-terraHTTP 200，收到流式完成片段1094a00f...4ee9
Codex CLICodex 0.144.1 + gpt-5.6-solcodex exec 正常返回 OK2026-07-12
Responses 图片工具gpt-image-2HTTP 200，完成事件中的 Base64 解码为有效 PNGb10315cb...8ebe
Images API 生成gpt-image-2HTTP 200，b64_json 解码为有效 PNG27c78e47...d243
Images API 编辑gpt-image-2标准 cf-global 入口近期持续成功；历史输出为有效 PNG生产记录截至 2026-08-01

验证标识经过缩短，仅用于确认文档示例来自真实请求。它不是 API Key，也不能用于鉴权。

3. 先读取当前模型

bash
curl "https://cf-global.junfeiai.com/v1/models" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY"

HTTP 200 只表示模型目录读取成功。真正上线前，仍应使用目标模型发送一条最小请求。

4. Responses API

新项目和 Codex 客户端优先使用 Responses API：

bash
curl -N "https://cf-global.junfeiai.com/v1/responses" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "Reply with exactly: OK",
    "reasoning": { "effort": "high", "summary": "auto" },
    "stream": true,
    "store": false
  }'

成功的流式响应会依次返回 response.created、内容增量和 response.completed。客户端必须持续读取到完成事件，不能只把首个 SSE 包当作请求完成。

5. Chat Completions 兼容接口

bash
curl -N "https://cf-global.junfeiai.com/v1/chat/completions" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [
      { "role": "user", "content": "Reply with exactly: OK" }
    ],
    "stream": true
  }'

该接口用于已有 OpenAI Chat 客户端迁移。新项目仍推荐 Responses API。

6. Codex 配置

当前生产验证使用 Codex CLI 0.144.1。配置示例：

toml
model_provider = "OpenAI"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
openai_base_url = "https://cf-global.junfeiai.com"
wire_api = "responses"

设置环境变量后运行最小检查：

bash
codex exec --ephemeral --skip-git-repo-check \
  -m gpt-5.6-sol \
  "Reply with exactly: OK"

本轮真实运行返回 OK。客户端插件或 MCP 的独立告警不等于模型请求失败，应以 Codex 最终退出码和模型输出判断。

7. 端点总览

方法路径当前文档状态
GET/v1/models已验证
POST/v1/responses已验证文本与图片工具
POST/v1/chat/completions已验证 SSE
POST/v1/images/generations已验证，详见图片文档
POST/v1/images/edits已验证 global / origin-global，详见图片文档
POST/v1/videosOpenAI 风格视频创建，详见视频文档
POST/v1/videos/generationsxAI 风格视频创建，详见视频文档
GET/v1/videos/{request_id}查询 Grok 或 Seedance 视频任务
GET/v1/videos/{request_id}/content通过 R2 缓存下载最终视频

厂商官方价、cf-global 站内基础价、API Key 分组倍率和最终余额实扣统一见官方价格与实际扣费。

未列为“已验证”的协议、模型或工具，不应仅凭路由存在就视为生产承诺。

8. 错误处理

状态含义与处理
401API Key 缺失或无效，检查 Bearer Header
403当前分组没有目标能力权限
404 model_not_found模型不属于当前分组，先查 /v1/models
429并发或频率受限，按响应信息退避重试
5xx网关或上游暂时不可用；记录请求标识后重试或联系支持

排障时记录响应头中的请求标识、绝对时间、端点、模型和 HTTP 状态，不要提交 API Key。

JunFeiAI cf-global · 配置核对 2026-08-06 · 可用模型以当前 API Key 的 /v1/models 为准