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. 推荐读取顺序
- 先读取
llms.txt，确定任务需要的端点和详细文档。 - 读取
model-catalog.json，区分“近期可用”“已开放”和“当前维护中”，并分别读取officialPrice与price。 - 需要构造请求或工具定义时读取
openapi.yaml。 - 需要完整业务约束、价格和验收方法时读取
llms-full.txt。 - 支持 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 索引。