通过 RunningHub 分析1-8张图片并返回一个提示词文件，支持选择视觉模型并补充返推要求。
1积分/次基础说明
通过 RunningHub 分析1-8张图片并返回一个提示词文件，支持选择视觉模型并补充返推要求。
提交任务
提交 RunningHub 图片返推提示词任务。服务会综合分析1-8张输入图片，并按所选视觉模型与要求返回一个提示词文件。
POST/api/third-party/imagePrompt/generate
请求头
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-API-Token | string | 是 | 平台提供的调用凭证，用于识别当前账号或租户。 |
| Content-Type | string | 是 | 提交任务时固定使用 application/json。 |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| images | string[] | 是 | 1-8张图片的公网 HTTP/HTTPS URL，或 RunningHub 已上传素材的 fileName。 |
| model | string | 否 | 视觉分析模型，默认 gemini-3-pro-preview。 |
| prompt | string | 否 | 返推要求或分析提示词，默认“返推提示词”，最长10000字符。 |
请求示例
bash
curl -X POST "https://yunfanzhilian.com/api/third-party/imagePrompt/generate" \
-H "X-API-Token: your_token" \
-H "Content-Type: application/json" \
-d '{
"images": [
"https://your-cdn.com/image-1.png",
"https://your-cdn.com/image-2.png"
],
"model": "gemini-3-pro-preview",
"prompt": "返推提示词"
}'响应字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | number | - | 业务状态码，200 表示请求成功。 |
| message | string | - | 本次请求的结果说明。 |
| data.taskId | string | - | 任务 ID。提交成功后请保存，用于查询生成结果。 |
| data.cost | number | - | 本次提交预扣积分。 |
| data.status | string | - | 任务初始状态，通常为 pending 或 processing。 |
| timestamp | string | - | 响应时间，ISO 8601 格式。 |
响应示例
json
{
"code": 200,
"message": "图片返推提示词任务已提交",
"data": {
"taskId": "task_xxxxxxxx",
"status": "processing",
"model": "gemini-3-pro-preview",
"imageCount": 2,
"cost": 1,
"recordId": "67f000000000000000000003"
},
"timestamp": "2026-09-03T10:00:00.000Z"
}注意事项
- 公网图片会先由服务端上传到 RunningHub；也可以直接传 RunningHub 上传接口返回的 fileName。
- 上游使用固定 AI App 2095335885654028289，图片按顺序映射到节点60、61、62、63、65、66、67、68。
- 每次任务固定预扣1积分；上游提交失败或任务失败时自动退回。
- 提交后可通过统一获取结果接口轮询，建议间隔20-30秒。