异步任务提交接口

请求参数

Body 参数application/json

task_code

integer <int32>

必需

任务code，不同code对应不同的队列及不同的算力集群。需要联系无界获取

示例值:

524

param

string <string>

必需

任务的请求参数，该参数会整个转发到进程服务中

示例值:

{prompt:夜幕下的赛博朋克城市,width:512,height:512,supersize_multiple:1.0,prefine_multiple:1.0}

num

integer <int32>

必需

以该参数执行的任务数量

示例值:

2

queue_priority

integer <int32>

可选

队列优先级，值越大优先级越高
为空或为0时，只是简单的按照时间先后顺序排队

示例值:

1

callback_url

string <string>

可选

任务完成的回调地址，一律 post json

示例值:

https://www.wujieai.net/v1/task/callback

request_address

string <string>

可选

服务中的请求方法名。请求方式均为post

示例值:

/create

task_timeout_seconds

integer <int32>

可选

任务超时时间。默认60

示例值:

10

expected_generate_seconds

integer <int32>

可选

提交的任务的单个预估时间

示例值:

8

limit_expected_seconds

integer <int32>

可选

当排队时间加预估生成时间超过这个值时，接口抛异常

示例值:

180

retry_times

integer <int32>

可选

异常时重试次数，限在回调异常或生成超时时，调接口时直接失败不受该值影响

示例值:

304

schedule_param

object (ScheduleParam_request)

可选

一些跟调度及对应算力集群相关的参数(object)

schedule_tag

string <string>

可选

算力调度时的标记。会有该标记的对应集群的显卡，优先被有该标记的显卡处理。
会不会被公共集群处理受busyHourTransfer影响。

示例值:

tp0or9

channel_key

string <string>

通道限制key

可选

示例值:

ssh745

schedule_tag_busy_hour_transfer

boolean

可选

算力调度标记的忙时转移。此值在scheduleTag不为空时有意义。
为true时，会检查scheduleTag的集群如果全忙，则会去判断公共集群是否空闲，如公共集群空闲则提交到公共集群，否则依然提交到scheduleTag的集群。
如果scheduleTag对应集群是无卡状态，那也被定为忙

示例值:

true

channel_limit_count

integer <int32>

并发通道上限数量

可选

示例值:

15

exceeding_channel_limit_throw_ex

boolean

可选

当超出并发通道数量时，是否抛出异常

示例值:

true

示例

{"task_code":524,"param":"{"prompt":"夜幕下的赛博朋克城市","width":512,"height":512,"supersize_multiple":1.0,"prefine_multiple":1.0}","num":2,"callback_url":"https://www.wujieai.net/v1/task/callback","request_address":"/create","task_timeout_seconds":10,"expected_generate_seconds":8,"limit_expected_seconds":180,"retry_times":732,"schedule_param":{"schedule_tag":"nr8g1r","schedule_tag_busy_hour_transfer":true}}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://gate.wujieai.net/wj-open/v1/task/task_create' \
--header 'Content-Type: application/json' \
--data-raw '{"task_code":524,"param":"{"prompt":"夜幕下的赛博朋克城市","width":512,"height":512,"supersize_multiple":1.0,"prefine_multiple":1.0}","num":2,"callback_url":"https://www.wujieai.net/v1/task/callback","request_address":"/create","task_timeout_seconds":10,"expected_generate_seconds":8,"limit_expected_seconds":180,"retry_times":732,"schedule_param":{"schedule_tag":"nr8g1r","schedule_tag_busy_hour_transfer":true}}'

返回响应

🟢200OK

application/json

Body

code

string <string>

响应code

可选

示例值:

200

message

string <string>

失败信息

可选

示例值:

success

data

object (TaskCreateResult_response)

可选

返回数据(object)

task_code

integer <int32>

资源code

可选

示例值:

523

create_result

array[object (TaskCreateResultInfo_response) {5}]

创建结果信息

可选

示例

{
  "code": "200",
  "message": "success",
  "data": {
    "task_code": 523,
    "create_result": [
      {
        "task_key": "EBAAF2922001F400272E850994237B66",
        "expected_queue_seconds": 12,
        "expected_generate_seconds": 10,
        "schedule_result": {
          "add_to_schedule_tag_pool": true
        }
      }
    ]
  }
}