MaaS-MJ

公共信息

参数	描述	示例
basePath	调用mass api的基础路径，包含/v1/ai固定路径	https://genaiapi.cloudsway.net/v1/ai
endpointPath	调用mass api的生成的一段随机路径
AccessKey	调用mass api的accessKey	RWxxxxxxxx0Gd
taskId	The task ID for asynchronous video processing tasks	1234abcd

参数列表

参数	参数格式	描述	补充
宽高比	--aspect 或 --ar	仅支持整数比例，如`139:100` 替代`1.39:1` 不同模型版本对宽高比的支持程度可能不同极端宽高比（如1:10或10:1）属于实验性功能，效果可能不稳定高清处理时，部分宽高比可能会进行微调优化	默认宽高比为1:1
混沌	--chaos 或 --c	用于调节图像生成过程中的随机性程度，直接影响生成结果的多样性表现。取值范围：0-100	混沌值：0 生成数量：4张图像生成特征：基于提示词生成风格统一的图像
角色参考	--cref	角色参考允许您在多个图像中重新创建特定角色。	无
角色权重	--cw	同角色参考一起使用，用于指定生成图片中角色的权重	无
否定提示	--no	用于指定生成图像时需要排除的元素或特征。该参数通过负权重机制实现，相当于为指定元素设置-0.5的权重值。	排除特定对象：如 `--no 水果,树木` 避免特定风格：如 `--no 卡通,抽象` 控制图像特征：如 `--no 阴影,高光`
个性化	--profile 或 --p	使用个性化配置文件和情绪板创建自定义图像风格	无
质量	--quality 或 --q	使用质量参数控制图像的细节和处理时间	在v7版本中，质量参数进行了优化：默认优化：v7模型默认使用`--q 1`，提供更好的手部连贯性，同时减少GPU时间消耗历史模式：如需使用优化前的v7模型，可添加`--q 2` 实验模式：使用`--q 4`尝试新的生成模式，可能获得更好的细节表现
重复	--repeat 或 --r	重复参数允许用户通过单次提示请求生成多个图像变体。该功能特别适用于：需要从同一提示获取多个创意方案时进行图像风格或细节的对比测试时批量生成相似但独特的图像时	无
种子	--seed	种子参数用于设置图像生成的初始随机状态，类似于计算机图形学中的随机数种子。通过指定相同的种子值，可以在相同提示词下获得相似的初始生成结果。	无
停止	--stop	停止参数用于在图像生成过程中提前终止渲染，通过控制生成完成度来获得不同视觉效果。该参数类似于视频播放中的暂停功能，允许用户在特定阶段冻结图像生成过程。	默认值：100（完全生成）取值范围：1-100（整数）
原始模式	--raw	使用原始模式获得对图像的更多控制	无
风格化	--stylize 或 --s	使用风格化参数控制图像中的艺术风格	风格化参数用于调节图像生成在写实与艺术之间的平衡：低值（0-250）：更忠实于提示词，生成写实风格图像中值（250-750）：平衡写实与艺术性，适合大多数场景高值（750-1000）：增强艺术表现力，生成更具创意的图像默认值：100
风格参考	--sref	风格参考是一种捕捉现有图像视觉氛围并将其应用到您的新创作中的方法。它不会复制对象或人物，只复制整体风格——如颜色、媒介、纹理或光照——帮助您实现一致的视觉主题。
风格权重	--sw	风格权重参数`--sw`允许您控制参考图像的风格对新图像的影响程度。您可以将此参数设置为0到1000之间的任何值，默认值为`--sw 100`。
风格版本	--sv	与sref搭配使用，指定风格的版本	`--sv 1` 原始风格参考算法，更"有氛围" `--sv 2` 风格参考的第二次迭代 `--sv 3` `--sv 1`的更新版本，更"有氛围" `--sv 4` `--sv 2`的更新版本
平铺	--tile	平铺参数用于生成可无缝重复排列的图像，特别适合创建重复图案和纹理。该参数通过特殊算法确保图像边缘能够完美匹配，实现水平和垂直方向的无缝连接。
模型版本	--version 或 --v	使用版本参数探索和切换模型版本
草图	--draft	在V7中以一半的GPU成本生成草图图像	此功能仅与版本7兼容
怪异	--weird 或 --w	使用怪异参数使你的图像古怪和非常规	10-300：轻微怪异，保持基本可识别性 300-1000：明显非传统元素和组合 1000-3000：极端超现实和抽象效果
图像权重	--iw	控制图像提示的影响	v6* 默认值：1；权重范围：0-3 v5* 默认值：1；权重范围：0-2 v4* 默认值：-；权重范围：- Niji 6 默认值：1；权重范围：0-3 Niji 5 默认值：1；权重范围：0-2
快速模式	--fast	将你的GPU速度切换到快速模式
慢速模式	--relax	将你的GPU速度切换到慢速模式
极速模式	--turbo	将你的GPU速度切换到极速模式
Niji	--niji	使用我们专注于动漫和东方美学的模型
枚举	{}	批次生成多个提示词并生成图片
实验参数	--exp	控制图像生成的美学效果
隐身/公开模式	--stealth/--public	暂不支持
重复参数	--repeat	暂不支持
批次数量	--bs 或 --batchsize	仅支持视频任务
动态模式	--motion	控制视频动态快慢(仅支持视频任务)
万物引用	--oref	使用图片中的物体(cref的升级)
万物引用权重	--ow	指定物体在生图任务中的参考权重，与oref一起使用
视频尾帧	--end	仅限视频任务使用
视频循环	--loop	仅限视频任务使用

