Agent / MCP 集成

把九凤生图接入 OpenAI 兼容客户端、Agent 与（即将推出的）MCP。

九凤开放 API 面向 Agent 与自动化场景提供三条接入路径。

1. OpenAI 兼容客户端

网关是 OpenAI 兼容风格：把客户端的 base_url 指向九凤、用你的 sk-jf-live- 密钥即可复用现有 SDK。

Python (openai SDK)

from openai import OpenAI
 
client = OpenAI(
    api_key="sk-jf-live-YOUR_KEY",
    base_url="https://api.jiufeng.ai/v1",
)

注意：九凤生图是异步的。/v1/images/generations 返回的是 task_id（不是 OpenAI 那种同步的 data[].url），你仍需按查询任务轮询、或用 Webhook 拿最终结果。把它当"提交任务"用，而不是"一次拿图"。

给 Agent / 代码生成工具喂机器可读规格，让它们自动理解端点与字段：

llms.txt：面向大模型的站点摘要（产品简介 + 基础 URL + 鉴权 + 端点清单 + 各文档页链接），便于 Agent 快速建立对九凤开放 API 的上下文。
OpenAPI spec：完整的端点、请求 / 响应 schema（openapi.yaml，随 API 演进校准）。

两者都在站根可下载：https://docs.jiufeng.ai/llms.txt、https://docs.jiufeng.ai/openapi.yaml。

官方 jiufeng-mcp 会把生图 / 查询任务封装成 Model Context Protocol 工具，让支持 MCP 的 Agent（如 Claude、各类 IDE Agent）直接调用九凤生图，无需手写 HTTP。

MCP Server 目前规划中 / 即将推出。上线后本页会补上官方 server 名称、安装方式与工具清单。在此之前，请用上面的 OpenAI 兼容方式接入。