跳转至

文本生图片

公共信息

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

MaaS-Stable-Diffusion-3.5-Large

创建生图任务

生图任务是异步完成

请求方法

POST

请求路径

{basePath}/v2/ai/{endpointPath}/images/generations

参数 描述 示例
Authorization AccessKey
Bearer ${AccessKey}		 Bearer RWxxxxxxxx0Gd

请求body

字段名 类型 是否必填 描述 示例值
prompts string 是 正向提示词 A fruit basket containing dragon fruit, mango, guava, apple, and banana
neg-prompts string 否 负向提示词 Peach
batchsize int 否 出图数量 限制范围：1-8 default：1 1
aspect_ratio String 否 宽高比 支持的值：1:1、2:3、3:2、3:4、4:3、16:9、9:16 1:1 对应 1024:1024
2:3 对应 512:768
3:2 对应 768:512
3:4 对应 768:1024
4:3 对应 1024:768
16:9 对应 1280:720
9:16 对应 720:1080
Step int 是 步数 限制范围：20-40 4
seed int 否 随机种子
default：0		 0

返回值

字段名 类型 描述 示例值
status String 状态值 success
error
taskId String 任务id

示例

请求

使用客户端点方式调用

curl --request POST \
  --url https://genaiapi.cloudsway.net/v2/ai/HotklGMehD/images/generations \
  --header 'Accept: */*' \
  --header 'Accept-Encoding: gzip, deflate, br' \
  --header 'Authorization: Bearer ${AccessKey}' \
  --header 'Connection: keep-alive' \
  --header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
  --header 'content-type: application/json' \
  --data '{
    "prompts": "A fruit basket containing dragon fruit, mango, guava, apple, and banana",
    "neg-prompts":"peach",
    "aspect_ratio": "1:1",
    "step": 25
}'

使用统一域名方式调用

curl --request POST \
  --url https://genaiapi.cloudsway.net/v2/images/generations \
  --header 'Accept: */*' \
  --header 'Accept-Encoding: gzip, deflate, br' \
  --header 'Authorization: Bearer ${AccessKey}' \
  --header 'Connection: keep-alive' \
  --header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
  --header 'content-type: application/json' \
  --data '{
    "prompts": "A fruit basket containing dragon fruit, mango, guava, apple, and banana",
    "neg-prompts":"peach",
    "aspect_ratio": "1:1",
    "step": 25,
    "model":"MaaS-Stable-Diffusion-3.5-Large"
}'

返回值

{
  "status": "success",
  "taskId": "3374b3b0-d069-4831-a76b-ebab4df14457"
}

查看任务信息

请求方法

GET

请求路径

{basePath}/v2/ai/{endpointPath}/images/tasks/{taskId}

请求header

参数 描述 示例
Authorization AccessKey
Bearer ${AccessKey}		 Bearer RWxxxxxxxx0Gd

请求参数

字段名 类型 是否必填 描述 示例值
taskId String 是 任务id 3374b3b0-d069-4831-a76b-ebab4df14457

返回值

字段名 类型 描述 示例值
status String 任务状态信息 completed
Current task is in progress, please try again later
completed boolean 是否完成 true
false
imageUrls list 图片地址集合

示例

请求

使用客户端点方式调用

curl --location --request GET 'https://genaiapi.cloudsway.net/v2/ai/lXynAhfbOiD/images/tasks/3374b3b0-d069-4831-a76b-ebab4df14457 ' \
--header 'Authorization: Bearer ${AccessKey}' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'content-type: application/json' \
--header 'Accept: */*' \
--header 'Connection: keep-alive' \
--data-raw ''

使用统一域名方式调用

curl --request GET \
  --url https://genaiapi.cloudsway.net/v2/images/tasks/MaaS-Stable-Diffusion-3.5-Large/bd03bf13-f480-4ca2-b686-b3ea26c969ef \
  --header 'Accept: */*' \
  --header 'Accept-Encoding: gzip, deflate, br' \
  --header 'Authorization: Bearer ${AccessKey}' \
  --header 'Connection: keep-alive' \
  --header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
  --header 'content-type: application/json'

返回值

{
  "status": "completed",
  "completed": true,
  "imageUrls": [
    "http://xxxx.png"
  ]
}

MaaS-Flux-1-schnell

创建生图任务

生图任务是异步完成

请求方法

POST

请求路径

{basePath}/v2/ai/{endpointPath}/images/generations

请求header

参数 描述 示例
Authorization AccessKey
Bearer ${AccessKey}		 Bearer RWxxxxxxxx0Gd

请求body

字段名 类型 是否必填 描述 示例值
prompts string 是 正向提示词 A fruit basket containing dragon fruit, mango, guava, apple, and banana.
batchsize int 否 出图数量 限制范围：1-8 default：1 1
aspect_ratio String 否 宽高比 支持的值：1:1、2:3、3:2、3:4、4:3、16:9、9:16 1:1 对应 1024:1024
2:3 对应 512:768
3:2 对应 768:512
3:4 对应 768:1024
4:3 对应 1024:768
16:9 对应 1280:720
9:16 对应 720:1080
Step int 是 步数 限制范围：4-10 4
seed int 否 随机种子
default：0		 0

返回值

字段名 类型 描述 示例值
status String 状态值 success
taskId String 任务id

示例

请求

curl --request POST \
--url https://genaiapi.cloudsway.net/v2/ai/lXynAhfbAiD/images/generations \
--header 'Authorization: Bearer ${AccessKey}' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'content-type: application/json' \
--header 'Accept: */*' \
--header 'Connection: keep-alive' \
--data-raw '{
"prompts": "A fruit basket containing dragon fruit, mango, guava, apple, and banana.",
"aspect_ratio": "2:3",
"batchsize": "2",
"step": 10
}'

返回值

{
  "status": "success",
  "taskId": "3374b3b0-d069-4831-a76b-ebab4df14457"
}

查看任务信息

请求方法

GET

请求路径

{basePath}/v2/ai/{endpointPath}/images/tasks/{taskId}

请求header

参数 描述 示例
Authorization AccessKey
Bearer ${AccessKey}		 Bearer RWxxxxxxxx0Gd

请求参数

字段名 类型 是否必填 描述 示例值
taskId String 是 任务id 3374b3b0-d069-4831-a76b-ebab4df14457

返回值

字段名 类型 描述 示例值
status String 任务状态信息
completed boolean 是否完成
imageUrls list 图片地址集合

示例

请求

curl --location --request GET 'https://genaiapi.cloudsway.net/v2/ai/lXynAhfbOiD/images/tasks/3374b3b0-d069-4831-a76b-ebab4df14457 ' \
--header 'Authorization: Bearer ${AccessKey}' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'content-type: application/json' \
--header 'Accept: */*' \
--header 'Connection: keep-alive' \
--data-raw ''

返回值

{
  "status": "completed",
  "completed": true,
  "imageUrls": [
    "http://xxxx.png"
  ]
}