提交应用工具任务 - 触站AI开放平台API

该接口用于提交应用工具任务，所需的参数详情可通过应用工具选项详情接口获取，此接口为异步提交任务接口，并不直接返回最终的结果，请调用获取工作流任务详情接口获取进度或者结果。

使用此接口需要提交的参数需要通过获取应用工具选项获取，字段对应关系如下：

企业微信截图_b167263b-e973-450b-b9ee-e3db4c5bacb3.png

参数与选项对应关系

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

utilityToolId

integer

应用工具ID

必需

presetId

integer

预设模板id

可选

options

array [object {2}]

相关选项

必需

integer

选项ID

必需

itemId

integer

选项值ID

必需

image

string

图片

必需

图片url或base64

imageMask

string

遮罩图

可选

图片url或base64，部分功能此字段必传。请注意，调用接口的时候触站AI不负责提供此图片或者功能，您需要自行实现生成图片对应的遮罩图的功能逻辑。
蒙版图是由由黑白二色构成的图，可以理解成灰度图，一般白色区域指的是逻辑中选中的区域
蒙版图的比例（长宽比）需要与image字段一致

exclusiveMode

boolean

是否开启独占模式

可选

callback

string

结果回调地址

可选

支持IP等URL请参考回调使用指南

示例值:

https://exmple.com/callback

nonce

string

自定义请求回调标识

可选

任意长度不超过32的字符串，具体请参考回调使用指南

<= 32 字符

示例

{
  "utilityToolId": 0,
  "presetId": 0,
  "options": [
    {
      "id": 0,
      "itemId": 0
    }
  ],
  "image": "string",
  "imageMask": "string",
  "exclusiveMode": true,
  "callback": "https://exmple.com/callback",
  "nonce": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

object

必需

taskId

string

绘画任务ID

必需

可以用于工作流绘画详情接口查询进度或者获取结果
请妥善记录保管此值，如果遇到问题需要进行调试排查请提供具体任务的此字段给我们

used

integer

本次扣减积分

必需

balance

integer

账户当前余额

必需

taskLimit

integer

任务限制数

必需

并发任务数

code

integer

API统一响应码

必需

错误码请参考此文档

msg

string

错误消息

必需

如果本次接口请求错误，则会返回对应的错误描述

success

boolean

是否处理成功

必需

简易字段用于区分本次请求接口是否处理成功

示例

{
  "data": {
    "taskId": "string",
    "used": 0,
    "balance": 0,
    "taskLimit": 0
  },
  "code": 0,
  "msg": "string",
  "success": true
}