Skip to content

获取AI创作任务详情

说明

根据创作任务唯一 ID 查询单条 AI 创作任务详情。

请求地址

http
GET /open/v1/ai_creation/task?unique_id={{unique_id}}
http
access_token: {{access_token}}

请求参数 Query

http
unique_id=897712b3-1488-4152-8dbc-24dd00a3cb83

参数说明

字段类型是否必传示例说明
unique_idstring897712b3-1488-4152-8dbc-24dd00a3cb83创作任务唯一 ID

响应示例

json
{
  "trace_id": "72f6b7c46be8a9c4c63a990810a945c3",
  "code": 0,
  "msg": "success",
  "data": {
    "id": 30,
    "unique_id": "897712b3-1488-4152-8dbc-24dd00a3cb83",
    "create_time": 1772681145,
    "number_ai_creation": 1,
    "type": 3,
    "progress_desc": "Error",
    "err_msg": "[ErrMsg:出错啦,本次生成不消耗蝉豆] [ErrDetail:Ai创作任务执行失败,taskId: 817357214161993728]",
    "aspect_ratio": "9:16",
    "output_url": [],
    "photo_info": {
      "ref_img_url": [
        "https://www.chanjing.cc/chanjing/res/aigc_creation/photo/3696aigc_creation_photo_1772504509_376055fd1357461fa16b3b761462a206.png",
        "https://www.chanjing.cc/chanjing/res/aigc_creation/photo/3696aigc_creation_photo_1772681102_3965055a01e04936bf441c862c7b4598.png"
      ],
      "ref_prompt": "生成一个小孩在拜年",
      "clarity": 1024,
      "aspect_ratio": "9:16",
      "quality_mode": "",
      "number_of_images": 1
    },
    "motion_info": {
      "photo_path_url": null,
      "ref_prompt": "",
      "clarity": 0,
      "quality_mode": "",
      "style": "",
      "aspect_ratio": "",
      "video_duration": 0
    },
    "ref_img_url": [
      "https://www.chanjing.cc/chanjing/res/aigc_creation/photo/3696aigc_creation_photo_1772504509_376055fd1357461fa16b3b761462a206.png",
      "https://www.chanjing.cc/chanjing/res/aigc_creation/photo/3696aigc_creation_photo_1772681102_3965055a01e04936bf441c862c7b4598.png"
    ],
    "model_code": "kling-v2",
    "model_name": "Kling 2.0"
  }
}

响应字段说明

返回参数与“获取AI创作任务列表”中的 data.list[] 字段一致,此接口返回单条对象 data

一级字段二级字段三级字段四级字段说明
code响应状态码
msg响应信息
trace_id请求链路追踪 ID
data响应数据(单条任务)
id任务自增 ID
unique_id创作任务唯一 ID
create_time任务创建10位时间戳
number_ai_creation本次生成数量
type创作类型(3 图片,4 视频)
progress_desc任务状态描述(如Queued:排队中,Ready:入队等待,Generating:生成中,Success:成功,Error:失败)
err_msg失败原因
aspect_ratio输出比例
output_url生成结果地址列表
photo_info图片创作参数信息
ref_img_url图片创作参考图 URL 列表
ref_prompt图片创作提示词
clarity图片清晰度
aspect_ratio图片比例,1:13:44:39:1616:9
quality_mode质量模式,std:极速版;pro:专业版
number_of_images图片生成数量
motion_info视频创作参数信息
photo_path_url视频参考图/路径地址
ref_prompt视频创作提示词
clarity视频清晰度 7681080102420484096
quality_mode视频质量模式,std:标准;pro:高品质
style视频风格
aspect_ratio视频比例,1:13:44:39:1616:9
video_duration视频时长(秒)
ref_img_url顶层参考图 URL 列表
model_code模型编码
model_name模型名称

响应状态码说明

code说明
0响应成功
400传入参数格式错误
10400AccessToken 验证失败
40000参数错误
40001超出 QPS 限制
50000系统内部错误

示例代码

shell
curl --location --request GET 'https://www.chanjing.cc/open/v1/ai_creation/task?unique_id=897712b3-1488-4152-8dbc-24dd00a3cb83' \
--header 'access_token: {{access_token}}'
go
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://www.chanjing.cc/open/v1/ai_creation/task?unique_id=897712b3-1488-4152-8dbc-24dd00a3cb83"
	method := "GET"

	client := &http.Client{}
	req, err := http.NewRequest(method, url, nil)
	if err != nil {
		fmt.Println(err)
		return
	}
	req.Header.Add("access_token", "{{access_token}}")

	res, err := client.Do(req)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(string(body))
}
java
OkHttpClient client = new OkHttpClient().newBuilder().build();
Request request = new Request.Builder()
  .url("https://www.chanjing.cc/open/v1/ai_creation/task?unique_id=897712b3-1488-4152-8dbc-24dd00a3cb83")
  .method("GET", null)
  .addHeader("access_token", "{{access_token}}")
  .build();
Response response = client.newCall(request).execute();
py
import requests

url = "https://www.chanjing.cc/open/v1/ai_creation/task?unique_id=897712b3-1488-4152-8dbc-24dd00a3cb83"
headers = {
  'access_token': '{{access_token}}'
}

response = requests.request("GET", url, headers=headers)
print(response.text)