提示词优化 API

接口信息

获取 API Key

前往自助申请页面，填写名称即可立即获取密钥，无需审核。

认证方式

在请求头中携带 X-API-Key：

X-API-Key: sk-your-api-key

请求示例

cURL

curl -X POST http://101.43.95.130:5002/api/v1/prompt/optimize \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk-your-api-key" \
  -d '{"input_text": "写一个Python数据分析脚本，处理销售CSV并生成月度汇总报告"}'

Python

import requests

resp = requests.post(
    "http://101.43.95.130:5002/api/v1/prompt/optimize",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "sk-your-api-key"
    },
    json={"input_text": "写一篇关于agent协助的设计方案"}
)

result = resp.json()
print(result["data"]["optimized_prompt"])

JavaScript

const resp = await fetch("http://101.43.95.130:5002/api/v1/prompt/optimize", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "sk-your-api-key"
  },
  body: JSON.stringify({ input_text: "设计一个SaaS官网的UI/UX方案" })
});

const { data } = await resp.json();
console.log(data.optimized_prompt);

请求参数

参数	类型	必填	说明
input_text	string	是	需求描述或原始提示词，至少10个字符

响应格式

{
  "code": 200,
  "message": "success",
  "data": {
    "intent_analysis": {
      "core_intent": "技术",
      "sub_category": "Agent协作系统设计",
      "domain": "人工智能与智能体系统",
      "confidence": 0.95,
      "disambiguation_note": "判定依据",
      "alternative_intent": "咨询",
      "key_requirements": ["需求1", "需求2"],
      "expected_output": "预期产出描述",
      "constraints": ["约束1"],
      "keywords": ["agent", "协作", "设计方案"]
    },
    "optimized_prompt": "# 优化后的完整提示词...",
    "usage": {
      "api_calls": 2,
      "prompt_length": 1785
    }
  },
  "rate_limit": {
    "remaining": 19,
    "limit": 20,
    "window_seconds": 60
  }
}

字段说明

字段	说明
intent_analysis.core_intent	核心意图分类：技术 / 创意 / 分析 / 咨询
intent_analysis.confidence	置信度 0-1，≥0.85 为高置信
intent_analysis.disambiguation_note	消歧判定依据
optimized_prompt	优化后的提示词，可直接复制到任意 LLM 使用
usage.api_calls	本次消耗的 API 调用次数（固定 2）

限流

每密钥每60秒最多 20 次请求。响应头中会返回限流状态：

"rate_limit": {
  "remaining": 19,
  "limit": 20,
  "window_seconds": 60
}

错误码

状态码	说明
200	成功
400	参数错误（缺少 input_text / 长度不足 / 非 JSON）
401	缺少 X-API-Key
403	无效的 API 密钥
429	触发限流
500	服务内部错误