目前不支持 repeat、personalize、{} 排列提示词、public/stealth。

创建生图任务

生图任务是异步完成

请求方法

POST

请求路径

{basePath}/{endpointPath}/tob/diffusion

参数	描述	示例
Authorization	控制台里创建的AK AccessKey Bearer ${AccessKey}	Bearer RWxxxxxxxx0Gd

请求body

字段名	类型	是否必填	描述	示例值
text	string	是	文本信息，长度[1-8192]	A beautiful and youthful...

返回值

字段名	类型	描述	示例值
audits	Array of strings	图片审核结果，空代表审核通过	["approved"]
comment	string	任务状态详细描述	Task completed successfully.
id	string	任务ID	3374b3b0-d069-4831-a76b-ebab4df14457
seed	integer	种子值	123456
status	integer	任务状态 Default:"0" Enum: 0:新创建 1:执行中 2:执行成功 3:失败	0
text	string	文本，长度[1-8192]	A beautiful and youthful...
urls	Array of strings	图片URL或空	["http://example.com/image1.jpg"]

示例

请求

curl --request POST \
  --url https://genaiapi.cloudsway.net/v1/ai/eljciTfuqTxBSjXl/tob/diffusion \
  --header 'Authorization: Bearer ${AccessKey}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "text": "一辆炫酷的赛车，在山路上飞驰"
  }'

返回值

{
  "audits": [],
  "comment": "执行中",
  "id": "67a99aa1f674346b1d1c010f",
  "seed": 0,
  "status": 1,
  "text": "一辆炫酷的赛车，在山路上飞驰",
  "urls": []
}

区域重绘

请求方法

POST

请求路径

{basePath}/{endpointPath}/tob/inpaint

请求header

参数	描述	示例
Authorization	控制台里创建的AK AccessKey Bearer ${AccessKey}	Bearer RWxxxxxxxx0Gd

请求body

字段名	类型	是否必填	描述	示例值
imageNo	int	是	图片编号(0/1/2/3)	0
jobId	string	是	任务ID	1234567890
mask	object	是	轻量区域蒙板，支持多区域重绘	{...}
remixPrompt	string	否	重绘关键词提示，长度[1-8192]	A new artistic style

area 对象

字段名	类型	是否必填	描述	示例值
height	int	是	图片像素高(500-4096)	1024
points	Array	是	多边形区域坐标点	[169,673,561,687,607,847,186,847]
width	int	是	图片像素宽(500-4096)	1024

返回值

字段名	类型	描述	示例值
audits	Array of strings	图片审核结果
comment	string	任务状态详细描述	执行中
id	string	任务ID	3374b3b0-d069-4831-a76b-ebab4df14457
seed	integer	种子值	123456
status	integer	任务状态 Default:"0" Enum: 0:新创建 1:执行中 2:执行成功 3:失败	0
text	string	文本	A beautiful and youthful...
urls	Array of strings	图片URL或空	["http://example.com/image1.jpg"]

