AI文生图-turbo

接口标识: texttoimageaiturbo 价格: 0.001 元/次 VIP免费异步响应

接口介绍
接口文档
在线测试

接口简介

AI文生图-turbo 接口用一句话描述即可出图，数秒返回一张，主打快与省。分辨率从 512×512 到 2048×2048 自由指定，1:1、16:9、9:16 等常用比例都有推荐值；画面内能直接渲染中英文标题与短语，人像与产品图质感突出；提示词智能改写可把粗略描述补成完整画面，固定随机种子能复现同一张图。适合海报封面、电商主图与文章配图。【调用约定】本接口为任务类：返回的 task_id 需调用 taskresult 查询终态结果（output_status 为 finish 或 fail）；status 为 not 或 processing 时请每隔5-10秒重复查询直至终态。

详细介绍

![AI文生图-turbo接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_texttoimageaiturbo__1794169418_d060d0b12619.png)

想要更快地把一句话变成一张图？turbo 版文生图面向追求出图速度与灵活分辨率的创作场景，输入文字描述即可生成成品图，并支持中英文字渲染。

## 接口概述

AI文生图-turbo 接口基于阿里云百炼 Z-Image-Turbo 轻量模型：传入一段文本提示词，描述想要生成的画面内容、风格与构图，即可快速生成图像，支持随机种子、分辨率、提示词智能改写等参数控制。接口为任务类模式：提交后立即返回任务ID，生成在后台完成，调用方通过 taskresult 任务查询接口获取生成图片的下载地址，链接有效期 24 小时。每次任务生成 1 张图片。

## 核心能力

1. **快速文生图**：Z-Image-Turbo 为轻量模型，出图速度快，适合批量与实时性要求较高的场景。
2. **中英文字渲染**：支持在图像中渲染中英文文字，适合海报、标题图等带文字的画面。
3. **灵活分辨率**：size 支持宽*高自定义，总像素范围 512*512 至 2048*2048，不传时默认 1024*1536。
4. **可复现生成**：设置随机种子 seed（取值 0~2147483647），同提示词下生成结果相对稳定。
5. **提示词智能改写**：prompt_extend 默认关闭，开启后自动优化提示词并输出思考过程（价格更高）。
6. **幂等提交**：serialnumber 同接口下不可重复，重复提交直接返回已有任务，不会重复创建。

## 产品优势

- **速度快**：轻量模型链路，出图迅速，缩短等待。
- **不阻塞**：提交即返回任务ID，生成在后台完成，调用方不被长连接拖住。

## 效果展示

一句话理解：它就像一位反应敏捷的插画师——你说清画面要素，很快交回可直接使用的成品图。

以一次典型调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| text | 清晨的山间茶园，薄雾缭绕，阳光穿过云层洒在梯田上，写实摄影风格 | 正向提示词，描述期望生成的图像内容、风格与构图 |
| size | 1280*720 | 输出分辨率，宽*高，不传默认 1024*1536 |
| seed | 2026 | 随机数种子，取值 0~2147483647，未传时随机 |
| serialnumber | order-20260101-008 | 可选，自定义编号，同接口下不可重复，用于幂等与关联查询 |

你会拿到的结果（凭 task_id 经 taskresult 查询，output_status=finish 时的结果）：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 任务状态 | finish | `output_status`（not/processing/finish/fail） |
| 生成图片地址 | https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png | `output_dourl`，上游临时链接，有效期 24 小时 |
| 输出分辨率 | 1280*720 | `output_info.size` |
| 生成图片数量 | 1 | `output_info.image_count` |
| 任务说明 | AI文生图Turbo完成，分辨率 1280*720…… | `output_msg` |
| 任务耗时 | 6 | `output_time`（秒） |

API请求示例：

```
POST /api/v1/texttoimageaiturbo
text=清晨的山间茶园，薄雾缭绕，阳光穿过云层洒在梯田上，写实摄影风格&size=1280*720&seed=2026&serialnumber=order-20260101-008
```

提交后返回 task_id，凭它调用任务查询接口轮询，output_status=finish 即完成：

```
POST /api/v1/taskresult
task_id=ac3fq2m7xwzr5yn1t8k9
```

