创意文字纹理 — 创建任务

POST

/services/aigc/wordart/texture

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/wordart/texture' \
--header 'X-DashScope-Async: enable' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
  "model": "wordart-texture",
  "input": {
    "image": {
      "image_url": "https://dmshared-new.oss-cn-hangzhou.aliyuncs.com/junyan.hjy/wordart/lcy/example.png"
    },
    "prompt": "水果，蔬菜，温暖的色彩空间",
    "texture_style": "material"
  },
  "parameters": {
    "image_short_size": 704,
    "n": 2,
    "alpha_channel": false
  }
}'

{
  "request_id": "<string>",
  "output": {
    "task_id": "<string>",
    "task_status": "PENDING"
  }
}

请先获取 API Key 并设置为环境变量。

模型信息

模型	描述
`wordart-texture`	创意文字纹理生成模型

输入模式

支持两种互斥的输入模式：

模式	说明
`image`	图片输入模式，传入黑底白字的文字图片
`text`	文字输入模式，直接传入文字内容（最多 6 个字符）

纹理风格

通过 texture_style 参数指定纹理风格，或通过 ref_image_url 传入参考风格图片（将覆盖 texture_style 设置）。 自定义风格：material（立体材质）、scene（场景融合）、lighting（光影特效） 预设风格：waterfall、snow_plateau、forest、sky、chinese_building、cartoon、lego、flower、acrylic、marble、felt、oil_painting、watercolor_painting、chinese_painting、claborate_style_painting、city_night、mountain_lake、autumn_leaves、green_dragon、red_dragon

注意事项

QPS 限制：单账户（含主账号与 RAM 子账号）任务下发接口限制 QPS 为 2，并发任务数量限制为 1。

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

enum<string>

必填

启用异步模式。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称。

可选值：wordart-texture

object

必填

输入参数。

显示子属性

string

必填

纹理描述文本，最多 200 个字符，不能为空字符串。

取值范围：length <= 200

object

图片输入模式，与 text 互斥。传入黑底白字的文字图片。

显示子属性

string

必填

文字图片 URL。要求：黑底白字、小于 5M、支持 jpg/png/jpeg/bmp、宽高比不超过 2:1、长边不超过 2048 像素。

object

文字输入模式，与 image 互斥。直接传入文字内容。

显示子属性

string

必填

文字内容，最多 6 个字符，支持中文、阿拉伯数字和英文。

取值范围：length <= 6

string

自定义字体文件 URL（TTF 格式，小于 30M），与 font_name 互斥。

enum<string>

默认值"dongfangdakai"

预设字体名称，与 ttf_url 互斥。默认为 dongfangdakai。

可选值：dongfangdakai,puhuiti_m,shuheiti,jinbuti,kuheiti,kuaileti,wenyiti,logoti,cangeryuyangti_m,siyuansongti_b,siyuanheiti_m,fangzhengkaiti

enum<string>

默认值"1:1"

输出图片宽高比，默认 1:1。

可选值：1:1,16:9,9:16

enum<string>

默认值"material"

纹理风格。自定义风格：material（立体材质）、scene（场景融合）、lighting（光影特效）。预设风格：waterfall、snow_plateau、forest、sky、chinese_building、cartoon、lego、flower、acrylic、marble、felt、oil_painting、watercolor_painting、chinese_painting、claborate_style_painting、city_night、mountain_lake、autumn_leaves、green_dragon、red_dragon。

可选值：material,scene,lighting,waterfall,snow_plateau,forest,sky,chinese_building,cartoon,lego,flower,acrylic,marble,felt,oil_painting,watercolor_painting,chinese_painting,claborate_style_painting,city_night,mountain_lake,autumn_leaves,green_dragon,red_dragon

string

参考风格图片 URL。传入后将覆盖 texture_style 设置。

object

必填

模型参数。

显示子属性

integer

默认值704

生成图片短边长度，取值范围 [512, 1024]，必须为 64 的倍数，默认 704。

取值范围：512 <= x <= 1024

integer

默认值1

生成图片数量，取值范围 1~4，默认 1。

取值范围：1 <= x <= 4

boolean

默认值false

是否生成透明背景图片，默认 false。

响应

200-application/json

string

请求唯一标识。

object

显示子属性

string

任务 ID，用于查询任务状态和结果。

enum<string>

任务状态。

可选值：PENDING

​模型信息

​输入模式

​纹理风格

​注意事项

鉴权

Header 参数

请求体

响应

模型信息

输入模式

纹理风格

注意事项