MaaS-Flux-1-schnell

创建生图任务

生图任务是异步完成

公共信息

参数	描述	示例
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

请求方法

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:1280
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"
  ]
}