直接工具执行

POSThttps://rcn.reelway.ai/v1/creative-agent/tools/execute鉴权:凭证

同步执行托管工具,返回最终消息与可选产物

创意智能体的六个同步托管工具通过单一端点执行:不需要建立长连接,适合无状态服务端与函数计算。

请求体

字段	类型	必填	说明
`tool`	string	是	托管工具名;`tool_name` 作为别名被接受
`arguments`	各工具定义	是	所选工具的完整参数对象
`app_source`	string	否	调用方标签(≤128 字符,超长截断);亦可用 `X-App-Source` 头
`token_type` / `billing_mode`	string	否	Sogni 兼容形状字段;统一余额计费下不改变计费结果

未知字段返回 400(1010)。arguments 必须为对象;未实现或未知工具返回 422(1001)。

六个托管工具

工具	用途
`enhance_prompt`	把粗略提示词扩写为模型就绪的图像/视频/语音提示词
`compose_script`	起草脚本、分镜、预告片与短视频文案
`compose_lyrics`	撰写歌词与建议的音乐参数
`compose_instrumental`	撰写纯音乐结构与建议参数
`compose_workflow`	把创意简报编译为工作流 `input` 计划与费用预估
`compose_workflow_template`	起草或编辑带参数的工作流模板与示例计划

预览六个工具当前为占位实现(mock 语义):响应契约稳定,内容质量随真实引擎接入提升

请求示例

curl --fail-with-body https://rcn.reelway.ai/v1/creative-agent/tools/execute \
  -H "api-key: $REELWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "enhance_prompt",
    "arguments": {
      "prompt": "一只戴墨镜的柴犬",
      "target_output": "video_prompt"
    }
  }'

响应

标准信封:data 含工具输出(message 文本与结构化字段,按工具定义)。未实现工具返回 422(1001);参数缺漏返回 400。

另见

创意工作流 —— compose_workflow 输出的执行载体
工作流模板 —— compose_workflow_template 输出的持久化方式

#直接工具执行

#请求体

#六个托管工具

#请求示例

#响应

#另见

直接工具执行

请求体

六个托管工具

请求示例

响应

另见