图像生成

答安提供异步任务式图像生成 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)。

请求参数

参数类型必填说明
modelstring模型 ID,如 z-image-turbo
input.promptstring图片描述提示词
input.negative_promptstring负向提示词,描述不想出现的内容
input.imagesarray图生图必填Base64 编码的参考图片,最多 3 张
parameters.sizestring图片尺寸,如 1024*1024、1024*1024、720*1280、1280*720
parameters.seedinteger随机种子,相同种子 + 相同参数可复现结果

任务状态

图像生成通常需要 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-Turboz-image-turbo文生图,快速生成
Qwen-Imageqwen-image文生图,高质量图像生成
Qwen-Image-EditQwen-Image-Edit-2509图生图,支持图像编辑和风格转换

完整模型列表请查看控制台 模型广场

提示

图像生成按次计费,不同模型和分辨率价格不同。详细价格请查看模型广场。 视频生成请查看 视频生成