Skip to content

Text-to-Image API

Common Information

Parameter Description Example
basePath The base path for calling the mass API, includes the fixed path/v1/ai https://genaiapi.cloudsway.net/v2/ai
endpointPath A randomly generated path segment for calling the mass API
AccessKey The access key for calling the mass API RWxxxxxxxx0Gd
taskId The task ID for asynchronous image processing tasks 1234abcd

MaaS-midjourney

Create raw image task

The raw image task is completed asynchronously.

Request method

POST

Request path

{basePath}/{endpointPath}/tob/diffusion

Request header

Parameters Description Example
Authorization The AK (Access Key) created in the console.
AccessKey
Bearer ${AccessKey}		 Bearer RWxxxxxxxx0Gd

Request body

Field Name Type Required Description Example
text string Yes Text Information, Length [1-8192] A beautiful and youthful...

Response value

| Field Name | Type | Required | Description | Example | |---------|----------------|---------------------------|--------------------------------| | audits | Array of strings | Image review results, empty indicates approval | ["approved"] | | comment | string | Task status detailed description. | Task completed successfully. | | id | string | Job ID | 3374b3b0-d069-4831-a76b-ebab4df14457 | | seed | integer | Seed value | 123456 | | status | integer | Task status
Default:"0"
Enum:
0: Newly created
1:In progress
2:Successfully completed
3:Failed | 0 | | text | string | Text，length[1-8192] | A beautiful and youthful... | | urls | Array of strings | Image URL or empty | ["http://example.com/image1.jpg"] |

Example

Request
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": "一辆炫酷的赛车，在山路上飞驰"
  }'
Response
{
  "audits": [],
  "comment": "执行中",
  "id": "67a99aa1f674346b1d1c010f",
  "seed": 0,
  "status": 1,
  "text": "一辆炫酷的赛车，在山路上飞驰",
  "urls": []
}

Region Redraw

Request method

POST

Request path

{basePath}/{endpointPath}/tob/inpaint

Request header

Parameters Description Example
Authorization The AK (Access Key) created in the console.
AccessKey
Bearer ${AccessKey}		 Bearer RWxxxxxxxx0Gd

Request body

Field Name Type Required Description Example
imageNo int Yes image number(0/1/2/3) 0
jobId string Yes job ID 1234567890
mask object Yes Lightweight region mask, supports multiple region redraws. {...}
remixPrompt string No Redraw keyword prompt, length[1-8192] A new artistic style

area

Field Name Type Required Description Example
height int Yes Image pixel height(500-4096) 1024
points Array Yes Polygon region coordinates [169,673,561,687,607,847,186,847]
width int Yes Image pixel width(500-4096) 1024

Response value

| Field Name | Type | Required | Description | Example | |---------|----------------|---------------------------|--------------------------------------| | audits | Array of strings | Image review results | | | comment | string | Task status detailed description | In progress | | id | string | Job ID | 3374b3b0-d069-4831-a76b-ebab4df14457 | | seed | integer | Seed value | 123456 | | status | integer | Task status
Default:"0"
Enum:
0: Newly created
1:In progress
2:Successfully completed
3:Failed | 0 | | text | string | Text | A beautiful and youthful... | | urls | Array of strings | Image URL or empty | ["http://example.com/image1.jpg"] |

Example

Request
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
      }
    ]
  }
}''
Response
{
  "audits": [],
  "comment": "执行中",
  "id": "67a99bbff674346b1d1c015c",
  "seed": 0,
  "status": 1,
  "text": "一辆炫酷的赛车，在山路上飞驰",
  "urls": []
}

High definition

Request method

POST

Request path

{basePath}/{endpointPath}/tob/upscale

Request header

Parameters Description Example
Authorization The AK (Access Key) created in the console.
AccessKey
Bearer ${AccessKey}		 Bearer RWxxxxxxxx0Gd

Request body

Field Name Type Required Description Example
imageNo int Yes Image number(0/1/2/3) 0
jobId string Yes Job ID 1234567890
type int Yes HD Type 0
type Parameters
  • Default: "0"
  • Enum: "0" "1" "2" "3"
  • 0: v6/niji6/v6.1 subtle HD
  • 1: v6/niji6/v6.1 creative HD

Response value

| Field Name | Type | Required | Description | Example | |---------|----------------|---------------------------|--------------------------------------| | audits | Array of strings | Image review results | | | comment | string | Task status detailed description | In progress | | id | string | Job ID | 3374b3b0-d069-4831-a76b-ebab4df14457 | | seed | integer | Seed value | 123456 | | status | integer | Task status
Default:"0"
Enum:
0: Newly created
1:In progress
2:Successfully completed
3:Failed | 0 | | text | string | Text | A beautiful and youthful... | | urls | Array of strings | Image URL or empty | ["http://example.com/image1.jpg"] |

Example

Request
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
}'
Response
{
  "audits": [],
  "comment": "执行中",
  "id": "67a9ae7cfc0b6392b58e4ff6",
  "seed": 0,
  "status": 1,
  "text": "一辆炫酷的赛车，在山路上飞驰",
  "urls": []
}

