本文介绍创意海报生成模型的输入输出参数。根据要求自动生成海报的背景和文字排版，支持多种海报风格。无需设计基础，轻松制作出彩作品，让创意触手可及。
相关指南：创意海报生成
模型概览
模型名 | 模型简介 | 免费额度 | 计费单价 | 限流（含主账号与RAM子账号） | |
任务下发接口QPS限制 | 同时处理中任务数量 | ||||
wanx-poster-generation-v1 | 创意海报生成，您的创意海报魔法工厂！它能够根据你的要求自动生成海报的背景和文字排版，支持多种海报风格，从宣传到祝福，让每一张海报都成为你的个性宣言。无需设计基础，轻松制作出彩作品，让创意触手可及。 | 免费额度：500张 领取方式：开通阿里云百炼大模型服务后，自动发放 有效期：180天 | 限时免费 | 2 | 1 |
前提条件
您需要已获取API Key并配置API Key到环境变量。
HTTP调用
为了减少等待时间并且避免请求超时，服务采用异步方式提供。您需要发起两个请求：
创建任务：首先发送一个请求创建文生图任务，该请求会返回任务ID。
根据任务ID查询结果：使用上一步获得的任务ID，查询模型生成的结果。
创建任务
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis
请求头（Headers） | 春节快乐海报 |
Authorization string 必选 推荐您使用百炼API-Key，也可填DashScope API-Key。例如：Bearer d1xxx2a。 | |
X-DashScope-Async string 必选 是否使用DashScope异步调用。HTTP只支持异步调用，设置为 | |
Content-Type string 必选 请求内容类型。固定为 | |
请求体（Request Body） | |
model string 必选 调用模型。创意海报生成模型为 | |
parameters object 必选 其他模型调用参数，只需要输入一个空对象即可。示例： | |
input object 必选 输入图像的基本信息，比如图像URL地址。 generate_mode string 必选 海报生成模式。
generate_num Int 可选 生成的海报数。该参数只在 取值范围：[1,4]，默认为1。如果设置的值大于4，则默认生成4张图。 auxiliary_parameters string 可选 当generate_mode为"sr"或"hrf"时为必选项。需要提升分辨率或者高清修复的海报图片对应的辅助参数，数量限制为1。 title string 必选 主标题。最多30个字符。例如，"春节快乐"。 sub_title string 可选 副标题。最多30个字符。例如，“家庭团聚，共享天伦之乐"。 body_text string 可选 正文。最多50个字符。例如："春节是中国最重要的传统节日之一，它象征着新的开始和希望" prompt_text_zh string 可选 中文提示词。例如，“小朋友画的可爱的龙，白色背景" 中文和英文提示词至少二选一设置，支持两个参数同时设置。两个字段字符数加起来最多50个字/单词。 prompt_text_en string 可选 的英文提示词。例如："Children draw a lovely dragon, white background"。 中文和英文提示词至少二选一设置，支持两个参数同时设置。两个字段字符数加起来最多50个字/单词。 wh_ratios string 可选 生成海报的版式。
lora_name string 可选 海报风格名称。默认值为""。
lora_weight float 可选 海报风格权重，需要与lora_name参数配合使用。 取值范围：[0, 1]，默认值为0.8。取值越接近1，海报风格越明显。 ctrl_ratio float 可选 留白效果权重，用于控制海报留白效果。 取值范围：[0, 1]，默认值为0.7。取值越接近1，留白效果越好，但海报背景生成效果可能会受到负面影响。 ctrl_step float 可选 留白步数比例，用于控制海报留白效果。 取值范围：(0, 1]，默认值为0.7。取值越接近1，留白效果越好，但是海报背景生成效果可能会受到负面影响。 creative_title_layout bool 可选 标题是否启用创意排版。默认值为false。 | |
响应 | 成功响应异常响应 |
output object 任务输出信息。 | |
code string 接口错误码。接口成功请求不会返回该参数。 | |
message string 接口错误信息。接口成功请求不会返回该参数。 | |
request_id string 请求唯一标识。可用于请求明细溯源和问题排查。 |
根据任务ID查询结果
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
请求头（Headers） | 获取任务结果 |
Authorization string 必选 推荐使用百炼API-Key，也可填DashScope API-Key。例如：Bearer d1xxx2a。 | |
URL路径参数（Path parameters） | |
task_id string 必选 任务id。 |
响应 | 任务执行成功任务执行中任务执行失败 |
output object 任务输出信息。 | |
usage object 输出信息统计。 | |
request_id string 请求唯一标识。可用于请求明细溯源和问题排查。 |
错误码
如果模型调用失败并返回报错信息，请参见错误码进行解决。
同时本模型还有如下特定错误码：
HTTP状态码 | 接口错误码（code） | 接口错误信息（message） | 含义说明 |
400 | InvalidParameter | check input data style | 输入参数不满足入参要求 |
500 | InternalError | inference error | 算法内部错误 |
常见问题
创意海报生成API是否支持对已经生成的海报进行二次编辑？
不支持对已生成海报的内容（如标题、正文、风格等）进行二次编辑。仅能通过再次调用本API来提升已生成海报的分辨率。如需调整海报的内容，请重新设计并生成新的海报。
提升已生成海报分辨率的方法为：将上次生成海报时的输入参数"generate_mode"的值修改为sr或hrf，并在输入参数中新增"auxiliary_parameters"，其值为上次生成海报时返回的完整参数集，其它参数保持不变。
curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data-raw '{
"model":"wanx-poster-generation-v1",
"input": {
"title":"春节快乐",
"sub_title":"家庭团聚，共享天伦之乐",
"body_text":"春节是中国最重要的传统节日之一，它象征着新的开始和希望",
"prompt_text_zh":"灯笼，小猫，梅花",
"wh_ratios":"竖版",
"lora_name":"童话油画",
"lora_weight":0.8,
"ctrl_ratio":0.7,
"ctrl_step":0.7,
"generate_mode":"hrf",
"auxiliary_parameters": "WMq4SC4......"
"generate_num":1
},
"parameters":{}
}'