Trinity
Trinity AI

中文

English

中文

English

图像生成 · 高级参数 ​

本文档为统一契约（POST /chat/completions + image_config）字段表，供调参、联调、对字段使用。Images 官方字段见 创建图像（Images）、编辑图像（Images）。端点速览另见 创建图像生成（chat）；概念与示例见 图片生成。

顶层请求体字段 ​

字段类型必填说明
modelstring是生图模型 ID；见 获取模型（modality=image）或 模型广场
messagesarray是提示词与可选参考图；至少 1 条；无参考图时须能从 user 消息提取非空 prompt
messages[].rolestring否生图场景通常仅 user
messages[].contentstring or array是string：纯文本 prompt；array：可含 text / image_url Part
modalitiesarray建议须含 image；可含 text
streamboolean否必须为 false 或省略；true 报 invalid_request
image_configobject否生图公共参数，见下节
model_specific_configobject否供应商专有参数，见 model_specific_config；未知键忽略
trinity_asyncobject否当前不支持；传入报 invalid_request

image_config ​

字段类型说明
image_sizestring分辨率档位，如 1K / 2K / 4K、1080p 等；枚举因模型而异
aspect_ratiostring宽高比，如 1:1、16:9、9:16；部分模型（如 Hunyuan 3.0、Qwen-0925、SI 系列）不支持，须用 custom_size
output_formatstring对外交付形态：url（默认）/ base64（data URL）
output_image_formatstring输出文件格式：png / jpeg
person_generationstring人物/人脸策略：allow_adult / disallowed
input_compliance_checkboolean输入合规检查，默认 true
output_compliance_checkboolean输出合规检查，默认 true
custom_sizestring自定义像素尺寸，如 1024x1024；Hunyuan / Qwen / SI 等依赖此字段
sequential_image_generationboolean or string多图顺序生成，如 false 或 "auto"；仅部分模型支持
reference_imagesarray参考图列表，见 reference_images
output_image_countinteger输出张数；仅部分模型支持（如 1–8）；未传时默认 1

aspect_ratio 常用值 ​

1:1、16:9、9:16、4:3、3:4、3:2、2:3、4:5、5:4、21:9 — 是否生效以模型能力为准。

WARNING

trinity_async.* 生图当前不支持，传入会 invalid_request。

model_specific_config ​

供应商专有参数统一放此对象，不要与 image_config 混用。仅当前模型白名单键生效，未知键忽略。

字段类型说明
negative_promptstring负向提示词
enhance_promptboolean or string自动优化 prompt：true/Enabled 开启
scene_typestring场景扩展（按模型，如 3d_panorama、image_expand）
seedinteger随机种子，用于复现
session_idstring上游去重 ID，≤50 字符
session_contextstring透传上下文，≤1000 字符
tasks_priorityinteger任务优先级 -10 ~ 10，默认 0
input_regionstring输入区域：Mainland / Oversea / OverseaUSWest

reference_images ​

字段类型必填说明
typestring是当前仅支持 url
urlstring是可公网访问的图片 URL；推荐单图 < 7MB
textstring否参考图语义说明

支持格式：jpeg / jpg / png / webp。

各模型参考图张数上限（节选） ​

模型系列上限
GG-2.53
GG-3.0 / GG-3.114
gemini-2.5-flash-image3
gemini-3.1-flash-image / gemini-3.1-flash-lite-image14
Kling-2.14
Kling-3.01
Kling-3.0-omni / Kling-O110
SI-4.0 / SI-4.5 / SI-5.0-lite14
Vidu-q2（历史）7
viduq2-image7
Hunyuan-3.03
Qwen-09251
Jimeng-4.010
OG-image2-low / medium / high16
MJ-v73

完整上限以 模型广场 中该模型说明为准。

messages[].content 中的 image_url（可选） ​

与 图片输入 Part 结构相同，可作为参考图补充：

json
{
  "role": "user",
  "content": [
    { "type": "text", "text": "保持角色服装主色调" },
    { "type": "image_url", "image_url": { "url": "https://example.com/ref.png" } }
  ]
}

系列码示例 ​

