发起AI应用任务 - runninghub-api

请求参数

Authorization

Header 参数

Host

string

必需

示例值:

www.runninghub.cn

Body 参数application/json

apiKey

string

必需

webappId

integer <int64>

必需

nodeInfoList

array[object (NodeInfo) {7}]

必需

nodeId

string

可选

nodeName

string

可选

fieldName

string

可选

fieldValue

string

可选

fieldData

string

可选

description

string

可选

descriptionEn

string

可选

webhookUrl

string

可选

示例

{
    "webappId": 1877265245566922753,
    "apiKey": "{{apiKey}}",
    "nodeInfoList": [
        {
            "nodeId": "122",
            "fieldName": "prompt",
            "fieldValue": "一个在浴室里的金发女"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://www.runninghub.cn/task/openapi/ai-app/run' \
--header 'Host: www.runninghub.cn' \
--header 'Content-Type: application/json' \
--data-raw '{
    "webappId": 1877265245566922753,
    "apiKey": "请输入自己的apiKey",
    "nodeInfoList": [
        {
            "nodeId": "122",
            "fieldName": "prompt",
            "fieldValue": "一个在浴室里的金发女"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

可选

返回标记：成功标记=0，非0失败，或者是功能码

msg

string

返回信息

可选

data

object (TaskCreateResponse)

数据

可选

netWssUrl

string

Wss服务地址

可选

taskId

integer <int64>

任务Id

可选

clientId

string

可选

客户端ID，当客户端首次接收clientId时，需要保存到本地，以便页面刷新重连或者二次运行任务传参使用

taskStatus

string

可选

任务状态: CREATE, SUCCESS, FAILED, RUNNING, QUEUED;

promptTips

string

可选

工作流验证结果提示,当不为空是UI需要展示节点错误信息

示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "netWssUrl": "wss://www.runninghub.cn:443/ws/c_instance?c_host=222.186.161.123&c_port=85&clientId=14caa1db2110a81629c101b9bb4cb0ce&workflowId=1876205853438365698&Rh-Comfy-Auth=eyJ1c2VySWQiOiJkZTBkYjZmMjU2NGM4Njk3YjA3ZGY1NWE3N2YwN2JlOSIsInNpZ25FeHBpcmUiOjE3NDQxMTI1MjEyMzYsInRzIjoxNzQzNTA3NzIxMjM2LCJzaWduIjoiZDExOTE0MzkwMjJlNjViMjQ5MjU2YzU2ZmQxYTUwZjUifQ%3D%3D",
        "taskId": "1907035719658053634",
        "clientId": "14caa1db2110a81629c101b9bb4cb0ce",
        "taskStatus": "RUNNING",
        "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"115\", \"129\", \"124\"], \"node_errors\": {}}"
    }
}