发起作画任务

请求参数

Body 参数application/json

template_id

integer <int32>

必需

模板id,模板列表接口获取

示例值:

460

num

integer <int32>

必需

生成数量，默认4张，上限8张。

示例值:

1

init_image

string <string>

必需

用户输入人脸图
建议分辨率在1k左右，图片过大会导致生成失败，过小会导致人脸元素采集不足，相似度降低

示例值:

https://cdn.wujiebantu.com/ai/C837D53F842A48AEDFA7DA2976D834FE-01.png

init_image_check_key

string <string>

必需

init_image_check返回的check_key,必须要先调用检测接口检查图片

示例值:

C5B5FE8DBF3679D9049342C130341BD9

notify_url

string <string>

可选

回调URL，http post请求进行重试
回调重试规则：

1.

支持5级重试时间: 5, 10, 30, 60, 120 (单位：秒)，也就是分别会在5s、10s、30s...时进行回调重试

2.

当回调通知方的接口Response body种返回"success"时，我们会认为您已经成功处理回调，并终止重试

3.

魔镜作画在提交多个时任务也是一个一个处理，回调是一个一个回调，不会总体完成回调

示例值:

https://gate.wujieai.com/ai/callback

width

integer <int32>

可选

作画图片宽度目前只支持800 * 1200 分辨率

示例值:

800

height

integer <int32>

作画图片高度

可选

示例值:

1200

示例

{
  "template_id": 460,
  "num": 1,
  "init_image": "https://cdn.wujiebantu.com/ai/C837D53F842A48AEDFA7DA2976D834FE-01.png",
  "init_image_check_key": "C5B5FE8DBF3679D9049342C130341BD9",
  "notify_url": "https://gate.wujieai.com/ai/callback",
  "width": 800,
  "height": 1200
}

示例代码

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/mirror/create' \
--header 'Content-Type: application/json' \
--data-raw '{
  "template_id": 460,
  "num": 1,
  "init_image": "https://cdn.wujiebantu.com/ai/C837D53F842A48AEDFA7DA2976D834FE-01.png",
  "init_image_check_key": "C5B5FE8DBF3679D9049342C130341BD9",
  "notify_url": "https://gate.wujieai.com/ai/callback",
  "width": 800,
  "height": 1200
}'

返回响应

🟢200OK

application/json

Body

code

string <string>

响应code

可选

示例值:

200

message

string <string>

失败信息

可选

示例值:

success

data

object (AiTaskKeysVo_response)

可选

返回数据(object)

keys

array[string]

作画结果Key列表

可选

示例值:

C5B5FE8DBF3679D9049342C130341BD9

results

array[object (AiTaskCreateResultVo_response) {3}]

可选

作画结果result列表

示例

{
  "code": "200",
  "message": "success",
  "data": {
    "keys": "C5B5FE8DBF3679D9049342C130341BD9",
    "results": [
      {
        "key": "C5B5FE8DBF3679D9049342C130341BD9",
        "expected_generate_second": 12,
        "expected_queue_second": 12
      }
    ]
  }
}