提示词优化 POST /v1/prompts/optimize

调用 LLM 把用户原始 prompt 改写为更适合上游生成的版本。常用于视频生成提交前的预处理（minimax-h3 已注册专用 skill）。

端点

POST https://api.imodel.space/v1/prompts/optimize
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

请求参数

字段	位置	类型	必传	默认	说明
model	body	string	✅	—	优化目标模型代号（当前支持 minimax/h3）
prompt	body	string	✅	—	待优化提示词
stream	body	boolean	❌	false	是否 SSE 流式输出（2026-09-14 新增）

响应（非流式）

{
  "model": "minimax/h3",
  "mode": "minimax-h3",
  "optimized_prompt": "改写后的提示词",
  "reason": "改写理由",
  "skill_name": "minimax-h3-prompt",
  "latency_ms": 1234
}

mode="none" 时 optimized_prompt 等于原 prompt（无适配 skill 或上游 fail-open），前端可直接拿原 prompt 提交。

流式响应（stream=true）

Content-Type: text/event-stream

event:chunk   data:{"delta":"...","cumulative":"..."}
event:chunk   data:{"delta":"...","cumulative":"..."}
event:done    data:{"model":"...","mode":"...","optimized_prompt":"...","reason":"...","skill_name":"...","latency_ms":N}
event:error   data:{"message":"..."}

错误码

通用 4xx/5xx 见 错误码总表。LLM 调用 8s 超时走 fail-open（mode="none"），不阻塞主任务提交。

文档更新记录

日期	更新内容
2026-09-17	新增提示词优化文档。从视频生成独立出来的预处理接口，含 SSE 流式