API响应示例（taskresult 查回的最终结果）：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "task_id": "ac3fq2m7xwzr5yn1t8k9",
    "serialnumber": "order-20260101-008",
    "jk_mark": "texttoimageaiturbo",
    "output_status": "finish",
    "output_content": "",
    "output_dourl": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png",
    "output_info": {
      "size": "1280*720",
      "image_count": 1
    },
    "output_msg": "AI文生图Turbo完成，分辨率 1280*720。下载 URL（output_dourl）为模型生成图像的 URL。链接有效期为 24 小时，请及时下载。",
    "output_time": 6
  }
}
```

解读：finish 时 output_dourl 即生成图片地址（上游临时链接，24 小时内有效，请及时下载或转存到自己的存储），output_info 回传分辨率与张数便于核对；fail 时 output_msg 给出失败原因。

## 应用场景

- **快速素材出图**：需要即时预览或多版快速试稿的创意场景。
- **带文字海报**：利用中英文字渲染能力生成标题图、活动海报。
- **电商视觉素材**：专题页、详情页氛围图批量快速生成。
- **内容配图**：文章头图、社媒配图按关键词快速产出。

## 应用案例

- **内容团队**：按栏目关键词批量提交任务快速出配图，serialnumber 与栏目编号对应，产出可追溯。
- **电商视觉团队**：大促专题需要数十张不重样的氛围图，turbo 版出图快，批量提交后短时间内即可拿到全部结果。
- **独立创作者**：付费专栏的每篇头图按摘要快速生成，出图后在有效期内下载归档。

常见问题

Q：接口是同步还是异步？如何获取生成结果？

A：任务类接口。提交成功返回 task_id、serialnumber 与 task_msg，随后通过 taskresult 接口凭 task_id 查询：output_status 表示任务状态（not=未开始 / processing=处理中 / finish=完成 / fail=失败），完成后 output_dourl 即生成图片的下载地址。

Q：turbo 版和 Pro 版有什么区别？

A：turbo 版基于 Z-Image-Turbo 轻量模型，出图速度更快、支持中英文字渲染；Pro 版面向更高画质要求的商业交付场景。可按业务对速度与画质的侧重选择。

Q：一次任务能生成几张图片？

A：1 张。需要多个方案时可多次调用，配合固定 seed 与微调提示词获得风格相近的系列结果。

Q：size 支持哪些取值？

A：格式为宽*高，总像素须在 512*512 至 2048*2048 之间，不传时默认 1024*1536。分隔符支持 x/X/×，服务端统一规范化为 *。超出范围会直接返回 40002 报错，不会创建任务。

Q：prompt_extend 有什么作用？会影响价格吗？

A：prompt_extend 控制是否启用智能提示词改写，默认关闭（false）。开启后使用大模型优化提示词并输出思考过程，价格高于关闭时。

Q：生成图片的链接有效期多久？

A：output_dourl 为临时下载地址，有效期 24 小时，请在任务完成后及时下载或转存到自己的存储中。

Q：重复提交同一个 serialnumber 会怎样？

A：serialnumber 同接口下不可重复，重复提交不会创建新任务，接口直接返回已存在任务的 task_id。

AI文生图turbo 文字生成图片 AI绘画图像生成快速出图

接口地址： https://www.phpwc.cn/api/texttoimageaiturbo

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`text`	string	必填	-	正向提示词，用于描述期望生成的图像内容、风格和构图。支持中英文，长度不超过800个字符，超出部分自动截断
`size`	string	选填	-	输出图像的分辨率，格式为宽高，如：1280720。不传时由模型默认输出 10241536。约束：总像素须在 262144（512512）至 4194304（20482048）之间，且长边不超过短边 4 倍，超出范围直接返回 40002 报错，不会创建任务。分隔符支持 x/X/×，服务端统一规范化为。推荐：10241024（1:1）、1248832（3:2）、8321248（2:3）、1280720（16:9）、720*1280（9:16）
`prompt_extend`	string	选填	`false`	是否启用智能提示词（text）改写，false/true，默认值：false。开启后使用大模型优化提示词并输出思考过程，价格高于关闭时
`seed`	int	选填	-	随机数种子，取值范围[0, 2147483647]，未传入时随机
`serialnumber`	string	选填	-	开发者自定义查询编号（可选，不传则无），同接口下不可重复，用于幂等控制和 taskresult 查询

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`task_id`	string	任务ID，用于通过 taskresult 接口查询任务结果
`serialnumber`	string	调用方传入的 serialnumber（未传入则为空），用于通过 taskresult 接口查询任务结果
`task_msg`	string	turbo 为轻量快速模型，出图速度快，建议每10秒通过 taskresult 接口轮询查询一次。
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

异步响应字段（调用 taskresult 返回）

本接口为异步任务类：提交后立即返回 task_id，需再调用 taskresult（传 task_id 或 serialnumber）查询结果，返回字段如下。

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	任务结果数据
`task_id`	string	任务ID（与提交响应一致）
`serialnumber`	string	调用方传入的 serialnumber（未传则为空串）
`jk_mark`	string	原调用接口标识
`output_status`	string	任务状态：not=未开始 / processing=处理中 / finish=完成 / fail=失败
`output_content`	string	完成后的文本结果，无则为空串
`output_dourl`	string	完成后的产物下载地址（生成图片URL），无则为空串
`output_info`−	object	任务明细数据
`size`	string	输出分辨率（如 1024*1024）
`image_count`	int	生成图像的数量，固定为1
`output_msg`	string	任务说明 / 状态提示文案
`output_time`	int	任务耗时（秒）
`request_id`	string	请求追踪ID

taskresult 响应 JSON 示例：

{
  "code": 0,
  "desc": "success",
  "data": {
    "task_id": "任务ID",
    "serialnumber": "调用方传入的流水号",
    "jk_mark": "texttoimageaiturbo",
    "output_status": "finish",
    "output_content": "文本结果（无则空）",
    "output_dourl": "产物下载地址（无则空）",
    "output_info": { },
    "output_msg": "任务完成提示",
    "output_time": 12
  },
  "request_id": "abc123..."
}

请先登录后使用在线测试