获取AI创作任务详情
说明
根据创作任务唯一 ID 查询单条 AI 创作任务详情。
请求地址
http
GET /open/v1/ai_creation/task?unique_id={{unique_id}}Header
http
access_token: {{access_token}}请求参数 Query
http
unique_id=897712b3-1488-4152-8dbc-24dd00a3cb83参数说明
| 字段 | 类型 | 是否必传 | 示例 | 说明 |
|---|---|---|---|---|
| unique_id | string | 是 | 897712b3-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:1、3:4、4:3、9:16、16:9 | |||
| quality_mode | 质量模式,std:极速版;pro:专业版 | |||
| number_of_images | 图片生成数量 | |||
| motion_info | 视频创作参数信息 | |||
| photo_path_url | 视频参考图/路径地址 | |||
| ref_prompt | 视频创作提示词 | |||
| clarity | 视频清晰度 768、1080、1024、2048、4096 | |||
| quality_mode | 视频质量模式,std:标准;pro:高品质 | |||
| style | 视频风格 | |||
| aspect_ratio | 视频比例,1:1、3:4、4:3、9:16、16:9 | |||
| video_duration | 视频时长(秒) | |||
| ref_img_url | 顶层参考图 URL 列表 | |||
| model_code | 模型编码 | |||
| model_name | 模型名称 |
响应状态码说明
| code | 说明 |
|---|---|
| 0 | 响应成功 |
| 400 | 传入参数格式错误 |
| 10400 | AccessToken 验证失败 |
| 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)