提示词生成 API

输入意图与场景，输出结构化提示词。让内部提示词工程能力对外可调用。

POST /v1/prompt v1 免费额度 · 申请制

快速开始

替换 YOUR_KEY 为你申请到的 Key，直接发起首个请求：

# 生成结构化提示词
curl -X POST https://skyaibi.com/v1/prompt \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"intent": "月度经营分析报告初稿", "role": "销售总监",
       "scene": "内部汇报", "output": "markdown"}'

# 响应
{"code": 0, "data": {
  "prompt": "你是一位资深的……",
  "structure": ["角色", "任务", "输入变量", "输出格式", "约束"],
  "variables": ["{{period}}", "{{data_source}}"]
}}

示例参数为示意，正式字段与枚举值以 OpenAPI 3.1 规范为准（下方可下载，可直接导入 Apifox / Postman）。

鉴权与调用约束

所有请求携带请求头 X-API-Key，在申请开通后由系统下发
支持 output 为 markdown / json / text，默认 markdown
限频规则：免费额度内默认 20 次/分钟，超限返回 429
返回的 variables 为可替换变量，便于接入你自己的业务数据

接口清单

方法	路径	说明
POST	/v1/prompt	按意图与场景生成结构化提示词
GET	/v1/prompt/templates	获取内置提示词模板库（按岗位/场景）
POST	/v1/prompt/refine	对已有提示词做结构化改写与优化

错误码

code	含义	处理建议
40001	无效 API Key	检查 X-API-Key 是否正确、是否已开通
40002	免费额度用尽	升级套餐或联系商务扩容
422	参数缺失/不合法	按错误信息中 field 字段修正请求体
429	触发限频	降低调用频率，参考 Retry-After 响应头
500	服务内部错误	稍后重试，持续失败请联系我们

规范与申请

下载 OpenAPI 3.1 规范（JSON）申请 API Key

FAQ

常见问题

提示词生成 API 适合什么场景？

适合把「怎么问 AI」这件事标准化：批量给团队成员生成岗位提示词、把口头需求转成结构化指令、统一企业内部的 AI 使用口径。

生成的提示词会不会泄露我的业务信息？

接口仅根据传入的意图与场景生成模板结构，不写回任何外部模型训练；具体业务数据由你在调用下游模型时自行控制。