创建艺术二维码
接入点说明
我们的服务允许用户输入任何URL地址，并基于此信息生成具有独特艺术效果的二维码图片。您只需提供您希望转换的网址，我们的系统将自动处理，利用先进的算法和设计元素，为您创造一个既实用又美观的二维码。这些艺术化的二维码不仅能够满足基本的链接分享需求，还能作为视觉艺术品增添吸引力，适合用于营销材料、社交媒体分享、个人名片或任何需要结合技术实用性与创意设计的场合。
返回格式JSON
请求方式POST/GET
请求参数
Header 参数
| 参数名称 | 类型 | 示例值 | 必须 | 描述 |
|---|---|---|---|---|
| content-type | String | application/x-www-form-urlencoded | 否 |
Post 表单
| 参数名称 | 类型 | 示例值 | 必须 | 描述 |
|---|---|---|---|---|
| text | String | https://www.showapi.com/ | 否 | 要生成二维码的文本信息，此处填写URL地址对应的字符串，建议此字符串不要超过25个字符。text和qr_code_url两个参数二选一，当两者都传入的时候，以text参数为准。 |
| qr_code_url | String | - | 否 | 要艺术化的二维码图片地址，建议不要超过45个字符，二维码中字符数量越多，生成的二维码识别率越低。text和qr_code_url两个参数二选一，当两者都传入的时候，以text参数为准。 |
| style_id | String | shop_flower | 否 | 创作使用的艺术风格id，支持的style_id请参考接口文档。 |
| call_back | String | - | 否 | 任务的http回调地址，任务完成时会通过这个地址推送结果，回调方式POST，payload格式为JSON，例{"resList":[...],"task_id":"对应的任务id"} |
| batch_size | Number | 1 | 否 | 每个任务创作的二维码数量，支持1~4，默认为1，数字越大，调用时扣费越贵，任务花费时间也就越久 |
| your_prompt | String | - | 否 | 自定义提示词，支持中英文。为确保语义表达的准确性，请尽量使用英文。如使用中文，我们会翻译成英文后再生成二维码。注意：使用自定义提示词时，我们将尽可能的生成符合要求的二维码，但不保证二维码能被正常识别 |
| use_short_link | Number | 1 | 否 | 1表示使用短链接，0表示不使用短链接。超长URL地址若使用短链接，会极大提高生成后的二维码的识别率。此处生成的短链接只有24小时的有效期，仅为了方便查阅二维码的样式。如要长期使用该艺术二维码，请使用第三方的短链接服务生成相应短链接，然后再使用短链接生成艺术二维码（注意：短链接的有效期由您使用的第三方短链接服务决定）。 |
| composition_ratio | String | - | 否 | 画面构图比例（宽:高）可选值： '1:1',
'3:4',
'4:3',
'16:9',
'9:16' |
| qr_code_base64 | String | - | 否 | 二维码图片的base64字符串 |
| position | String | - | 否 | 二维码在图中的位置，可选值
'left',
'right',
'top',
'bottom',
'center' |
| qr_format | String | - | 否 | 二维码码形式，可选值： square square_re square_ex column column_re column_ex row row_re row_ex round round_re round_ex block block_re block_ex arc arc_re arc_ex |
返回参数
该接口返回经
showapi_res_body 系统封装，业务数据均位于该对象内；系统级字段见。返回头部
返回体
返回示例
JSON
