{"openapi":"3.0.3","info":{"title":"加鹿AI 开放API","version":"1.0.0","description":"加鹿AI平台开放接口文档。计费：1元=10积分。"},"servers":[{"url":"https://fieng.cn"}],"components":{"securitySchemes":{"SessionAuth":{"type":"apiKey","in":"header","name":"x-session-id"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"ApiResponse":{"type":"object","description":"统一响应。成功 code=0/200，业务数据在 data。","properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{}}}}},"paths":{"/api/v1/generate":{"post":{"summary":"开放API统一生成端点（API Key鉴权）","description":"工具白名单：text2image（文生图）、chat_image（对话生图）。计费：1元=10积分，失败自动返还积分。","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"string","description":"API Key，也可放 x-api-key 请求头"},"tool":{"type":"string","example":"text2image","enum":["text2image","chat_image"]},"params":{"type":"object","properties":{"prompt":{"type":"string","example":"赛博朋克城市夜景"},"model":{"type":"string","example":"yunlu_lite"},"size":{"type":"string","example":"1024x1024"},"aspect_ratio":{"type":"string","example":"1:1"},"negative_prompt":{"type":"string"},"count":{"type":"integer","example":1}}}},"required":["tool"]},"example":{"apiKey":"jl_xxxx","tool":"text2image","params":{"prompt":"赛博朋克城市夜景","model":"yunlu_lite","size":"1024x1024"}}}}},"responses":{"200":{"description":"生成成功","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"},"example":{"code":200,"message":"success","data":{"record_id":123,"results":["https://www.fieng.cn/static/xxx.png"]}}}}},"400":{"description":"不支持的tool/参数错误","content":{"application/json":{"example":{"code":400,"message":"不支持的tool: xxx","data":null}}}},"401":{"description":"缺少API Key","content":{"application/json":{"example":{"code":401,"message":"缺少API Key（x-api-key头或apiKey字段）","data":null}}}},"403":{"description":"Key无效或已撤销","content":{"application/json":{"example":{"code":403,"message":"API Key无效或已撤销","data":null}}}},"429":{"description":"触发限流"},"500":{"description":"上游模型/服务器错误（积分自动返还）"}}}},"/api/v1/apikeys":{"get":{"summary":"Key列表（脱敏）","security":[{"SessionAuth":[]}],"responses":{"200":{"description":"Key列表"}}},"post":{"summary":"生成新Key（明文仅返回一次）","security":[{"SessionAuth":[]}],"responses":{"200":{"description":"返回api_key明文"}}}},"/api/admin/api-keys":{"get":{"summary":"全站API Key管理列表（管理员，含last_used_at）","security":[{"SessionAuth":[]}],"responses":{"200":{"description":"全站Key列表（key_hash脱敏、明文不返回）"},"401":{"description":"未登录"},"403":{"description":"非管理员"}}}}}}