统一契约均为 POST /chat/completions + modalities 含 image。端点说明见 创建图像生成（chat）。

Gemini 生图 ​

model说明
gemini-2.5-flash-image文生 / 参考编辑；常用 aspect_ratio（本码一般不传 image_size）
gemini-3.1-flash-image同上；可用 image_size（如 1K / 2K / 4K）
gemini-3.1-flash-lite-image加速档；image_size 常见仅 1K
json
{
  "model": "gemini-2.5-flash-image",
  "messages": [
    { "role": "user", "content": "A simple red circle on white background, flat vector" }
  ],
  "modalities": ["image"],
  "stream": false,
  "image_config": {
    "aspect_ratio": "1:1",
    "output_format": "url"
  }
}

OG / Jimeng / Qwen ​

model尺寸字段备注
OG-image2-low / OG-image2-medium / OG-image2-highimage_size（如 1K）+ aspect_ratio质量档拆在 model；可选 output_image_count（1–8）
Jimeng-4.0custom_size（如 1024x1024）一般不传 aspect_ratio
Qwen-0925custom_size（如 1024x1024）一般不传 aspect_ratio；参考图上限 1
json
{
  "model": "OG-image2-medium",
  "messages": [
    { "role": "user", "content": "一只橘猫，极简插画，白底" }
  ],
  "modalities": ["image"],
  "stream": false,
  "image_config": {
    "image_size": "1K",
    "aspect_ratio": "1:1",
    "output_format": "url"
  }
}
json
{
  "model": "Jimeng-4.0",
  "messages": [
    { "role": "user", "content": "一只橘猫，极简插画，白底" }
  ],
  "modalities": ["image"],
  "stream": false,
  "image_config": {
    "custom_size": "1024x1024",
    "output_format": "url"
  }
}
json
{
  "model": "Qwen-0925",
  "messages": [
    { "role": "user", "content": "一只橘猫，极简插画，白底" }
  ],
  "modalities": ["image"],
  "stream": false,
  "image_config": {
    "custom_size": "1024x1024",
    "output_format": "url"
  }
}

超时后查询任务 ​

同步等待超时（默认 300s，返回 408 generation_timeout）后，可用任务 ID 继续查询；成功终态时仍会交付图片并结算。

项值
方法GET
路径/image/tasks/{taskId}
taskId创建/超时响应中 trinity_task.task_id（形如 imgtsk_xxx）
bash
curl -sS "${TRINITY_BASE_URL}/image/tasks/imgtsk_xxx" \
  -H "Authorization: Bearer ${TRINITY_API_KEY}"

成功响应示例 ​

json
{
  "id": "chatcmpl-imgtsk_xxx",
  "object": "chat.completion",
  "model": "GG-2.5",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "",
        "images": [
          {
            "type": "image_url",
            "image_url": { "url": "https://..." }
          }
        ]
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0,
    "image_count": 1
  },
  "trinity_task": {
    "task_id": "imgtsk_xxx",
    "mode": "sync",
    "status": "succeeded"
  }
}

响应头回写 X-Request-Id、X-Settlement-Key 等，见 API 概述。

与生文传图的区别 ​

能力传图方式输出
生文看图messages[].content[] · type: image_url → 图片输入文本
生图参考图image_config.reference_images[] 或 messages 中的 image_urlchoices[].message.images[]

完整 JSON 示例（创建） ​

json
{
  "model": "GG-2.5",
  "messages": [
    { "role": "user", "content": "赛博朋克城市夜景，霓虹倒影，电影光效" }
  ],
  "modalities": ["image", "text"],
  "stream": false,
  "image_config": {
    "image_size": "1K",
    "aspect_ratio": "16:9",
    "output_format": "url",
    "output_image_format": "png",
    "person_generation": "allow_adult",
    "reference_images": [
      {
        "type": "url",
        "url": "https://example.com/ref-building.png",
        "text": "保留主建筑轮廓，不改变几何结构"
      }
    ]
  },
  "model_specific_config": {
    "negative_prompt": "低清晰度, 模糊, 变形",
    "enhance_prompt": true,
    "seed": 123456
  }
}

相关 ​

© Trinity AI

© Trinity AI