支持的领域/任务:aigc/创意文字生成,可支持深度合成算法备案工作。
WordArt锦书-文字纹理生成可以对输入的文字内容或文字图片进行创意设计,根据提示词内容对文字添加材质和纹理,实现立体材质、场景融合、光影特效等效果,生成效果精美、风格多样的艺术字,结合背景可以直接作为文字海报使用。
输入内容&效果示意:
风格说明:目前支持“自定义”和“预设风格”两大类,“自定义”大类提供3种风格,用户可基于提供的风格通过提示词进行纹理效果自定义,支持输入提示词和字体类型;“预设风格”大类提供20种风格,此类别为预设的风格效果,不支持用户自定义输入提示词和字体类型。每一种风格具体的示例图如下:
瀑布流水(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)
模型名
模型简介
wordart-texture
接口限制:对单账户(含主账号与RAM子账号)任务下发接口限制QPS为2,并发任务数量限制为1。
传参方式
字段
类型
必选
描述
示例值
Header
Content-Type
String
是
请求类型:application/json
application/json
Authorization
API-Key,例如:Bearerd1**2a
Bearerd1**2a
X-DashScope-Async
固定使用enable,表明使用异步方式提交作业。
enable
Body
model
指明需要调用的模型,固定值
input.image
Object
否
input.image和input.text需要二选一
input.image.image_url
文字图像的地址;
图像要求:黑底白字,图片大小小于5M,图像格式推荐jpg/png/jpeg/bmp,长宽比不大于2,最大边长小于等2048;
若选择了input.image,此字段为必须字段
input.text
input.text.text_content
用户输入的文字内容,小于6个字;
若选择了input.text,此字段为必须字段,且不能为空字符串"";
支持中文、阿拉伯数字、英文字母(字符的支持范围由ttf文件决定)
"text":"文字创意"
input.text.ttf_url
用户传入的ttf文件;
标准的ttf文件,文件大小小于30M;
当使用input.text时,input.text.ttf_url和input.text.font_name需要二选一
input.text.font_name
使用预置字体的名称;
当使用input.text时,input.text.ttf_url和input.text.font_name需要二选一;
默认为"dongfangdakai"
取值类型及说明:
'dongfangdakai':阿里妈妈东方大楷
'puhuiti_m':阿里巴巴普惠体
'shuheiti':阿里妈妈数黑体
'jinbuti':钉钉进步体
'kuheiti':站酷酷黑体
'kuaileti':站酷快乐体
'wenyiti':站酷文艺体
'logoti':站酷小薇LOGO体
'cangeryuyangti_m':站酷仓耳渔阳体
'siyuansongti_b':思源宋体
'siyuanheiti_m':思源黑体
'fangzhengkaiti':方正楷体
"font_name":"dongfangdakai"
input.text.output_image_ratio
文字输入的图片的宽高比;
默认为"1:1",可选的比例有:"1:1","16:9","9:16";
"output_image_ratio":"1:1"
input.prompt
期望文字纹理创意样式的描述提示词,长度小于200,不能为""
"prompt":"水果,蔬菜"
input.texture_style
纹理风格的类型,包括“自定义”和“预设风格”两大类,两类风格具体取值和说明如下:
“自定义”大类提供3种风格,用户可基于提供的风格通过提示词进行纹理效果自定义,支持输入提示词(input.prompt)和字体类型(input.text.ttf_url和input.text.font_name),取值类型如下:
"material":立体材质
"scene":场景融合
"lighting":光影特效
“预设风格”大类提供20种风格,此类别为预设的风格效果,不支持用户自定义输入提示词(input.prompt)和字体类型(input.text.ttf_url和input.text.font_name),取值类型如下:
"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";
"style_type":"material"
parameters.image_short_size
Integer
生成的图片短边的长度,默认为704,取值范围为[512,1024],若输入数值非64的倍数,则最终取值为不大于该数值的能被64整除的最大数。若输入为图片,输出图片的宽高比和输入图片保持一致;
"image_short_size":512
parameters.n
生成的图片数量,默认为1,取值范围为[1,4]
"n":1
parameters.alpha_channel
Bool
是否返回带alpha通道的图片;
默认为false;
"alpha_channel":false
output.task_id
本次请求的异步任务的作业id,实际作业结果需要通过异步任务查询接口获取。
13b1848b-5493-4c0e-8c44-68d038b492af
output.task_status
提交异步任务后的作业状态。
PENDING
request_id
本次请求的系统唯一码
7574ee8f-38a3-4b1e-9280-11c33ab46e51
以下示例展示通过CURL命令来调用本模型的脚本
需要使用您的API-KEY替换示例中的your-dashscope-api-key,代码才能正常运行。
{"code":"InvalidApiKey","message":"InvalidAPI-keyprovided.","request_id":"fb53c4ec-1c12-4fc4-a580-cdb7c3261fc1"}
UrlPath
task_id
需要查询作业的task_id
被查询作业的作业状态
任务状态:
PENDING排队中
RUNNING处理中
SUCCEEDED成功
FAILED失败
UNKNOWN作业不存在或状态未知
output.results
Array
如果作业成功,包含模型生成的结果object,每个object中包含按照要求生成的结果地址
usage.image_count
Int
本次请求生成图像计量
"image_count":1
{"request_id":"7574ee8f-38a3-4b1e-9280-11c33ab46e51""output":{"task_id":"a8532587-fa8c-4ef8-82be-0c46b17950d1","task_status":"FAILED","code":"xxx","message":"xxxxxx",}}
同时本模型还有如下特定错误码:
错误码(code)
错误信息(message)
含义说明
400
InvalidParameter
Therequestismissingrequiredparametersortheparametersareoutofthespecifiedrange,pleasechecktheparametersthatyousend