Skip to content

Seedream 3.0 ​

任务进度与结果查询见 使用说明。

说明 ​

异步任务接口,用于提交 Seedream 3.0 图片生成任务,具体生成进度与结果请通过任务查询接口获取。

请求地址 ​

http
POST /open/v1/ai_creation/task/submit
http
access_token: {{access_token}}
Content-Type: application/json

请求参数 Body ​

json
{
  "ref_prompt": "赛博朋克城市夜景,霓虹灯,雨夜,电影镜头",
  "creation_type": 3,
  "aspect_ratio": "16:9",
  "number_of_images": 1,
  "model_code": "doubao-seedream-3.0-t2i"
}

参数说明

字段类型是否必传示例说明
ref_promptstring是赛博朋克城市夜景,霓虹灯,雨夜,电影镜头图片生成提示词
creation_typeint是3创作类型,图片生成为 3
aspect_ratiostring是16:9输出图片宽高比,支持 1:1、3:4、4:3、9:16、16:9
number_of_imagesint是1本次任务生成图片数量,1-4 张
model_codestring是doubao-seedream-3.0-t2i模型编码,固定为 doubao-seedream-3.0-t2i

注意:Seedream 3.0 为文生图模型,不支持 ref_img_url 参考图输入。

响应示例 ​

json
{
  "trace_id": "96afa792520b0e6a86d72e89435bc0a7",
  "code": 0,
  "msg": "success",
  "data": "a60747d7-dc05-4afc-b2ef-ee4370ed53c6"
}

响应字段说明 ​

字段说明
code响应状态码
msg响应信息
trace_id请求链路追踪 ID
data创作任务唯一 ID(unique_id)

响应状态码说明 ​

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

示例代码 ​

shell
curl --location --request POST 'https://open-api.chanjing.cc/open/v1/ai_creation/task/submit' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ref_prompt": "赛博朋克城市夜景,霓虹灯,雨夜,电影镜头",
    "creation_type": 3,
    "aspect_ratio": "16:9",
    "number_of_images": 1,
    "model_code": "doubao-seedream-3.0-t2i"
}'
go
payload := strings.NewReader(`{
  "ref_prompt": "赛博朋克城市夜景,霓虹灯,雨夜,电影镜头",
  "creation_type": 3,
  "aspect_ratio": "16:9",
  "number_of_images": 1,
  "model_code": "doubao-seedream-3.0-t2i"
}`)
java
RequestBody body = RequestBody.create(mediaType, "{\n  \"ref_prompt\": \"赛博朋克城市夜景,霓虹灯,雨夜,电影镜头\",\n  \"creation_type\": 3,\n  \"aspect_ratio\": \"16:9\",\n  \"number_of_images\": 1,\n  \"model_code\": \"doubao-seedream-3.0-t2i\"\n}");
py
payload = json.dumps({
  "ref_prompt": "赛博朋克城市夜景,霓虹灯,雨夜,电影镜头",
  "creation_type": 3,
  "aspect_ratio": "16:9",
  "number_of_images": 1,
  "model_code": "doubao-seedream-3.0-t2i"
})