Query task information.

Request method

GET

Request path

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

Path parameters

Parameters Type Required Description
jobId string Yes Job ID

Response Value

Field Name Type Description
audits Array of strings Image review results；corresponds to the index in the URLs array, empty indicates approval.
comment string Task status detailed description
id string Job ID
seed integer Seed value
status integer Task status
text string Text，length[1-8192]
urls Array of strings Image URL array, a single empty URL indicates disapproval.
status Parameters
  • 0: Task creation
  • 1: In progress
  • 2: Successfully completed
  • 3: Failed

Example

Request
curl --request GET 'https://genaiapi.cloudsway.net/v1/ai/eljciTfuqTxBSjXl/tob/job/67a99aa1f674346b1d1c010f' \
--header 'Authorization: Bearer ${AccessKey}' \
--header 'content-type: application/json' \
Response
{
  "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"]
}

MaaS-Stable-Diffusion-3.5-Large

Generate image

Request Method

POST

Request Path

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

Request Headers

Parameter Description Example
Authorization AccessKey
Bearer ${AccessKey}		 Bearer RWxxxxxxxx0Gd

Request Body

Field Name Type Required Description Example Value
prompts string Yes Positive prompt words. A beautiful and youthful high school girl is sitting in the classroom, with a bright smile on her face.
neg-prompts string No Negative prompts Peach
batchsize int No Number of generated images. Limit range: 1 to 8. default：1 1
aspect_ratio String No Aspect ratio; supported values include：1:1、2:3、3:2、3:4、4:3、16:9、9:16 1:1 corresponds to 1024:1024
2:3 corresponds to 512:768
3:2 corresponds to 768:512
3:4 corresponds to 768:1024
4:3 corresponds to 1024:768
16:9 corresponds to 1280:720
9:16 corresponds to 720:1280
step int Yes step Limit range：4-10 4
seed int No Random seed.
default：0		 0

Response

Field Name Type Description Example Value
status String status success
error
taskId String task id

Example

Request

Invoke using the endpoint method

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
}'

Invoke using unified model method

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"
}'
Response
{
  "status": "success",
  "taskId": "3374b3b0-d069-4831-a76b-ebab4df14457"
}

Query Image Task Result

Request Method

GET

Request Path

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

Request Header

Parameter Description Example
Authorization AccessKey
Bearer ${AccessKey}		 Bearer RWxxxxxxxx0Gd

Path Variables

Field Name Type Required Description Example Value
taskId String Yes Task id 3374b3b0-d069-4831-a76b-ebab4df14457

Response

Field Name Type Description Example Value
status String Task status information. completed
Current task is in progress, please try again later
completed boolean Whether completed. true
false
imageUrls list Collection of image addresses.

Example

Request

Invoke using the endpoint method

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 ''

Invoke using unified model method

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'
Response
{
  "status": "completed",
  "completed": true,
  "imageUrls": [
    "http://xxxx.png"
  ]
}

MaaS-Flux-1-schnell

Generate image

Request Method

POST

Request Path

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

Request Headers

Parameter Description Example
Authorization AccessKey
Bearer ${AccessKey}		 Bearer RWxxxxxxxx0Gd

Request Body

Field Name Type Required Description Example Value
prompts string Yes Positive prompt words. A beautiful and youthful high school girl is sitting in the classroom, with a bright smile on her face.
batchsize int No Number of generated images. Limit range: 1 to 8. default：1 1
aspect_ratio String No Aspect ratio; supported values include：1:1、2:3、3:2、3:4、4:3、16:9、9:16 1:1 corresponds to 1024:1024
2:3 corresponds to 512:768
3:2 corresponds to 768:512
3:4 corresponds to 768:1024
4:3 corresponds to 1024:768
16:9 corresponds to 1280:720
9:16 corresponds to 720:1280
step int Yes step Limit range：4-10 4
seed int No Random seed.
default：0		 0

Response

Field Name Type Description Example Value
status String status success
taskId String task id

Example

Request
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 beautiful and youthful high school girl is sitting in the classroom, with a bright smile on her face.",
"aspect_ratio": "2:3",
"batchsize": "2",
"step": 10
}'
Response
{
  "status": "success",
  "taskId": "3374b3b0-d069-4831-a76b-ebab4df14457"
}

Query Image Task Result

Request Method

GET

Request Path

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

Request Header

Parameter Description Example
Authorization AccessKey
Bearer ${AccessKey}		 Bearer RWxxxxxxxx0Gd

Path Variables

Field Name Type Required Description Example Value
taskId String Yes Task id 3374b3b0-d069-4831-a76b-ebab4df14457

Response

Field Name Type Description Example Value
status String Task status information.
completed boolean Whether completed.
imageUrls list Collection of image addresses.

Example

Request
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 ''
Response
{
  "status": "completed",
  "completed": true,
  "imageUrls": [
    "http://xxxx.png"
  ]
}