文字紋理生成API詳情
文字紋理生成
支持的領(lǐng)域 / 任務(wù)：aigc /創(chuàng)意文字生成，可支持深度合成算法備案工作。
WordArt錦書-文字紋理生成可以對輸入的文字內(nèi)容或文字圖片進(jìn)行創(chuàng)意設(shè)計，根據(jù)提示詞內(nèi)容對文字添加材質(zhì)和紋理，實現(xiàn)立體材質(zhì)、場景融合、光影特效等效果，生成效果精美、風(fēng)格多樣的藝術(shù)字，結(jié)合背景可以直接作為文字海報使用。
輸入內(nèi)容&效果示意：
風(fēng)格說明：目前支持“自定義”和“預(yù)設(shè)風(fēng)格”兩大類，“自定義”大類提供3種風(fēng)格，用戶可基于提供的風(fēng)格通過提示詞進(jìn)行紋理效果自定義，支持輸入提示詞和字體類型 ；“預(yù)設(shè)風(fēng)格”大類提供20種風(fēng)格，此類別為預(yù)設(shè)的風(fēng)格效果，不支持用戶自定義輸入提示詞和字體類型。每一種風(fēng)格具體的示例圖如下：
“自定義”大類：
“預(yù)設(shè)風(fēng)格”大類：
瀑布流水（waterfall）
| 雪域高原（snow_plateau）
|
原始森林（forest）
| 天空遨游（sky）
|
國風(fēng)建筑（chinese_building）
| 奇幻卡通（cartoon）
|
樂高積木（lego）
| 繁花盛開（flower）
|
亞克力（acrylic）
| 大理石（marble）
|
絨線毛氈（felt）
| 復(fù)古油畫（oil_painting）
|
水彩（watercolor_painting）
| 中國畫（chinese_painting）
|
工筆畫（claborate_style_painting）
| 城市夜景（city_night）
|
湖光山色（mountain_lake）
| 秋日落葉（autumn_leaves）
|
青龍獻(xiàn)瑞（green_dragon）
| 赤龍呈祥（red_dragon）
|
應(yīng)用場景
海報文字制作：圍繞海報文字設(shè)計場景，通過簡單的提示詞描述即可實現(xiàn)創(chuàng)意字形、藝術(shù)紋理和個性字體的智能生成，批量生成豐富有趣的具有特效藝術(shù)字內(nèi)容的個性化海報。
文檔藝術(shù)字創(chuàng)作：辦公文檔藝術(shù)字創(chuàng)作設(shè)計場景，批量生成豐具有特效藝術(shù)字內(nèi)容的個性化字體嵌入到文檔中，實現(xiàn)內(nèi)容多樣性創(chuàng)作。
文字配圖創(chuàng)意營銷：電商、互動娛樂、視頻制作等泛娛樂場景，可根據(jù)場景主題風(fēng)格通過特定的提示詞描述生成智能配圖的藝術(shù)紋理和個性字體。
特色優(yōu)勢
靈活創(chuàng)意字體打造：通過簡單靈活的提示詞描述即可實現(xiàn)創(chuàng)意字形、藝術(shù)紋理和個性字體的智能打造。
文字邊緣風(fēng)格多變：文字變形可以對輸入的文字邊緣輪廓進(jìn)行風(fēng)格創(chuàng)意變形，根據(jù)提示詞內(nèi)容進(jìn)行邊緣變化。
批量穩(wěn)定特效生成：批量生成豐富有趣的特效藝術(shù)字內(nèi)容，在文字的辨識度、創(chuàng)意感、藝術(shù)性實現(xiàn)精準(zhǔn)可控。
透明文字極速生成：支持生成帶透明通道的藝術(shù)字圖片，實現(xiàn)藝術(shù)字精細(xì)化分割并作為獨立素材輸出使用。
模型概覽
模型名 | 模型簡介 |
wordart-texture | WordArt錦書-文字紋理生成可以對輸入的文字內(nèi)容或文字圖片進(jìn)行創(chuàng)意設(shè)計，根據(jù)提示詞內(nèi)容對文字添加材質(zhì)和紋理，實現(xiàn)立體材質(zhì)、場景融合、光影特效等效果，生成效果精美、風(fēng)格多樣的藝術(shù)字，結(jié)合背景可以直接作為文字海報使用。 |
輸入限制
文字紋理服務(wù)支持兩種輸入模式，圖像輸入和文本輸入，圖像輸入相關(guān)的字段為：input.image，文本輸入相關(guān)的字段為input.text，兩種輸入方式需要二選一。
圖像輸入要求：黑底白字，圖片大小小于5M，圖像格式推薦jpg/png/jpeg/bmp，寬高比不超過2:1，圖像的長邊不超過2048。
文本輸入要求：
小于6個字符，且不能為空字符串""。支持中文、阿拉伯?dāng)?shù)字、英文字母。
若提供ttf文件，需為標(biāo)準(zhǔn)的ttf文件，文件大小小于30M，input.text.ttf_url和input.text.font_name字段需要二選一。
提示詞長度小于200，且不能為""。
URL地址中不能包含中文字符。
HTTP調(diào)用接口
功能描述
本模型需要相對較長的算法調(diào)用時間，所以在接口層面采用了異步調(diào)用的方式進(jìn)行任務(wù)提交，在通過任務(wù)接口提交作業(yè)之后，系統(tǒng)會返回對應(yīng)的作業(yè)ID，隨后可以通過對應(yīng)的異步作業(yè)查詢接口獲取任務(wù)的狀態(tài)并且在作業(yè)到達(dá)最終完成態(tài)后取回對應(yīng)的作業(yè)結(jié)果。
前提條件
已開通服務(wù)并獲得API-KEY：API-KEY的獲取與配置。
接口限制：對單賬戶（含主賬號與RAM子賬號）任務(wù)下發(fā)接口限制QPS為2，并發(fā)任務(wù)數(shù)量限制為1。
作業(yè)提交接口調(diào)用
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/wordart/texture
入?yún)⒚枋?/b>
傳參方式 | 字段 | 類型 | 必選 | 描述 | 示例值 |
Header | Content-Type | String | 是 | 請求類型：application/json | application/json |
Authorization | String | 是 | API-Key，例如：Bearer d1**2a | Bearer d1**2a | |
X-DashScope-Async | String | 是 | 固定使用 enable，表明使用異步方式提交作業(yè)。 | enable | |
Body | model | String | 是 | 指明需要調(diào)用的模型，固定值 | wordart-texture |
input.image | Object | 否 | 圖片輸入的相關(guān)字段 input.image和input.text 需要二選一 | ||
input.image.image_url | String | 否 | 文字圖像的地址； 圖像要求：黑底白字，圖片大小小于5M，圖像格式推薦jpg/png/jpeg/bmp，長寬比不大于2，最大邊長小于等2048； 若選擇了input.image，此字段為必須字段 | "image_url":"https://xxxxx"
| |
input.text | Object | 否 | 文字輸入的相關(guān)字段 input.image和input.text 需要二選一 | ||
input.text.text_content | String | 否 | 用戶輸入的文字內(nèi)容，小于6個字； 若選擇了input.text，此字段為必須字段，且不能為空字符串""； 支持中文、阿拉伯?dāng)?shù)字、英文字母（字符的支持范圍由ttf文件決定） | "text": "文字創(chuàng)意" | |
input.text.ttf_url | String | 否 | 用戶傳入的ttf文件； 標(biāo)準(zhǔn)的ttf文件，文件大小小于30M； 當(dāng)使用input.text時，input.text.ttf_url和input.text.font_name 需要二選一 | "ttf_url":"https://xxxxx" | |
input.text.font_name | String | 否 | 使用預(yù)置字體的名稱； 當(dāng)使用input.text時，input.text.ttf_url和input.text.font_name 需要二選一； 默認(rèn)為"dongfangdakai" 取值類型及說明： 'dongfangdakai'：阿里媽媽東方大楷 'puhuiti_m'：阿里巴巴普惠體 'shuheiti'：阿里媽媽數(shù)黑體 'jinbuti'：釘釘進(jìn)步體 'kuheiti'：站酷酷黑體 'kuaileti'：站酷快樂體 'wenyiti'：站酷文藝體 'logoti'：站酷小薇LOGO體 'cangeryuyangti_m'：站酷倉耳漁陽體 'siyuansongti_b'：思源宋體 'siyuanheiti_m'：思源黑體 'fangzhengkaiti'：方正楷體 | "font_name": "dongfangdakai" | |
input.text.output_image_ratio | String | 否 | 文字輸入的圖片的寬高比； 默認(rèn)為"1:1"，可選的比例有："1:1", "16:9", "9:16"； | "output_image_ratio": "1:1" | |
input.prompt | String | 是 | 期望文字紋理創(chuàng)意樣式的描述提示詞，長度小于200，不能為"" | "prompt": "水果，蔬菜" | |
input.texture_style | String | 否 | 紋理風(fēng)格的類型，包括“自定義”和“預(yù)設(shè)風(fēng)格”兩大類，兩類風(fēng)格具體取值和說明如下： “自定義”大類提供3種風(fēng)格，用戶可基于提供的風(fēng)格通過提示詞進(jìn)行紋理效果自定義，支持輸入提示詞（input.prompt）和字體類型（input.text.ttf_url和input.text.font_name），取值類型如下： "material"：立體材質(zhì) "scene": 場景融合 "lighting"：光影特效 “預(yù)設(shè)風(fēng)格”大類提供20種風(fēng)格，此類別為預(yù)設(shè)的風(fēng)格效果，不支持用戶自定義輸入提示詞（input.prompt）和字體類型（input.text.ttf_url和input.text.font_name），取值類型如下： "waterfall"：瀑布流水 "snow_plateau"：雪域高原 "forest"：原始森林 "sky"：天空遨游 "chinese_building"：國風(fēng)建筑 "cartoon"：奇幻卡通 "lego"：樂高積木 "flower"：繁花盛開 "acrylic"：亞克力 "marble"：大理石 "felt"：絨線毛氈 "oil_painting"：復(fù)古油畫 "watercolor_painting"：水彩 "chinese_painting"：中國畫 "claborate_style_painting"：工筆畫 "city_night"：城市夜景 "mountain_lake"：湖光山色 "autumn_leaves"：秋日落葉 "green_dragon"：青龍獻(xiàn)瑞 "red_dragon"：赤龍呈祥 默認(rèn)為"material"； | "style_type": "material" | |
parameters.image_short_size | Integer | 否 | 生成的圖片短邊的長度，默認(rèn)為704，取值范圍為[512, 1024]， 若輸入數(shù)值非64的倍數(shù)，則最終取值為不大于該數(shù)值的能被64整除的最大數(shù)。若輸入為圖片，輸出圖片的寬高比和輸入圖片保持一致； | "image_short_size": 512 | |
parameters.n | Integer | 是 | 生成的圖片數(shù)量，默認(rèn)為 1，取值范圍為[1, 4] | "n": 1 | |
parameters.alpha_channel | Bool | 否 | 是否返回帶alpha通道的圖片； 默認(rèn)為 false； | "alpha_channel": false |
出參描述
字段 | 類型 | 描述 | 示例值 |
output.task_id | String | 本次請求的異步任務(wù)的作業(yè) id，實際作業(yè)結(jié)果需要通過異步任務(wù)查詢接口獲取。 | 13b1848b-5493-4c0e-8c44-68d038b492af |
output.task_status | String | 提交異步任務(wù)后的作業(yè)狀態(tài)。 | PENDING |
request_id | String | 本次請求的系統(tǒng)唯一碼 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
請求示例
需要使用您的API-KEY替換示例中的 your-dashscope-api-key ，代碼才能正常運行。
# 圖片輸入
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/wordart/texture' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer <YOUR_DASHSCOPE_API_KEY>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--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
}
}'
# 文字輸入
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/wordart/texture' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer <YOUR_DASHSCOPE_API_KEY>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
"model": "wordart-texture",
"input": {
"text":
{
"text_content": "文字創(chuàng)意",
"font_name": "dongfangdakai",
"output_image_ratio": "1:1"
},
"prompt": "水果，蔬菜，溫暖的色彩空間",
"texture_style": "material"
},
"parameters":
{
"image_short_size": 704,
"n": 2,
"alpha_channel": false
}
}'響應(yīng)示例
{
"output": {
"task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
"task_status": "PENDING"
}
"request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}異常響應(yīng)示例
在提交作業(yè)請求出錯的情況下，輸出的結(jié)果中會通過 code 和 message 指明出錯原因。
{
"code":"InvalidApiKey",
"message":"Invalid API-key provided.",
"request_id":"fb53c4ec-1c12-4fc4-a580-cdb7c3261fc1"
}作業(yè)任務(wù)狀態(tài)查詢和結(jié)果獲取接口
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
入?yún)⒚枋?/b>
傳參方式 | 字段 | 類型 | 必選 | 描述 | 示例值 |
Url Path | task_id | String | 是 | 需要查詢作業(yè)的 task_id | 13b1848b-5493-4c0e-8c44-68d038b492af |
Header | Authorization | String | 是 | API-Key，例如：Bearer d1**2a | Bearer d1**2a |
出參描述
字段 | 類型 | 描述 | 示例值 |
output.task_id | String | 本次請求的異步任務(wù)的作業(yè) id，實際作業(yè)結(jié)果需要通過異步任務(wù)查詢接口獲取。 | 13b1848b-5493-4c0e-8c44-68d038b492af |
output.task_status | String | 被查詢作業(yè)的作業(yè)狀態(tài) | 任務(wù)狀態(tài)： PENDING 排隊中 RUNNING 處理中 SUCCEEDED 成功 FAILED 失敗 UNKNOWN 作業(yè)不存在或狀態(tài)未知 |
output.results | Array | 如果作業(yè)成功，包含模型生成的結(jié)果 object，每個 object 中包含按照要求生成的結(jié)果地址 | [ {"url":"https://xxx/1.jpg"}, {"url":"https://xxx/2.jpg"} ] |
usage.image_count | Int | 本次請求生成圖像計量 | "image_count": 1 |
request_id | String | 本次請求的系統(tǒng)唯一碼 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
請求示例
以下示例展示通過CURL命令來調(diào)用本模型的腳本
需要使用您的API-KEY替換示例中的 your-dashscope-api-key ，代碼才能正常運行。
curl -X GET \
--header 'Authorization: Bearer <YOUR-DASHSCOPE-API-KEY>' \
https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-af6e-a0c6a421c010響應(yīng)示例（作業(yè)執(zhí)行中）
作業(yè)提交后將處于排隊狀態(tài)，在得到調(diào)度之后將轉(zhuǎn)為運行狀態(tài)，此時作業(yè)的狀態(tài)為RUNNING，task_metrics將給出具體batch狀態(tài)；
{
"request_id":"e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
"output":{
"task_id":"86ecf553-d340-4e21-af6e-a0c6a421c010",
"task_status":"RUNNING",
"task_metrics":{
"TOTAL":1,
"SUCCEEDED":1,
"FAILED":0
}
}
}響應(yīng)示例（作業(yè)成功執(zhí)行完畢）
如果作業(yè)執(zhí)行完成并成功之后，再次查詢作業(yè)狀態(tài)，接口將在告知作業(yè)狀態(tài)的同時，一并將作業(yè)的結(jié)果返回。對于本模型，作業(yè)在結(jié)束之后的狀態(tài)會持續(xù)保留24小時以備客戶隨時查詢，24小時之后，作業(yè)將從系統(tǒng)中清除，相關(guān)的結(jié)果也將一并清除；對應(yīng)的，作業(yè)生成的結(jié)果為圖像的URL地址，出于安全考慮，該URL的下載有效期也是24小時，需要用戶在獲取作業(yè)結(jié)果后根據(jù)需要及時使用或者轉(zhuǎn)存。
{
"output":{
"task_id":"a8532587-fa8c-4ef8-82be-0c46b17950d1",
"task_status":"SUCCEEDED",
"results":[
{
"url":"https://xxx/1.jpg"
},
{
"url":"https://xxx/2.jpg"
},
{
"url":"https://xxx/3.jpg"
},
{
"url":"https://xxx/4.jpg"
}
]
},
"usage":{
"image_count":4
},
"request_id":"7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}響應(yīng)示例（作業(yè)失敗）
如果因為某種原因作業(yè)失敗，則作業(yè)狀態(tài)會設(shè)置為FAILED，并且通過code和message字段指明錯誤原因。
{
"request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
"output": {
"task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
"task_status": "FAILED",
"code": "xxx",
"message": "xxxxxx",
}
}狀態(tài)碼說明
DashScope通用狀態(tài)碼請查閱：返回狀態(tài)碼說明
同時本模型還有如下特定錯誤碼：
http 返回碼* | 錯誤碼（code） | 錯誤信息（message） | 含義說明 |
400 | InvalidParameter | The request is missing required parameters or the parameters are out of the specified range, please check the parameters that you send | 缺少必要的接口調(diào)用參數(shù)或參數(shù)越界 |