必须将Runway接口文档中的提示词要求转化为三栏式可执行清单,即「接口路径」「校验类型」「具体规则」,按生命周期分阶段识别、区分服务端硬校验与UI软提示、标记版本依赖,并支持CSV/YAML/Apifox三种落地形式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要把Runway接口文档里零散的提示词要求,变成可执行、可检查、可交接的步骤清单,而不是堆砌一段段文字描述。这一步直接影响开发是否漏掉关键约束、测试能否覆盖边界条件、后续维护是否能快速定位意图。
提取提示词中的结构化要素
打开Runway官方API文档(如Characters或Gen-2的REST API页),逐条扫描所有含“prompt”“input”“instruction”“guideline”字样的字段说明。重点抓取四类内容:角色设定(如“you are a medical assistant”)、任务指令(如“generate a 3-second video clip”)、格式约束(如“output JSON with keys: ‘scene’, ‘duration’, ‘style’”)、禁止项(如“do not include timestamps or speaker labels”)。
把每一条提示词要求拆成独立语义单元,例如“Use only lowercase letters in the prompt field”单独列为一项,“Maximum length is 500 characters”另列一项。不要合并——合并会导致后续无法单点校验。
【合并提示词约束会直接导致自动化校验失效】
按接口生命周期排序归类
第一步:识别该提示词作用于哪个接口阶段——是创建Character时的initial_prompt?还是调用/gen2生成视频时的text_prompt?或是编辑已有角色时的update_instruction?
第二步:判断该提示词是否参与服务端校验。例如,Runway Characters API对prompt长度做硬性截断(500字符),而Gen-2仅在前端做软提醒;前者必须进清单,后者可标注为“UI级提示,非接口强制”。
第三步:标记是否影响响应结构。比如“prompt must contain exactly one action verb”会触发400错误并返回特定error_code,这类必须进入“请求校验”子清单;而“prefer active voice”只影响生成质量,归入“建议项”即可。
第四步:确认是否绑定版本。Runway常在/v1和/v2间调整prompt解析逻辑(如v2开始支持多轮上下文注入),未注明版本的提示词一律标为“待确认”,不能写入正式清单。
生成三栏式可执行清单
方法一:用表格导出CSV,列名设为「接口路径」「校验类型」「具体规则」。例如:/api/v2/characters → 请求体校验 → “prompt字段长度≤500字符,超长则截断至第500位”;/api/v1/gen2 → 响应校验 → “返回video_url必须以https://cdn.runwayml.com/开头”。
方法二:转为YAML格式嵌入CI流程。在.github/workflows/api-test.yml中新增prompt-validation步骤,调用自定义脚本检查每个POST请求体里的prompt字段是否满足预设正则(如^[\p{L}\p{N}\s\.\,\!\?\-]{1,500}$)。
方法三:直接写进Apifox的“前置脚本”里。在请求前插入JS代码:if (request.data.prompt.length > 500) { throw new Error("Prompt exceeds 500 chars"); }。这样每次调试都自动拦截,比文档更可靠。


















