工作流运行接口 - LinkAI开放接口

请求参数

Header 参数

Authorization

string

必需

在 LinkAI平台-应用接入生成API Key并填入

示例值:

Bearer YOUR_API_KEY

Body 参数application/json

app_code

string

应用code

可选

应用或工作流的 code。若不填则表示不绑定具体应用，将请求直接传递给模型

args

object

工作流变量

必需

工作流输入变量，包括系统默认变量和自定义变量，在开始节点中定义

session_id

string

会话ID

必需

每个session_id有独立的上下文记忆存储，大模型和应用节点开启记忆后即可使用。若该字段不填则系统会自动分配一个唯一标识，在响应中返回，下次请求时可传入该值

示例

{
  "app_code": "T8kjAqQw7o",
  "args": {
    "height": "1.8",
    "weight": "75"
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.link-ai.tech/v1/workflow/run' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_code": "T8kjAqQw7o",
    "args": {
        "height": "1.8",
        "weight": "75"
    }
}'

返回响应

🟢200成功

application/json

Body

success

boolean

是否运行成功

必需

code

integer

状态码

必需

message

string

错误信息

必需

data

object

输出数据

必需

output_text

string

工作流输出文本

必需

示例

{
  "success": true,
  "code": 200,
  "message": "success",
  "data": {
    "output_text": "您好！您的BMI值是23.15，这个结果处于正常范围（18.5-23.9之间）。恭喜您，保持在这个范围内是健康的标志！\n\n为了进一步维护您的健康，建议您继续保持均衡的饮食和适量的运动。可以考虑增加一些富含纤维的食物，比如水果、蔬菜和全谷物，同时减少高糖和高脂肪食物的摄入。此外，每周至少进行150分钟的中等强度锻炼，比如快走、游泳或骑自行车，都是非常有益的。"
  }
}

🟠400参数不正确

🟠401API Key鉴权失败

🟠402应用不存在

🟠403应用无访问权限

🟠406余额不足

🟠408无API访问权限

🟠409内容审核不通过

🔴503服务异常