图像生成
答安提供异步任务式图像生成 API,支持文生图和图生图。通过提交任务 → 轮询结果的方式获取生成图片。
API 信息
- 接口地址:
https://maas.token618.com/api/open-apis/projects/easyllms/imagegenerator/task - 认证方式:
Authorization: Bearer YOUR_API_KEY - 调用模式:异步任务(提交 → 轮询)
快速开始
图像生成采用异步任务模式:先提交生成任务获取 taskId,再通过 taskId 轮询直到任务完成。
调用流程
提交任务获取 taskId轮询结果获取图片 URL
1提交生成任务
cURL
curl -X POST "https://maas.token618.com/api/open-apis/projects/easyllms/imagegenerator/task" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image-turbo",
"input": {
"prompt": "奔跑的小猫"
},
"parameters": {
"size": "1024*1024"
}
}'成功返回:
Response
{
"output": {
"taskId": "47lSjKhfq7C0uTFJ8zWZNo",
"taskStatus": "PENDING"
}
}2轮询任务结果
cURL
curl "https://maas.token618.com/api/open-apis/projects/easyllms/imagegenerator/task/TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"生成中:
Response (进行中)
{
"output": {
"taskId": "47lSjKhfq7C0uTFJ8zWZNo",
"taskStatus": "RUNNING"
}
}生成完成:
Response (成功)
{
"output": {
"taskId": "47lSjKhfq7C0uTFJ8zWZNo",
"taskStatus": "SUCCEEDED",
"results": [
{
"url": "http://251000800.vod2.myqcloud.com/.../aigcImageGenFile.jpg"
}
]
}
}3获取图片
任务成功后,results[0].url 即为生成的图片地址,可直接访问或下载。
文生图
通过文字描述生成图片,支持正向和负向提示词。
cURL
curl -X POST "https://maas.token618.com/api/open-apis/projects/easyllms/imagegenerator/task" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image-turbo",
"input": {
"prompt": "一只在草地上奔跑的金毛犬,阳光明媚,高清摄影",
"negative_prompt": "模糊, 低质量, 变形"
},
"parameters": {
"size": "1024*1024",
"seed": 42
}
}'图生图
上传参考图片并描述想要的变换效果,模型将基于原图进行风格转换或内容修改。
cURL
curl -X POST "https://maas.token618.com/api/open-apis/projects/easyllms/imagegenerator/task" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Qwen-Image-Edit-2509",
"input": {
"prompt": "将背景替换为海滩日落场景",
"images": ["data:image/png;base64,iVBOR..."]
},
"parameters": {
"size": "1024*1024"
}
}'images 字段支持 Base64 编码的图片数据,最多上传 3 张参考图片。请使用支持图生图的模型(模型名包含 Edit)。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型 ID,如 z-image-turbo |
| input.prompt | string | 是 | 图片描述提示词 |
| input.negative_prompt | string | 否 | 负向提示词,描述不想出现的内容 |
| input.images | array | 图生图必填 | Base64 编码的参考图片,最多 3 张 |
| parameters.size | string | 否 | 图片尺寸,如 1024*1024、1024*1024、720*1280、1280*720 |
| parameters.seed | integer | 否 | 随机种子,相同种子 + 相同参数可复现结果 |
任务状态
图像生成通常需要 10-60 秒,建议每 3 秒轮询一次任务状态。
| 状态 | 说明 |
|---|---|
| PENDING | 任务已提交,等待处理 |
| RUNNING | 正在生成中 |
| SUCCEEDED | 生成成功,results 中包含图片 URL |
| FAILED | 生成失败,message 中包含错误信息 |
完整代码示例
Python
import requests
import time
API_BASE = "https://maas.token618.com/api/open-apis"
API_KEY = "YOUR_API_KEY"
HEADERS = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
}
# 1. 提交任务
resp = requests.post(f"{API_BASE}/projects/easyllms/imagegenerator/task", headers=HEADERS, json={
"model": "z-image-turbo",
"input": {"prompt": "一只在草地上奔跑的金毛犬"},
"parameters": {"size": "1024*1024"},
})
task_id = resp.json()["output"]["taskId"]
print(f"任务已提交: {task_id}")
# 2. 轮询结果
for _ in range(120):
time.sleep(3)
resp = requests.get(f"{API_BASE}/projects/easyllms/imagegenerator/task/{task_id}", headers=HEADERS)
data = resp.json()["output"]
if data["taskStatus"] == "SUCCEEDED":
print(f"图片地址: {data['results'][0]['url']}")
break
elif data["taskStatus"] == "FAILED":
print(f"生成失败: {data.get('message')}")
break
print(f"状态: {data['taskStatus']}...")在线体验
不想写代码?可以直接在控制台的模型演练场中体验图像生成功能,选择图片模式即可快速生成。
可用模型
| 模型 | 模型 ID | 说明 |
|---|---|---|
| Z-Image-Turbo | z-image-turbo | 文生图,快速生成 |
| Qwen-Image | qwen-image | 文生图,高质量图像生成 |
| Qwen-Image-Edit | Qwen-Image-Edit-2509 | 图生图,支持图像编辑和风格转换 |
完整模型列表请查看控制台 模型广场。
提示
图像生成按次计费,不同模型和分辨率价格不同。详细价格请查看模型广场。 视频生成请查看 视频生成。