Trellis AITrellis AI
API 文档 / Trellis 文生图（Qwen-Image）

API 文档 · Trellis 文生图（Qwen-Image）

模型 ID：trellis-qwen-image

接口

POST /v1/images/generationsapplication/json文生图
POST /v1/jobs/{id}/cancel取消任务（canceling → canceled；不计费）
调用方式
同步：直接 POST 返回结果（建议超时 1200s）；超时后请勿自动重试。
异步（推荐）：POST 加请求头 X-Trellis-Async: 1 → 返回 202 {id, poll}；轮询 GET /v1/jobs/{id}（间隔 5–10s）。

请求参数：

参数类型必填默认说明
modelstring是trellis-qwen-image固定 trellis-qwen-image
promptstring是—提示词
negative_promptstring否""反向提示词
sizestring否1328x1328Qwen-Image 原生约 1328；最长边 ≤2048（1024 会明显糊）
num_inference_stepsinteger否40步数
true_cfg_scalenumber否4.0引导强度
seedinteger否0随机种子
response_formatstring否urlurl | b64_json
qcboolean否false是否同步质检（返回 qc 指标，不额外收费，耗时 ≥25 分钟）

响应示例：

{ "created": 0,
  "data": [ { "url": "/v1/files/image/xxxx.png" } ],
  "usage": { "image_count": 1, "size": "1024x1024" } }
所有模型共用同一 API Key 与同一端点：https://api.trellis.hk/v1