Base URL: https://www.fieng.cn ｜ OpenAPI JSON: /api/v1/openapi.json ｜ 计费：1元 = 10积分
1. 鉴权方式
| 方式 | 请求头 | 适用 |
|---|
| API Key（开放API） | x-api-key: <你的Key>（或 body 传 apiKey 字段） | POST /api/v1/generate。在平台登录后调 POST /api/v1/apikeys 生成，明文仅展示一次。 |
| 登录态 | x-session-id: <sessionId> | Key管理接口（/api/v1/apikeys、/api/admin/api-keys）。登录 POST /api/auth/login 后从响应 data.sessionId 取得。 |
2. 生成接口 POST /api/v1/generate
请求头：Content-Type: application/json，x-api-key: <你的Key>
| 字段 | 类型 | 必填 | 说明 |
|---|
| tool | string | 是 | text2image（文生图）或 chat_image（对话生图） |
| params | object | 是 | text2image: prompt(必填)、model、size、aspect_ratio、negative_prompt；chat_image: prompt(必填)、size、count(1-4) |
| apiKey | string | 否 | 可替代 x-api-key 请求头 |
curl -X POST https://www.fieng.cn/api/v1/generate \
-H "Content-Type: application/json" \
-H "x-api-key: jl_你的Key" \
-d '{"tool":"text2image","params":{"prompt":"电商白底商品图","model":"yunlu_lite","size":"1024x1024"}}'
# 成功返回（业务数据在 data 字段）
{"code":200,"message":"success","data":{...生成记录与作品地址...}}
# 缺少Key返回
{"code":401,"message":"缺少API Key（x-api-key头或apiKey字段）","data":null}
3. Key管理接口
| 接口 | 鉴权 | 说明 |
|---|
| POST /api/v1/apikeys | 登录态 | 生成新Key，body {"name":"备注"}，响应 data.api_key 为明文，仅返回一次 |
| GET /api/v1/apikeys | 登录态 | 我的Key列表（脱敏，含 last_used_at） |
| POST /api/v1/apikeys/:id/revoke | 登录态 | 撤销自己的Key |
| GET /api/admin/api-keys | 管理员登录态 | 全站Key管理（含绑定用户与 last_used_at） |
4. 错误码表
| code | 含义 | 说明 |
|---|
| 200/0 | 成功 | 业务数据在 data 字段 |
| 400 | 参数缺失/不合法 | 空prompt、不支持的tool |
| 401 | 未鉴权 | 缺少 x-api-key / x-session-id |
| 402 | 积分不足 | 请充值或更换低成本模型 |
| 403 | 凭证无效 | API Key无效/已撤销/用户不可用 |
| 429 | 触发限流 | 请求过于频繁，稍后重试 |
| 5xx | 上游/服务器错误 | 生成失败积分自动返还 |
5. 计费对照（1元 = 10积分）
| 能力 | 积分 | 约合人民币 |
|---|
| 文生图 yunlu_lite | 5 | 0.5元 |
| 文生图 yunlu_pro | 8 | 0.8元 |
| 文生图 yunlu_max | 15 | 1.5元 |
| 对话生图 | 5 | 0.5元 |
注：失败自动返还积分。更多工具后续逐步开放到 /api/v1/generate 白名单。
版本 1.0.0 ｜ JLA-20261030-01 ｜ 本页为独立静态文件，与前端SPA无关