示例

请求

curl --request POST 'https://genaiapi.cloudsway.net/v1/ai/eljciTfuqTxBSjXl/tob/inpaint' \
--header 'Authorization: Bearer ${AccessKey}' \
--header 'content-type: application/json' \
--header 'Accept: */*' \
--data-raw '{
  "imageNo": 0,
  "jobId": "67a96a41fc0b6392b58e4285",
  "mask": {
    "areas": [
      {
        "height": 500,
        "points": [
          169,673,561,687,607,847,186,847
        ],
        "width": 500
      }
    ]
  }
}''

返回值

{
  "audits": [],
  "comment": "执行中",
  "id": "67a99bbff674346b1d1c015c",
  "seed": 0,
  "status": 1,
  "text": "一辆炫酷的赛车，在山路上飞驰",
  "urls": []
}

高清生图

请求方法

POST

请求路径

{basePath}/{endpointPath}/tob/upscale

请求header

参数	描述	示例
Authorization	控制台里创建的AK AccessKey Bearer ${AccessKey}	Bearer RWxxxxxxxx0Gd

请求body

字段名	类型	是否必填	描述	示例值
imageNo	int	是	图片编号(0/1/2/3)	0
jobId	string	是	任务ID	1234567890
type	int	是	高清类型	0

type 参数说明

Default: "0"
Enum: "0" "1"
0: v6/niji6/v6.1/v7 subtle高清
1: v6/niji6/v6.1/v7 creative高清

返回值

字段名	类型	描述	示例值
audits	Array of strings	图片审核结果
comment	string	任务状态详细描述	执行中
id	string	任务ID	3374b3b0-d069-4831-a76b-ebab4df14457
seed	integer	种子值	123456
status	integer	任务状态	2
text	string	文本	A beautiful and youthful...
urls	Array of strings	图片URL或空	["http://example.com/image1.jpg"]

示例

请求

curl --request POST 'https://genaiapi.cloudsway.net/v1/ai/eljciTfuqTxBSjXl/tob/upscale' \
--header 'Authorization: Bearer ${AccessKey}' \
--header 'content-type: application/json' \
--header 'Accept: */*' \
--data-raw '{
  "imageNo": 0,
  "jobId": "67a99bbff674346b1d1c015c",
  "type": 1
}'

返回值

{
  "audits": [],
  "comment": "执行中",
  "id": "67a9ae7cfc0b6392b58e4ff6",
  "seed": 0,
  "status": 1,
  "text": "一辆炫酷的赛车，在山路上飞驰",
  "urls": []
}

查询任务信息

请求方法

GET

请求路径

{basePath}/{endpointPath}/tob/job/{jobId}

路径参数

参数	类型	是否必填	描述
jobId	string	是	任务ID

返回值

字段名	类型	描述
audits	Array of strings	图片审核结果；与urls数组中的下标对应，空代表审核通过
comment	string	任务状态详细描述
id	string	任务ID
seed	integer	种子值
status	integer	任务状态
text	string	文本，长度[1-8192]
urls	Array of strings	图片URL数组, 空单个url为代表审核未通过

status 参数说明

0: 任务创建
1: 执行中
2: 执行成功
3: 失败

示例

请求

curl --request GET 'https://genaiapi.cloudsway.net/v1/ai/eljciTfuqTxBSjXl/tob/job/67a99aa1f674346b1d1c010f' \
--header 'Authorization: Bearer ${AccessKey}' \
--header 'content-type: application/json' \

返回值

{
  "audits": ["approved"],
  "comment": "成功",
  "id": "3374b3b0-d069-4831-a76b-ebab4df14457",
  "seed": 123456,
  "status": 2,
  "text": "A beautiful and youthful high school girl is sitting in the classroom, with a bright smile on her face.",
  "urls": ["http://example.com/image1.jpg"]
}

请求示例

curl 'https://genaiapi.cloudsway.net/v1/ai/{{endpointPath}}/tob/diffusion' \
-H 'Authorization:  Bearer {Your AK}' \
-H 'Content-Type:  application/json' \
-d '{
    "text": "一辆炫酷的赛车，在山路上飞驰 --v 7 --aspect 2:1 --draft --turbo"
}'