<!-- Source: https://doc.global.junfeiai.com/docs/api.html -->
# JunFeiAI cf-global API 接入与 Codex

本文档只把生产入口实际调用成功的组合列为“已验证”。公开清单见[模型广场](https://doc.global.junfeiai.com/docs/models.html)；模型目录仍会随 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/models` | HTTP 200，返回当前分组模型目录 | 2026-07-12 |
| Responses SSE | `gpt-5.6-sol` | HTTP 200，收到 `response.completed` | `cc92f1a7...ad2b` |
| Chat Completions SSE | `gpt-5.6-terra` | HTTP 200，收到流式完成片段 | `1094a00f...4ee9` |
| Codex CLI | Codex `0.144.1` + `gpt-5.6-sol` | `codex exec` 正常返回 `OK` | 2026-07-12 |
| Responses 图片工具 | `gpt-image-2` | HTTP 200，完成事件中的 Base64 解码为有效 PNG | `b10315cb...8ebe` |
| Images API 生成 | `gpt-image-2` | HTTP 200，`b64_json` 解码为有效 PNG | `27c78e47...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/videos` | OpenAI 风格视频创建，详见视频文档 |
| `POST` | `/v1/videos/generations` | xAI 风格视频创建，详见视频文档 |
| `GET` | `/v1/videos/{request_id}` | 查询 Grok 或 Seedance 视频任务 |
| `GET` | `/v1/videos/{request_id}/content` | 通过 R2 缓存下载最终视频 |

厂商官方价、cf-global 站内基础价、API Key 分组倍率和最终余额实扣统一见[官方价格与实际扣费](https://doc.global.junfeiai.com/docs/pricing.html)。

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

## 8. 错误处理

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

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

---

<!-- Source: https://doc.global.junfeiai.com/docs/models.html -->
# JunFeiAI cf-global 模型广场

本页是 cf-global 文本、图片、视频、音频与向量能力的公开目录。它区分“近期实测”“目录可见”和“链路异常”，避免把 `/v1/models` 中出现的名称直接等同于稳定可用。

最后更新：2026-08-06

> 官方参考价来自各厂商公开页面；cf-global 默认实扣来自当前生产分组与渠道配置。cf-global 账户余额以 $ 记，充值人民币换算由销售渠道决定。账号存在专属倍率时，以该 API Key 请求账单的 actual_cost 为准；模型权限以目标 API Key 的 GET /v1/models 结果为准。

## 1. 状态口径

| 状态 | 含义 |
| --- | --- |
| **近期可用** | 当前生产分组已开放，并有近期成功请求或有效账单证据。 |
| **已开放** | 当前生产分组与价格配置已开放；尚未对每个参数档位逐一完成最终媒体复验。 |
| **当前维护中** | 模型仍属于主力目录，但实时链路或账号池当前不可调度，恢复前不建议客户调用。 |

## 2. 文本 / Agent

当前主要对外提供 GPT 5.5/5.6、Gemini 3.1/3.5 与 Grok 4.3/4.5。

| 模型 ID | 提供方 | 端点 | 官方参考价 | cf-global 默认实扣 | 状态 | 最近核验 | 用途 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| `grok-4.3` | Grok | `POST /v1/responses` | $1.25 / $2.50（输入 / 输出，每百万 Token）（[官方来源](https://docs.x.ai/developers/pricing)） | grok-image 组 $0.625 / $1.25（输入 / 输出，每百万 Token） | 近期可用 | 2026-07-09 | Grok 通用文本与推理 |
| `grok-4.5` | Grok | `POST /v1/responses` | $2 / $6（输入 / 输出，每百万 Token）（[官方来源](https://docs.x.ai/developers/pricing)） | grok-image 组 $1 / $3；grok-视频组 $1.70 / $5.10（输入 / 输出，每百万 Token） | 近期可用 | 2026-08-01 | Grok 最新主力文本与推理 |
| `gpt-5.5` | OpenAI | `POST /v1/responses`；`POST /v1/chat/completions` | $5 / $30（输入 / 输出，每百万 Token）（[官方来源](https://developers.openai.com/api/docs/models/gpt-5.5)） | Plus $0.75 / $4.50；Pro $1.50 / $9.00（输入 / 输出，每百万 Token） | 近期可用 | 2026-08-03 | 稳定通用推理与 Agent |
| `gpt-5.6` | OpenAI | `POST /v1/responses`；`POST /v1/chat/completions` | 同 Sol：$5 / $30（输入 / 输出，每百万 Token）（[官方来源](https://developers.openai.com/api/docs/models/gpt-5.6-sol)） | 当前路由到 Sol：Plus $0.75 / $4.50；Pro $1.50 / $9.00 | 近期可用 | 2026-08-03 | GPT 5.6 默认智能路由；默认档会映射到当前主力 5.6 上游；需要固定成本与能力时请选择 Sol、Terra 或 Luna。 |
| `gpt-5.6-luna` | OpenAI | `POST /v1/responses`；`POST /v1/chat/completions` | $1 / $6（输入 / 输出，每百万 Token）（[官方来源](https://developers.openai.com/api/docs/models/gpt-5.6-luna)） | Plus $0.03 / $0.18；Pro $0.06 / $0.36（输入 / 输出，每百万 Token） | 近期可用 | 2026-08-03 | 轻量低成本任务；本站当前文本基础价低于 OpenAI 官方公开价；缓存写入与读取另计。 |
| `gpt-5.6-sol` | OpenAI | `POST /v1/responses`；`POST /v1/chat/completions` | $5 / $30（输入 / 输出，每百万 Token）（[官方来源](https://developers.openai.com/api/docs/models/gpt-5.6-sol)） | Plus $0.75 / $4.50；Pro $1.50 / $9.00（输入 / 输出，每百万 Token） | 近期可用 | 2026-08-03 | 高强度推理与复杂工程 |
| `gpt-5.6-terra` | OpenAI | `POST /v1/responses`；`POST /v1/chat/completions` | $2.50 / $15（输入 / 输出，每百万 Token）（[官方来源](https://developers.openai.com/api/docs/models/gpt-5.6-terra)） | Plus $0.30 / $1.80；Pro $0.60 / $3.60（输入 / 输出，每百万 Token） | 近期可用 | 2026-08-03 | 通用开发与日常 Agent；本站当前文本基础价低于 OpenAI 官方公开价；缓存写入与读取另计。 |
| `gemini-3.1-pro-preview` | Gemini | `POST /v1/chat/completions` | ≤200K：$2 / $12；>200K：$4 / $18（输入 / 输出，每百万 Token）（[官方来源](https://ai.google.dev/gemini-api/docs/pricing)） | 标准组 ≤200K：$1 / $6；>200K：$2 / $9 | 当前维护中 | 2026-08-03 | 看图、解析与推理；2026-08-02 有成功账单；2026-08-03 实时复测返回 503 No available accounts。 |
| `gemini-3.5-flash` | Gemini | `POST /v1/chat/completions` | $1.50 / $9（输入 / 输出，每百万 Token）（[官方来源](https://ai.google.dev/gemini-api/docs/pricing)） | 标准组 $0.75 / $4.50（输入 / 输出，每百万 Token） | 当前维护中 | 2026-08-03 | 低延迟文本、看图与轻量推理；生产目录可见，但 2026-08-03 实时复测返回 503 No available accounts。 |

## 3. 图片

当前主要对外提供 GPT Image 2 与 Grok Imagine 图片系列。

| 模型 ID | 提供方 | 端点 | 官方参考价 | cf-global 默认实扣 | 状态 | 最近核验 | 用途 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| `grok-imagine-image` | Grok | `POST /v1/images/generations` | 1K / 2K 均 $0.02 / 张；图片输入 $0.002 / 张（[官方来源](https://docs.x.ai/developers/pricing)） | 1K $0.067；2K $0.1005；4K $0.134 / 张 | 近期可用 | 2026-07-07 | 速度优先图片生成；本站 4K 是计费档位，不代表 xAI 官方模型承诺 4K 输出。 |
| `grok-imagine-image-quality` | Grok | `POST /v1/images/generations` | 1K $0.05；2K $0.07 / 张；图片输入 $0.01 / 张（[官方来源](https://docs.x.ai/developers/pricing)） | 1K $0.067；2K $0.1005；4K $0.134 / 张 | 近期可用 | 2026-07-31 | 质量优先图片生成；本站 4K 是计费档位，不代表 xAI 官方模型承诺 4K 输出。 |
| `gpt-image-2` | OpenAI | `POST /v1/responses`；`POST /v1/images/generations`；`POST /v1/images/edits` | 图片 Token：输入 $8、缓存 $2、输出 $30 / 百万（[官方来源](https://developers.openai.com/api/docs/pricing)） | 1K $0.067；2K $0.1005；4K $0.134 / 张 | 近期可用 | 2026-08-02 | 图片生成、编辑与 Responses 图片工具；官方按图像 Token 计费；本站按最终图片规格固定计费，两种口径不能直接逐张等同。 |

## 4. 视频

当前主要对外提供 Grok Imagine Video 与 Veo 3.1；旧 AI 视频线路处于维护状态。

| 模型 ID | 提供方 | 端点 | 官方参考价 | cf-global 默认实扣 | 状态 | 最近核验 | 用途 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| `veo-3.1` | Google | `POST /v1/videos`；`POST /v1/videos/generations` | 当前渠道套餐价，非 Google Vertex AI 官方直连接口价 | $1.55 / 次 | 近期可用 | 2026-08-06 | Veo 3.1 文生视频与原生音频；cf-global 已实测 8 秒、1920×1080 MP4，包含 H.264 视频轨和 AAC 音频轨；标准直连接口支持 4、6、8 秒，15 秒需要尚未接入的延长流程。 |
| `grok-imagine-video` | Grok | `POST /v1/videos`；`POST /v1/videos/generations` | 480P $0.05 / 秒；720P $0.07 / 秒（[官方来源](https://docs.x.ai/developers/pricing)） | $0.85 / 次 | 近期可用 | 2026-08-01 | Grok 标准文生视频、单图首帧、多图参考或视频编辑；多图使用 reference_images，最多 7 张且最长 10 秒；本站当前按创建任务次数固定计费，不随时长变化。 |
| `grok-imagine-video-1.5` | Grok | `POST /v1/videos`；`POST /v1/videos/generations` | 480P $0.08；720P $0.14；1080P $0.25 / 秒，另收图片输入 $0.01 / 张（[官方来源](https://docs.x.ai/developers/pricing)） | $1.02 / 次 | 近期可用 | 2026-08-01 | Grok 1.5 图生视频；本站当前按创建任务次数固定计费，不随时长变化。 |
| `happyhorse` | Alibaba Cloud | `POST /v1/videos`；`POST /v1/videos/generations` | 国际区标价：720P $0.14；1080P $0.24 / 秒（[官方来源](https://www.alibabacloud.com/help/en/model-studio/model-pricing)） | 720P $1.99；1080P $2.29 / 次 | 当前维护中 | 2026-08-05 | HappyHorse 文生视频旧线路，当前不可调用；当前账号池不可调度，也不在实时 /v1/models 中。 |
| `kling-3.0-omni` | Kling | `POST /v1/videos`；`POST /v1/videos/generations` | 720P 6–9 Credits / 秒；1080P 8–12 Credits / 秒，取决于原生音频模式（[官方来源](https://app.klingai.com/cn/quickstart/klingai-video-3-model-user-guide)） | 720P $2.38；1080P $3.18 / 次 | 当前维护中 | 2026-08-05 | Kling 3.0 Omni 旧线路，当前不可调用；历史链路曾通过媒体实测，但当前账号池不可调度，也不在实时 /v1/models 中。 |
| `minimax-h3` | Minimax | `POST /v1/videos`；`POST /v1/videos/generations` | 上游公开价未核实 | $2.55 / 次（历史） | 当前维护中 | 2026-08-06 | 海螺 Minimax H3，待补新渠道，当前不可调用；当前没有可调度的海螺上游账号或模型映射；旧 AI 视频模型已下架，不在当前专业组 /v1/models 中。 |
| `seedance-2.0` | Seedance | `POST /v1/videos`；`POST /v1/videos/generations` | 官方活动资源包约 ¥7 / 条 480P；其他规格按 Token 抵扣（[官方来源](https://www.volcengine.com/activity/seedance2)） | $12.25 / 次（预配置，未开放） | 当前维护中 | 2026-08-06 | Seedance 2.0 新渠道待验收，当前不可调用；新渠道适配已完成，但上游余额为零，真实请求返回 insufficient_user_quota；充值并通过真实 MP4 验收前保持下架。 |
| `seedance-2.0-fast` | Seedance | `POST /v1/videos`；`POST /v1/videos/generations` | 官方公开活动页未列 Fast 独立单价（[官方来源](https://www.volcengine.com/activity/seedance2)） | 480P $1.19；720P $1.59 / 次 | 当前维护中 | 2026-08-05 | Seedance 2.0 快速档旧线路，当前不可调用；当前账号池不可调度，也不在实时 /v1/models 中。 |

## 5. 音频

当前没有对客户开放的稳定音频模型。

当前没有可公开列出的模型或端点。

## 6. 向量

当前没有对客户开放的向量模型。

当前没有可公开列出的模型或端点。

## 7. 接入前检查

1. 使用目标 API Key 调用 `GET /v1/models`。
2. 只选择该 Key 实际返回的完整模型 ID。
3. 用最小真实请求验证目标端点和参数组合。
4. 图片和视频属于付费媒体任务；获得授权后再测试，并校验最终媒体内容。
5. 保存请求 ID、任务 ID、HTTP 状态和绝对时间，不保存 API Key 或签名媒体 URL。

---

<!-- Source: https://doc.global.junfeiai.com/docs/text-api.html -->
# JunFeiAI cf-global 文本模型文档

本页区分“模型目录可见”和“模型已真实生成成功”。目录可见不等于当前上游一定可调用。

最后更新：2026-08-03

生产记录与实时链路核对：2026-08-03（Asia/Shanghai）

厂商官方 Token 单价、cf-global 分组倍率和实际扣费价见[官方价格与实际扣费](https://doc.global.junfeiai.com/docs/pricing.html)。

## 1. 当前主要对外模型

模型广场只保留当前主要对外提供的系列，不把 `/v1/models` 中的全部内部或预览名称堆给客户。

| 模型 | 定位 | 当前状态 | 生产证据 |
| --- | --- | --- | --- |
| `gpt-5.5` | 稳定通用推理与 Agent | 近期可用 | 生产成功截至 2026-08-03 |
| `gpt-5.6` | 默认智能路由；当前映射到 Sol | 近期可用 | 生产成功；固定成本时建议使用完整档位名 |
| `gpt-5.6-sol` | 高强度推理、复杂工程任务 | 近期可用 | 生产成功截至 2026-08-03 |
| `gpt-5.6-terra` | 通用开发与日常 Agent | 近期可用 | 生产成功截至 2026-08-03 |
| `gpt-5.6-luna` | 轻量低成本任务 | 近期可用 | 生产成功截至 2026-08-03 |
| `gemini-3.1-pro-preview` | 看图、解析与推理 | 当前维护中 | 2026-08-02 有成功账单；2026-08-03 实测 503 |
| `gemini-3.5-flash` | 低延迟文本、看图与轻量推理 | 当前维护中 | 目录可见；2026-08-03 实测 503 |
| `grok-4.3` | Grok 通用文本与推理 | 近期可用 | 近期生产成功 |
| `grok-4.5` | Grok 最新主力文本与推理 | 近期可用 | 生产成功截至 2026-08-01 |

`gpt-5.6` 裸别名的分组路由可能变化；稳定业务仍建议固定 `gpt-5.6-sol`、`gpt-5.6-terra` 或 `gpt-5.6-luna`。

生产目录中仍有其他兼容、内部或预览名称，但不属于当前主要对外清单。Gemini 当前账号池不可调度，恢复前不要向客户承诺可用。完整清单、官方价与站内实扣见[模型广场](https://doc.global.junfeiai.com/docs/models.html)。

## 2. 接入前读取模型

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

模型目录按 API Key 分组返回。不要把其他 Key 看到的模型列表复制成自己的固定白名单。

## 3. 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
  }'
```

2026-07-12 生产验证结果：HTTP 200，收到 `response.completed`，验证标识 `cc92f1a7...ad2b`。

非流式请求可将 `stream` 设为 `false`。本页模型表使用非流式最小请求逐一验证。

## 4. 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
  }'
```

2026-07-12 生产验证结果：HTTP 200，返回 `chat.completion.chunk` 流并正常结束，验证标识 `1094a00f...4ee9`。

## 5. 常用参数

| 参数 | 说明 |
| --- | --- |
| `model` | 使用 `/v1/models` 返回且已完成最小调用验证的完整模型名 |
| `input` | Responses API 的文本或结构化输入 |
| `messages` | Chat Completions 的消息数组 |
| `stream` | `true` 使用 SSE；调用方必须持续读取到完成标记 |
| `reasoning.effort` | 推理强度；示例中的 `high` 已验证 |
| `reasoning.summary` | 推理摘要策略；示例中的 `auto` 已验证 |
| `store` | 是否请求上游存储；示例使用 `false` |

参数支持可能随模型变化。不要把一个模型成功接受的参数无条件复用到全部模型。

## 6. 上线检查

1. 使用目标 API Key 调用 `/v1/models`。
2. 对目标模型发送最小非流式请求。
3. 若生产使用 SSE，再发送一次流式请求并确认完成事件。
4. 记录请求标识和 HTTP 状态，不记录 API Key。
5. 只有真实请求成功后，才把模型加入业务侧可选列表。

## 7. 常见错误

| 现象 | 处理 |
| --- | --- |
| `404 model_not_found` | 模型名或分组不匹配；不要依赖未验证别名 |
| `502` | 当前上游链路失败；目录可见并不能推翻真实调用结果 |
| `503 Service temporarily unavailable` | 当前分组没有可调度账号或上游暂不可用 |
| 流式只收到首包 | 检查客户端是否持续读取到完成事件 |
| 参数不支持 | 按目标模型收窄请求体后重试 |

---

<!-- Source: https://doc.global.junfeiai.com/docs/image-api.html -->
# JunFeiAI cf-global 图片生成与编辑

cf-global 提供 `gpt-image-2` 和 Grok Imagine 图片路由。OpenAI 图片工具与 Grok Images API 是两条不同链路，不应混用请求格式。

最后更新：2026-08-03

生产记录核对：2026-08-03（Asia/Shanghai）

OpenAI 官方图像 Token 价、1K / 2K / 4K 站内基础价、图片分组倍率和最终余额实扣见[官方价格与实际扣费](https://doc.global.junfeiai.com/docs/pricing.html)，生产价格配置核对于 2026-08-03。

## 1. 已验证范围

| 能力 | 模型 | 入口 | 结果 | 验证标识 |
| --- | --- | --- | --- | --- |
| Responses 图片工具 | `gpt-image-2` | `cf-global` | HTTP 200，Base64 解码为有效 PNG | `b10315cb...8ebe` |
| Images API 生成 | `gpt-image-2` | `cf-global` | HTTP 200，`b64_json` 解码为有效 PNG | `27c78e47...d243` |
| Images API 编辑 | `gpt-image-2` | `cf-global` | 标准入口近期持续出现 HTTP 200；历史输出也已解码为有效 PNG | 生产记录截至 2026-08-01 |
| Grok 高质量生成 | `grok-imagine-image-quality` | `cf-global` | 近期生产记录存在大量 HTTP 200；可用性仍随账号池变化 | 生产记录截至 2026-07-31 |
| Grok 快速生成 | `grok-imagine-image` | `cf-global` | 有历史成功记录，距离本次核对较久，调用前复验 | 最近成功 2026-07-07 |
| Grok 兼容别名 | `grok-imagine` | `cf-global` | 目录可见；网关归一到质量模型，需按 Key 复验 | 待复验 |
| Grok 图片编辑 | `grok-imagine-edit` | `cf-global` | 编辑路由已实现；近期编辑成功记录映射到质量模型，别名本身需复验 | 待复验 |

## 2. OpenAI Responses 图片工具

```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": [
      {
        "type": "message",
        "role": "user",
        "content": [
          { "type": "input_text", "text": "Create a centered green square on a clean white background, no text, no watermark." }
        ]
      }
    ],
    "stream": true,
    "store": false,
    "tool_choice": { "type": "image_generation" },
    "reasoning": { "effort": "high", "summary": "auto" },
    "tools": [
      {
        "type": "image_generation",
        "model": "gpt-image-2",
        "size": "1024x1024",
        "quality": "medium",
        "output_format": "png",
        "partial_images": 1
      }
    ]
  }'
```

最终图片位于完成响应的 `image_generation_call.result`，内容为 Base64。2026-07-12 的真实结果解码后为 PNG，大小 687376 字节。

## 3. gpt-image-2 图片生成

```bash
curl "https://cf-global.junfeiai.com/v1/images/generations" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A centered red circle on a clean white background, no text, no watermark.",
    "size": "1024x1024",
    "quality": "medium",
    "response_format": "b64_json"
  }'
```

2026-07-12 的真实结果为 HTTP 200，`b64_json` 解码后为 PNG，大小 2201681 字节。

## 4. gpt-image-2 图片编辑

标准 `cf-global` 入口已支持 JSON 图片编辑，当前优先使用该入口：

```bash
curl "https://cf-global.junfeiai.com/v1/images/edits" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Place this logo centered on a clean white square canvas. Preserve the logo colors and add no text.",
    "quality": "medium",
    "images": [
      { "image_url": "https://cf-global.junfeiai.com/logo.png" }
    ]
  }'
```

`images[].image_url` 使用上游可访问的 HTTPS 图片地址。`global.junfeiai.com` 与 `origin-global.junfeiai.com` 只作为排障兼容入口，不应写进新的默认配置。大体积 Data URL 可能触发请求体限制，不作为本页推荐方案。

## 5. Grok 图片模型

| 模型 | 用途 | 路由行为 |
| --- | --- | --- |
| `grok-imagine-image-quality` | 高质量图片生成 | 推荐质量优先场景 |
| `grok-imagine-image` | 快速图片生成 | 推荐延迟优先场景 |
| `grok-imagine` | 兼容别名 | 网关归一到 `grok-imagine-image-quality` |
| `grok-imagine-edit` | 图片编辑 | 使用 Images API 编辑端点 |

Grok 图片必须走 `/v1/images/generations` 或 `/v1/images/edits`。Grok Responses 路由不会执行 `image_generation` 工具。

> Grok 图片可用性会随 OAuth 账号池变化。近期生产记录证明质量路由可以成功，但不能据此保证每个 API Key、别名和参数组合长期稳定；接入前仍需真实生成并下载媒体。

## 6. Grok 高质量图片生成

```bash
curl "https://cf-global.junfeiai.com/v1/images/generations" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-quality",
    "prompt": "A centered red circle on a clean white background, no text, no watermark."
  }'
```

快速生成只需把模型替换为 `grok-imagine-image`。Grok 图片路由会删除 `size`，不要依赖 `size` 控制最终尺寸，应以实际返回媒体为准。可用标准是 HTTP 200，且最终图片可以下载并通过文件签名与尺寸校验；只看到模型目录或任务被接受都不够。

## 7. Grok 图片编辑

```bash
curl "https://cf-global.junfeiai.com/v1/images/edits" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-edit",
    "prompt": "Place this logo centered on a clean white square canvas. Preserve the logo colors and add no text.",
    "image": {
      "image_url": "https://cf-global.junfeiai.com/logo.png"
    }
  }'
```

本页只把 HTTPS 图片地址列为已验证输入方式；Data URL 和 multipart 必须单独实测成功后再加入稳定文档。

## 8. 响应与验收

不要只检查 HTTP 200：

1. `b64_json` 或 `image_generation_call.result` 必须可以 Base64 解码。
2. 解码文件必须具有真实 PNG、JPEG 或 WebP 文件头。
3. URL 响应必须继续下载并检查 HTTP 200、图片 Content-Type 和非零字节。
4. 保存缩短后的请求标识用于排障，不保存带签名的媒体 URL。

## 9. 常见错误

| 现象 | 原因与处理 |
| --- | --- |
| `401` | API Key 缺失或无效 |
| `403` | 分组未开放图片生成权限 |
| `404 model_not_found` | 当前分组看不到目标图片模型 |
| `400 images[].image_url is required` | 编辑请求格式错误，或标准边缘入口改写了请求；按第 4 节切换已验证入口 |
| `503 Service temporarily unavailable` | 当前图片账号不可调度或上游暂不可用 |
| HTTP 200 但媒体不可用 | 继续校验 Base64、下载状态、Content-Type 和文件头 |

---

<!-- Source: https://doc.global.junfeiai.com/docs/video-api.html -->
# JunFeiAI cf-global AI 视频接口

cf-global 视频接口支持 OpenAI 风格和 xAI 风格两种创建方式。两种请求都会进入同一套异步任务系统：创建任务、轮询状态、下载最终视频。不同模型的输入模式、字段类型、时长、分辨率和下载方式并不完全相同，请先按本页的逐模型规格选择请求结构。

最后更新：2026-08-06

配置核对：2026-08-06（Asia/Shanghai）

## 1. 当前可用模型与默认最终价

| 模型 | 当前状态 | 主要用途 | cf-global 默认实扣 |
| --- | --- | --- | ---: |
| `grok-imagine-video` | 可用 | 文生、单图首帧、多图参考 | $0.85 / 次 |
| `grok-imagine-video-1.5` | 可用 | 单图首帧生视频 | $1.02 / 次 |
| `veo-3.1` | 可用 | 带原生音频的文生视频 | $1.55 / 次 |

海螺 `minimax-h3` 当前没有可调度的新上游账号或模型映射，因此仍不可调用；`seedance-2.0`、`seedance-2.0-fast`、`kling-3.0-omni` 和 `happyhorse` 的旧上游也不属于当前可调用模型。`seedance-2.0` 新渠道已经完成适配与价格预配置，但上游余额为零，尚未通过真实媒体验收，所以仍未开放。不要根据历史文档、历史价格或预配置价格直接发起请求。

模型权限按 API Key 分组隔离。每次接入前先调用 `GET /v1/models`，只有返回列表中存在的模型才能使用。Grok 与 Veo 当前按创建任务次数固定计费；账号专属倍率可覆盖组默认值。完整价格口径见[官方价格与实际扣费](https://doc.global.junfeiai.com/docs/pricing.html)。

## 2. 先选择输入模式

| 模型 | 文生视频 | 单图首帧 | 多图参考 | 已确认时长 | 已确认分辨率 |
| --- | --- | --- | --- | --- | --- |
| `grok-imagine-video` | 支持 | 支持 | 支持，1–7 张 | 文生/单图 6–15 秒；多图 6–10 秒 | 480P、720P |
| `grok-imagine-video-1.5` | 不支持 | 支持，必须传图 | 不支持 | 6–15 秒 | 480P、720P、1080P |
| `veo-3.1` | 支持 | 上游文档支持最多 3 张，cf-global 尚未逐项验收 | 尚未对外确认 | 4、6、8 秒（标准直连） | 720P、1080P；8 秒 16:9 成片已实测为 1920×1080 |

单图与多图是两种不同模式：`image` 会锁定首帧；`reference_images` 只约束视频中应出现的主体或风格。不要在一个请求里同时传这两个字段。多图模式的规则与字段来自 [xAI Reference-to-Video](https://docs.x.ai/developers/model-capabilities/video/reference-to-video)。

## 3. `grok-imagine-video` 详细规格

- 推荐端点：OpenAI 风格 `POST /v1/videos`；xAI 风格 `POST /v1/videos/generations`。
- 文生视频：只传 `prompt`，不要传图片字段。
- 单图首帧：OpenAI 风格传 `input_reference`，xAI 风格传 `image`。
- 多图参考：OpenAI 风格传 `images`，xAI 风格传 `reference_images`；1–7 张，不能与单图字段同传。
- 时长：文生或单图 6–15 秒；多图参考 6–10 秒。
- 分辨率：已确认 480P、720P；画幅由 `size` 或 `aspect_ratio` 指定。
- 下载：优先查询任务后使用响应中的完整签名 URL；裸 `/content` 可能返回 400。

最小文生请求：

```json
{
  "model": "grok-imagine-video",
  "prompt": "A cinematic slow push-in toward a neon city street at night, no text.",
  "seconds": 6,
  "size": "1280x720"
}
```

:::video-demo grok-imagine-video

## 4. `grok-imagine-video-1.5` 详细规格

- 推荐端点：OpenAI 风格 `POST /v1/videos`；xAI 风格 `POST /v1/videos/generations`。
- 仅支持单图首帧生视频；请求必须提供一张图片。
- 不支持纯文本生视频，也不支持 `reference_images` 多图参考。
- OpenAI 风格使用 `input_reference`；xAI 风格使用 `image: {"url":"..."}`。
- 时长：6–15 秒；分辨率：480P、720P、1080P。
- 下载：与 `grok-imagine-video` 相同，优先使用任务响应中的完整签名 URL。

最小单图请求：

```json
{
  "model": "grok-imagine-video-1.5",
  "prompt": "Preserve the subject identity and colors, add a subtle camera push-in.",
  "seconds": 6,
  "size": "720x1280",
  "input_reference": "https://example.com/input.png"
}
```

:::video-demo grok-imagine-video-1.5

## 5. `veo-3.1` 详细规格

- 推荐端点：`POST /v1/videos/generations`；也兼容 `POST /v1/videos`。
- 当前对外确认文生视频；图片参考、首尾帧和多图输入尚未完成 cf-global 逐项验收，不应作为稳定能力使用。
- xAI 风格使用 `duration`、`resolution`、`aspect_ratio`；OpenAI 风格使用 `seconds`、`size`。网关会把时长转换成上游要求的字符串，并把规格转换成像素尺寸。
- 标准直连接口支持 4、6、8 秒；2026-08-07 已通过 cf-global 生产链路完成真实付费验收：8 秒、1080P、16:9，最终 MP4 为 8.000 秒、1920×1080，包含 H.264 视频轨和 AAC 音频轨。
- 上游另有独立的延长流程可把视频扩展到 15 秒，但该流程尚未接入 cf-global；因此当前公开模型的直接创建上限是 8 秒，而不是 15 秒。
- `generate_audio` 可以传布尔值，但当前渠道实测即使传 `false` 仍可能返回音轨。需要静音成片时，应在下载后由客户端移除音轨，不能把该字段当作强保证。
- 创建任务按 $1.55 / 次固定计费：当前上游 ¥0.55 / 次，按“直接加 1 个余额单位”定价；当前充值口径为 ¥1 = 1 刀余额。HTTP 200 只表示任务已接受，必须继续轮询到 `completed`。
- 下载必须使用任务查询响应返回的完整签名 URL，包含所有查询参数；手工拼接裸 `/content` 会返回 `missing_signature`。

已验证的最小请求：

```json
{
  "model": "veo-3.1",
  "prompt": "晴朗的夏日海岸，一位身穿浅粉色长裙的年轻东亚女性赤脚沿花径缓慢行走，35mm中远景平滑跟随，蓝绿色海水、白色浪花与巨大积云，单镜头写实旅行广告，无文字和水印。",
  "seconds": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
```

:::video-demo veo-3.1

## 6. 暂时不可调用的旧模型

以下模型曾接入 AI 视频专业组，但当前账号池不可调度，也不在该组 API Key 的实时 `/v1/models` 返回中：

| 模型 | 当前处理 | 客户端行为 |
| --- | --- | --- |
| `minimax-h3`（海螺） | 待补新渠道；当前无可调度账号或映射 | 不要发起请求；补齐真实上游并通过 MP4 验收后再开放 |
| `seedance-2.0` | 新渠道已适配但上游未充值 | 不要发起请求；完成充值和真实 MP4 验收后才会开放 |
| `seedance-2.0-fast` | 旧线路暂停 | 不要发起请求 |
| `kling-3.0-omni` | 旧线路暂停 | 不要发起请求 |
| `happyhorse` | 旧线路暂停 | 不要发起请求 |

历史价格和历史成功记录不代表当前可用。新线路上线后会以实际公开模型 ID、逐模型参数和新价格重新发布。

## 7. OpenAI 风格创建视频

端点：`POST /v1/videos`

### 文生视频 JSON

```bash
curl "https://cf-global.junfeiai.com/v1/videos" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "A cinematic slow push-in toward a neon city street at night, no text.",
    "seconds": 6,
    "size": "720x1280"
  }'
```

### 单图生视频 JSON

使用公开 HTTPS 图片地址或 Base64 Data URL：

```bash
curl "https://cf-global.junfeiai.com/v1/videos" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Animate the subject with a subtle camera push-in, preserve identity and colors.",
    "seconds": 6,
    "size": "720x1280",
    "input_reference": "https://example.com/input.png"
  }'
```

### 单图生视频 multipart

上传本地图片时使用 `multipart/form-data`：

```bash
curl "https://cf-global.junfeiai.com/v1/videos" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -F "model=grok-imagine-video-1.5" \
  -F "prompt=Animate the subject with a subtle camera push-in, preserve identity and colors." \
  -F "seconds=6" \
  -F "size=720x1280" \
  -F "input_reference=@input.png"
```

### 多图参考生视频 JSON

`images` 数组有 2 张及以上图片时，网关会完整转换为官方 `reference_images`，不会再只取第一张：

```bash
curl "https://cf-global.junfeiai.com/v1/videos" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "The person from <IMAGE_1> walks onto the stage wearing the jacket from <IMAGE_2>, cinematic camera movement.",
    "seconds": 10,
    "size": "1280x720",
    "images": [
      {"image_url": "https://example.com/person.png"},
      {"image_url": "https://example.com/jacket.png"}
    ]
  }'
```

### 多图参考生视频 multipart

本地多图使用同名 `reference_images` 字段重复上传，最多 7 张：

```bash
curl "https://cf-global.junfeiai.com/v1/videos" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -F "model=grok-imagine-video" \
  -F "prompt=The person from <IMAGE_1> uses the product from <IMAGE_2> in a bright studio." \
  -F "seconds=10" \
  -F "size=1280x720" \
  -F "reference_images=@person.png" \
  -F "reference_images=@product.png"
```

OpenAI 风格兼容 `seconds`、`size` 和 `input_reference`。单图还接受 `image`、`image_url`；多图还接受 `images`、`image_urls` 和 `reference_images`。带 `[]` 的 multipart 字段名，例如 `reference_images[]`，也会被识别。上传文件或 Base64 图片时，每张图片最大 20 MiB，网关会临时转成上游可访问的签名图片地址。

## 8. xAI 风格创建视频

端点：`POST /v1/videos/generations`

### 文本生视频

```bash
curl "https://cf-global.junfeiai.com/v1/videos/generations" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "A cinematic slow push-in toward a neon city street at night, no text.",
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "9:16"
  }'
```

### 单图生视频

```bash
curl "https://cf-global.junfeiai.com/v1/videos/generations" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Animate the subject with a subtle camera push-in, preserve identity and colors.",
    "image": {
      "image_url": "https://example.com/input.png"
    },
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "9:16"
  }'
```

### 多图参考生视频

```bash
curl "https://cf-global.junfeiai.com/v1/videos/generations" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "The person from <IMAGE_1> presents the product from <IMAGE_2> in a clean studio commercial.",
    "reference_images": [
      {"url": "https://example.com/person.png"},
      {"url": "https://example.com/product.png"}
    ],
    "duration": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'
```

xAI 风格的规范字段是 `duration`、`resolution`、`aspect_ratio`、单图 `image` 和多图 `reference_images`。图片对象使用 `{"url":"https://..."}`；兼容写法 `{"image_url":"https://..."}` 会被网关改成规范格式。网关还识别 `durationSeconds`、`videoSize`、`videoResolution` 和 `aspectRatio` 等 camelCase 别名。

## 9. 创建响应

创建成功后会返回视频任务对象。兼容响应通常同时包含 `id`、`task_id` 或 `request_id` 中的一个或多个字段：

```json
{
  "id": "task_example",
  "request_id": "task_example",
  "status": "queued"
}
```

保存任务 ID 用于后续查询。HTTP 200 只表示任务已被接受，不代表最终 MP4 已生成。

创建响应可能直接返回 `queued`、`in_progress` 或 `processing`。轮询时继续接受这些进行中状态；遇到 `completed` 或 `succeeded` 表示成功，遇到 `failed`、`cancelled` 或 `canceled` 表示失败终态。

视频任务按创建时的用户和 API Key 隔离。后续查询必须继续使用创建任务的同一个 API Key；同组的另一个 Key 也可能返回 `Video request not found`。

## 10. 查询任务

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

轮询建议：

1. 创建成功后等待 3 至 5 秒再首次查询。
2. 使用固定间隔或指数退避，避免高频轮询。
3. 进入成功、失败或取消终态后停止轮询。
4. 不要把带签名的最终视频 URL 写入公开日志。

## 11. 下载视频

任务完成后，查询响应通常会返回带时效签名的 `url` 或 `video.url`。Grok 与 Veo 视频都必须原样使用该地址，不要删除或重写它的查询参数：

```bash
TASK_JSON="$(curl -fsS "https://cf-global.junfeiai.com/v1/videos/TASK_ID" \
  -H "Authorization: Bearer $JUNFEIAI_API_KEY")"

DOWNLOAD_URL="$(printf '%s' "$TASK_JSON" | jq -r '.url // .video.url // empty')"
test -n "$DOWNLOAD_URL" || { echo "video is not completed or download URL is missing" >&2; exit 1; }

curl -fL "$DOWNLOAD_URL" --output result.mp4
```

不要根据任务 ID 手工拼接裸 `/content`。该路径缺少任务中心生成的定位参数和签名时，Grok 可能返回 400，Veo 会返回 `missing_signature`。如果签名失效，应使用创建任务时的同一个 API Key 重新查询任务并取得新的完整下载 URL。

下载路由支持标准 Range 请求，并会使用 R2 视频缓存减少重复回源。签名有有效期，应在任务完成后及时下载，不要把完整 URL 写入公开日志或长期存储。客户端还应校验 HTTP 状态、`Content-Type`、文件大小和 MP4 文件头。

## 12. 完整入参与兼容字段

| 参数 | 必填 | OpenAI 风格 | xAI 规范字段 | 类型与说明 |
| --- | --- | --- | --- | --- |
| 模型 | 是 | `model` | `model` | 字符串；必须是当前 API Key 的 `/v1/models` 中可见模型 |
| 提示词 | 是 | `prompt` | `prompt` | 非空字符串；多图提示词可用 `<IMAGE_1>`、`<IMAGE_2>` 指代数组顺序 |
| 时长 | 建议显式传 | `seconds` | `duration` | 客户端传整数秒；Veo 网关会转换成上游要求的字符串；兼容 `duration_seconds`、`durationSeconds` |
| 输出尺寸 | 建议显式传 | `size`，如 `1280x720` | `resolution`，如 `720p` | 短边必须映射到模型支持的 480P、720P 或 1080P 档位 |
| 画幅 | 建议显式传 | 从 `size` 自动推导 | `aspect_ratio` | 如 `16:9`、`9:16`；兼容 `aspectRatio` |
| 单张首帧图 | 图生视频必填 | `input_reference` | `image` | URL、Base64 Data URL、图片对象，或 multipart 本地文件 |
| 多张参考图 | 多图模式必填 | `images` 或 `reference_images` | `reference_images` | 图片对象数组；`grok-imagine-video` 最多 7 张，不能与 `image` 同传 |

兼容字段的归一化规则：

| 客户端入参 | 网关最终转发 | 规则 |
| --- | --- | --- |
| `input_reference`、`image_url` | `image: {"url":"..."}` | 单图首帧模式 |
| 只有 1 个元素的 `images` / `image_urls` | `image: {"url":"..."}` | 保持旧客户端的单图语义 |
| 2–7 个元素的 `images` / `image_urls` | `reference_images: [{"url":"..."}, ...]` | 多图参考模式，保留全部图片及顺序 |
| `reference_images` | `reference_images` | 即使只有 1 张，也明确按参考图模式处理 |
| multipart 重复的 `reference_images` 或 `reference_images[]` | `reference_images` 数组 | 每个文件单独临时存储并转成签名 URL |

图片输入支持公开 HTTPS URL、`data:image/...;base64,...` 和 multipart 文件。文件或 Base64 图片每张最大 20 MiB；建议使用 PNG、JPEG 或 WebP。远程 URL 必须能被上游直接访问，不能使用本机路径、内网地址或需要 Cookie 登录的链接。

| 模型/模式 | 时长范围 | 未传时长 | 未传分辨率 |
| --- | --- | --- | --- |
| Grok 文本或单图 | 6–15 秒 | 15 秒 | 480P |
| Grok 多图参考 | 6–10 秒 | 10 秒 | 480P |
| `veo-3.1` | 4、6、8 秒（标准直连） | 不应依赖默认值 | 不应依赖默认值；显式传 1080P |

参数被网关识别只表示会被归一并透传；最终时长、分辨率和画幅仍以上游返回视频的真实媒体信息为准。

## 13. 常见错误

| 现象 | 原因与处理 |
| --- | --- |
| `401` | API Key 缺失或无效 |
| `403` | 当前 API Key 分组未开放目标视频模型 |
| `404 model_not_found` | 模型不属于当前分组，先查询 `/v1/models` |
| `400` 或 `422` | 参数格式或目标模型不支持该组合，先缩减为最小请求 |
| `conflicting_video_input` | 同时传了单图 `image` 和多图 `reference_images`；二选一 |
| `unsupported_reference_video_model` | 多图模式不是 `grok-imagine-video`；不能使用 1.5 或专业组模型 |
| `too_many_reference_images` | 多图超过 7 张 |
| `unsupported_reference_video_duration` | 多图时长超过 10 秒 |
| `video_input_too_large` | 单张上传图片或 Base64 图片超过 20 MiB |
| `502` | 上游任务创建或媒体回源失败，记录任务 ID 与绝对时间后重试 |
| `503 Service temporarily unavailable` | 当前账号池不可调度或上游暂不可用 |
| `Video request not found` | 查询使用了不同 API Key；改用创建任务时的同一个 Key |
| 裸 `/content` 返回 400 | 不要手工构造下载地址；重新查询任务并使用返回的完整签名 URL |
| 任务完成但视频打不开 | 重新获取签名 URL，并检查状态、Content-Type、字节数和签名有效期 |

---

<!-- Source: https://doc.global.junfeiai.com/docs/pricing.html -->
# JunFeiAI cf-global 官方价格与实际扣费

本页把“厂商官方公开价”和“cf-global 实际扣费”分开列出。官方价用于横向比较；cf-global 价格来自 2026-08-06 的生产分组、渠道定价和账单核对。

最后更新：2026-08-06（Asia/Shanghai）

## 1. 计费口径

cf-global 账户余额在账单中以 `$` 展示。当前余额口径为 **¥1 = 1 刀余额**；具体充值活动或销售渠道如有额外赠送，以对应商品说明为准。

```text
actual_cost = total_cost × effective_rate_multiplier
```

| 字段 | 含义 |
| --- | --- |
| `total_cost` | 按站内模型基础价、图片档位或视频计费别名计算的未乘倍率金额 |
| `rate_multiplier` | 请求发生时的分组倍率，或账号专属覆盖倍率 |
| `actual_cost` | 最终从余额或订阅额度结算的金额 |

> 官方价和 cf-global 价可能采用不同计费单位。例如 xAI 视频官方按秒计费，cf-global 当前 Grok 视频按创建任务次数计费；不能只比较表中的数字而忽略单位。

## 2. 当前标准分组倍率

| API Key 分组 | 主要能力 | 当前倍率 | 说明 |
| --- | --- | ---: | --- |
| `chatgpt-余额组(plus)` | GPT 文本 | 0.15 | 站内文本基础价 × 0.15 |
| `chatgpt-余额组(pro)` | GPT 文本 | 0.30 | 站内文本基础价 × 0.30；账号专属倍率可覆盖 |
| `chatgpt- image2` | GPT 图片 | 0.50 | 图片规格基础价 × 0.50 |
| `gemini` | Gemini 文本与多模态 | 0.50 | 官方基础 Token 价 × 0.50；当前账号池维护中 |
| `grok-视频` | Grok 文本与视频 | 0.85 | Grok 渠道基础价 × 0.85 |
| `grok-image` | Grok 文本与图片 | 0.50 | Grok 渠道基础价 × 0.50 |
| `AI视频-专业版` | Veo 3.1 | 1.00 | 当前只开放 `veo-3.1`，按创建任务次数固定计费 |

分组倍率以后可能调整，历史账单始终保留请求发生时的 `rate_multiplier`。账号存在专属倍率时，以该请求的 `actual_cost` 为准。

## 3. 文本模型

### OpenAI GPT 5.5 / 5.6

以下均为标准短上下文、每 100 万 Token 的输入 / 输出价格。

| 模型 | OpenAI 官方价 | cf-global 站内基础价 | Plus 最终价 | Pro 最终价 |
| --- | ---: | ---: | ---: | ---: |
| `gpt-5.5` | $5 / $30 | $5 / $30 | $0.75 / $4.50 | $1.50 / $9.00 |
| `gpt-5.6` | 同 Sol：$5 / $30 | 当前路由到 Sol | $0.75 / $4.50 | $1.50 / $9.00 |
| `gpt-5.6-sol` | $5 / $30 | $5 / $30 | $0.75 / $4.50 | $1.50 / $9.00 |
| `gpt-5.6-terra` | $2.50 / $15 | $2 / $12 | $0.30 / $1.80 | $0.60 / $3.60 |
| `gpt-5.6-luna` | $1 / $6 | $0.20 / $1.20 | $0.03 / $0.18 | $0.06 / $0.36 |

`gpt-5.6-terra` 和 `gpt-5.6-luna` 的站内文本基础价低于 OpenAI 当前官方公开价。这不是换算错误，而是 cf-global 当前生产渠道的实际配置。

缓存价格也按每 100 万 Token 计费：

| 模型 | 官方 / 站内缓存写入基础价 | 官方 / 站内缓存读取基础价 | Plus 写入 / 读取 | Pro 写入 / 读取 |
| --- | ---: | ---: | ---: | ---: |
| `gpt-5.6-sol` | $6.25 | $0.50 | $0.9375 / $0.075 | $1.875 / $0.15 |
| `gpt-5.6-terra` | $3.125 | $0.25 | $0.46875 / $0.0375 | $0.9375 / $0.075 |
| `gpt-5.6-luna` | $1.25 | $0.10 | $0.1875 / $0.015 | $0.375 / $0.03 |

OpenAI 对超过 272K 输入 Token 的 GPT 5.5/5.6 请求采用长上下文价格：完整请求的输入按 2 倍、输出按 1.5 倍计算。上表只展示标准短上下文价。

官方来源：[OpenAI Models](https://developers.openai.com/api/docs/models)、[OpenAI Pricing](https://developers.openai.com/api/docs/pricing)。

### Gemini

| 模型 | Google 官方价 | cf-global 标准组最终价 | 当前状态 |
| --- | ---: | ---: | --- |
| `gemini-3.1-pro-preview` | ≤200K：$2 / $12；>200K：$4 / $18 | ≤200K：$1 / $6；>200K：$2 / $9 | 2026-08-02 有成功账单；2026-08-03 实测 503 |
| `gemini-3.5-flash` | $1.50 / $9 | $0.75 / $4.50 | 生产目录可见；2026-08-03 实测 503 |

Gemini 当前两次最小请求都返回 `503 No available accounts`，因此模型广场标记为“当前维护中”。这里仍列出标准组价格，便于账号池恢复后直接核对账单。

官方来源：[Gemini Developer API Pricing](https://ai.google.dev/gemini-api/docs/pricing)。

### Grok

以下为短上下文、每 100 万 Token 的输入 / 输出价格。

| 模型 | xAI 官方价 | `grok-image` 组最终价（0.50） | `grok-视频` 组最终价（0.85） |
| --- | ---: | ---: | ---: |
| `grok-4.3` | $1.25 / $2.50 | $0.625 / $1.25 | 当前该组目录不开放 |
| `grok-4.5` | $2 / $6 | $1 / $3 | $1.70 / $5.10 |

xAI 官方缓存输入价为：`grok-4.3` $0.20、`grok-4.5` $0.30 / 百万 Token。提示词达到 200K 后，xAI 对整条请求启用长上下文价格。

官方来源：[xAI Pricing](https://docs.x.ai/developers/pricing)。

## 4. 图片模型

### GPT Image 2

OpenAI 官方对 `gpt-image-2` 按图像 Token 计费：图像输入 $8、缓存图像输入 $2、图像输出 $30 / 百万 Token。cf-global 当前图片组按最终规格固定计费：

| 模型 | cf-global 1K | cf-global 2K | cf-global 4K |
| --- | ---: | ---: | ---: |
| `gpt-image-2` | $0.067 / 张 | $0.1005 / 张 | $0.134 / 张 |

本站基础价分别为 $0.134、$0.201、$0.268，再乘图片组 0.50 倍率。官方 Token 价与本站按规格固定价不是同一口径，不能直接把官方每百万 Token 价当成单张价格。

官方来源：[OpenAI Pricing](https://developers.openai.com/api/docs/pricing)、[GPT Image 2](https://developers.openai.com/api/docs/models/gpt-image-2)。

### Grok Imagine

| 模型 | xAI 官方价 | cf-global 1K | cf-global 2K | cf-global 4K |
| --- | --- | ---: | ---: | ---: |
| `grok-imagine-image-quality` | 输出：1K $0.05、2K $0.07 / 张；图片输入 $0.01 / 张 | $0.067 | $0.1005 | $0.134 |
| `grok-imagine-image` | 输出：1K / 2K 均 $0.02 / 张；图片输入 $0.002 / 张 | $0.067 | $0.1005 | $0.134 |

cf-global 的 4K 是账单规格档位；xAI 官方公开表只列 1K / 2K，不应把本站 4K 计费档位解释为官方模型保证输出 4K。

官方来源：[xAI Pricing](https://docs.x.ai/developers/pricing)。

## 5. 视频模型

### Grok Imagine Video

| 模型 | xAI 官方价 | cf-global 当前实扣 | 差异 |
| --- | --- | ---: | --- |
| `grok-imagine-video` | 480P $0.05 / 秒；720P $0.07 / 秒 | $0.85 / 次 | 本站按创建任务次数固定计费 |
| `grok-imagine-video-1.5` | 480P $0.08；720P $0.14；1080P $0.25 / 秒，另收图片输入 $0.01 / 张 | $1.02 / 次 | 本站按创建任务次数固定计费 |

官方来源：[xAI Pricing](https://docs.x.ai/developers/pricing)。

### AI 视频专业组

当前专业组只开放已经通过生产真实媒体验收的 `veo-3.1`。

| 公开模型 | 已验收规格 | 当前状态 | cf-global 实扣 |
| --- | --- | --- | ---: |
| `veo-3.1` | 8 秒、1080P、16:9 | 已开放 | $1.55 / 次 |
| `seedance-2.0` | 新渠道尚未产出真实 MP4 | 未开放 | $12.25 / 次（预配置） |

`veo-3.1` 标准直连接口支持 4、6、8 秒；已验证最高规格成片为 8.000 秒、1920×1080，并包含 H.264 视频轨与 AAC 音频轨。当前定价按上游 ¥0.55 / 次直接加 1 个余额单位，即 $1.55 / 次。建议始终显式传 `resolution`、`seconds` 与 `aspect_ratio`，使输出规格可预测。`seedance-2.0` 的价格行仅用于上线前配置；新渠道余额为零且真实请求返回 `insufficient_user_quota`，在充值并通过真实 MP4 验收前不会出现在专业组 `/v1/models` 中。

海螺 `minimax-h3` 当前没有可调度的新上游账号或模型映射；`seedance-2.0-fast`、`kling-3.0-omni`、`happyhorse` 等旧专业组模型也已下架，历史价格不再是当前可调用价格。

厂商官方参考：

| 系列 | 官方公开计费参考 | 说明 |
| --- | --- | --- |
| Seedance 2.0 | 火山引擎活动资源包 ¥196 / 700 万 Token，约 28 条 480P，折合约 ¥7 / 条 | 仅是标准模型活动包参考；Fast 与站内 5s 别名没有独立公开单价 |
| Kling VIDEO 3.0 Omni | 720P：6 Credits / 秒（无原生音频）或 9 Credits / 秒（原生音频）；1080P：8 或 12 Credits / 秒 | 语音控制另加 2 Credits / 秒；本站没有按 Credits 结算 |
| HappyHorse 1.0 | 国际区标价：720P $0.14 / 秒、1080P $0.24 / 秒 | 阿里云控制台促销折扣可能变化；本站按次固定计费 |

官方来源：[火山引擎 Seedance 2.0](https://www.volcengine.com/activity/seedance2)、[Kling VIDEO 3.0 Guide](https://app.klingai.com/cn/quickstart/klingai-video-3-model-user-guide)、[Alibaba Cloud Model Pricing](https://www.alibabacloud.com/help/en/model-studio/model-pricing)。

视频只在创建任务时计费，轮询任务状态不会重复扣费。任务创建成功不等于最终 MP4 有效，仍需校验终态、下载状态、Content-Type、文件大小和 MP4 文件头。

## 6. 对账顺序

1. 确认请求使用的 API Key 绑定分组。
2. 确认账单中的请求模型、实际 `upstream_model` 和 `billing_mode`。
3. 读取 `total_cost`、请求时的 `rate_multiplier` 与最终 `actual_cost`。
4. 图片按 `image_size`，AI 视频按分辨率、时长及内部计费别名核对。
5. 账号有专属倍率时，不使用分组默认倍率覆盖历史账单。

官方价格和站内配置都可能调整。本页用于说明 2026-08-03 的公开默认口径；单次请求最终以该请求的生产账单为准。

---

<!-- Source: https://doc.global.junfeiai.com/docs/ai.html -->
# JunFeiAI cf-global AI 与 Agent 接入

本页提供面向大语言模型、代码代理和 API 工具的机器可读入口。人类文档、完整 AI 文档、OpenAPI 和 Skill 随同一次构建发布。

最后更新：2026-08-03

## 1. 机器可读入口

| 资源 | 地址 | 用途 |
| --- | --- | --- |
| AI 索引 | `https://doc.global.junfeiai.com/llms.txt` | 让模型快速发现文档、接口和约束 |
| 模型广场 | `https://doc.global.junfeiai.com/docs/models.html` | 人类可读的完整模型、模态与验证状态目录 |
| 模型目录 JSON | `https://doc.global.junfeiai.com/model-catalog.json` | Agent 可读取的结构化模型选择依据 |
| 完整 AI 文档 | `https://doc.global.junfeiai.com/llms-full.txt` | 一次读取全部 Markdown 接入文档 |
| OpenAPI 3.1 | `https://doc.global.junfeiai.com/openapi.yaml` | 导入 API 客户端、Agent 工具或代码生成器 |
| Agent Skill | `https://doc.global.junfeiai.com/downloads/cf-global-api-skill.zip` | 安装到支持 Agent Skills 的客户端 |
| Skill 校验和 | `https://doc.global.junfeiai.com/downloads/cf-global-api-skill.sha256` | 下载后核对 ZIP 文件完整性 |

## 2. 推荐读取顺序

1. 先读取 `llms.txt`，确定任务需要的端点和详细文档。
2. 读取 `model-catalog.json`，区分“近期可用”“已开放”和“当前维护中”，并分别读取 `officialPrice` 与 `price`。
3. 需要构造请求或工具定义时读取 `openapi.yaml`。
4. 需要完整业务约束、价格和验收方法时读取 `llms-full.txt`。
5. 支持 Agent Skills 的客户端可安装 ZIP，让模型按固定工作流选择端点并校验媒体。

## 3. 给 AI 的最小提示

```text
Read https://doc.global.junfeiai.com/llms.txt first.
Use https://doc.global.junfeiai.com/model-catalog.json for model discovery status.
Use https://doc.global.junfeiai.com/openapi.yaml as the request schema.
Before calling a paid image or video model, state the documented price.
Never print or persist the API key or signed media URLs.
```

## 4. Skill 安全约束

`cf-global-api` Skill 不包含 API Key。调用脚本按顺序读取 `JUNFEIAI_API_KEY` 或 `CF_GLOBAL_API_KEY` 环境变量，默认生产入口为 `https://cf-global.junfeiai.com`。

Skill 的默认检查仅调用 `GET /v1/models`。文本、图片或视频等可能扣费的请求，必须来自用户明确要求；测试图片或视频前应先说明文档价格。媒体任务不能只检查 HTTP 200，还要校验最终图片或 MP4。

## 5. 数据新鲜度

模型目录以目标 API Key 实时调用 `/v1/models` 的结果为准。公开价格和已验证状态来自文档构建时的生产核对，实际请求仍应保存请求 ID、绝对时间和账单结果用于对账。

不要把带 Bearer Token 的请求、API Key、Refresh Token 或带签名的媒体 URL 提交给公共 AI 索引。

---

<!-- Source: https://doc.global.junfeiai.com/docs/image-2-api.html -->
# image-2 兼容与迁移说明

旧的 image-2 文档链接已迁移到统一 cf-global 图片文档。本页只保留经过生产请求验证的迁移结论。

最后更新：2026-08-03

生产记录核对：2026-08-03（Asia/Shanghai）

## 1. 当前可用入口

| 能力 | 入口 | 真实验证 |
| --- | --- | --- |
| Responses 图片工具 | `POST https://cf-global.junfeiai.com/v1/responses` | HTTP 200，`gpt-image-2` 产物为有效 PNG |
| Images API 生成 | `POST https://cf-global.junfeiai.com/v1/images/generations` | HTTP 200，`b64_json` 为有效 PNG |
| Images API 编辑 | `POST https://cf-global.junfeiai.com/v1/images/edits` | 标准入口近期持续成功；历史输出为有效 PNG |
| 模型发现 | `GET https://cf-global.junfeiai.com/v1/models` | HTTP 200，可见 `gpt-image-2` |

## 2. 迁移规则

1. 新接入统一使用 `gpt-image-2`。
2. 文生图优先使用 `cf-global` 标准入口。
3. 图片编辑默认使用 `cf-global`；`global` 与 `origin-global` 只用于排障。
4. 不再使用历史临时域名、历史路径或无法回读的旧链接。
5. 上线前使用业务自己的 API Key 重跑一条最小请求。

## 3. 完整文档

- [图片生成与编辑](https://doc.global.junfeiai.com/docs/image-api.html)
- [API 接入与 Codex](https://doc.global.junfeiai.com/docs/api.html)
- [文本模型](https://doc.global.junfeiai.com/docs/text-api.html)
- [模型广场](https://doc.global.junfeiai.com/docs/models.html)

验证标识和可复制示例统一维护在最新图片文档中，避免兼容页与主文档漂移。