Jimeng Official Format Image Generation

curl --request POST \
  --url https://octopusx.ai/jm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "req_key": "<string>",
  "model": "<string>",
  "prompt": "<string>",
  "resolution": "<string>",
  "size": 123,
  "force_single": true,
  "image_urls": [
    {}
  ],
  "width": 123,
  "height": 123
}
'

{
  "code": 10000,
  "data": {
    "task_id": "67fb9e82-126e-4c71-bb16-a3bb3789e3b7",
    "status": "submitted"
  },
  "message": "Success",
  "request_id": "67fb9e82-126e-4c71-bb16-a3bb3789e3b7",
  "status": 10000,
  "time_elapsed": "35.381µs"
}

POST

https://octopusx.ai

Jimeng Official Format Image Generation

curl --request POST \
  --url https://octopusx.ai/jm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "req_key": "<string>",
  "model": "<string>",
  "prompt": "<string>",
  "resolution": "<string>",
  "size": 123,
  "force_single": true,
  "image_urls": [
    {}
  ],
  "width": 123,
  "height": 123
}
'

{
  "code": 10000,
  "data": {
    "task_id": "67fb9e82-126e-4c71-bb16-a3bb3789e3b7",
    "status": "submitted"
  },
  "message": "Success",
  "request_id": "67fb9e82-126e-4c71-bb16-a3bb3789e3b7",
  "status": 10000,
  "time_elapsed": "35.381µs"
}

Jimeng Official Format Image Generation

An image generation API in Jimeng’s official format, submitted in JSON and requiring query parameters.

The routing entry is POST /jm.
The Action and Version query parameters must be included in the URL.
Currently submitted using application/json.
Supports text-to-image, image-to-image, and other scenarios.
After successful submission, a task task_id is returned. Use Query Task to fetch the result later.

Supported Models

jimeng-4.0: Jimeng 4.0 model

Method and Path

POST /jm?Action=CVSync2AsyncSubmitTask&Version=2022-08-31

Request Example

curl -X POST "https://octopusx.ai/jm?Action=CVSync2AsyncSubmitTask&Version=2022-08-31" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "req_key": "jimeng_t2i_v40",
    "model": "jimeng-4.0",
    "prompt": "The sunset glow illuminates the lake, with delicate oil painting texture",
    "force_single": true,
    "image_urls": [],
    "width": 1024,
    "height": 1024
  }'

Example with Reference Images

curl -X POST "https://octopusx.ai/jm?Action=CVSync2AsyncSubmitTask&Version=2022-08-31" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "req_key": "jimeng_t2i_v40",
    "model": "jimeng-4.0",
    "prompt": "Generate an artistic style based on the reference images",
    "force_single": true,
    "image_urls": [
      "https://example.com/reference1.png",
      "https://example.com/reference2.png"
    ],
    "resolution": "2k"
  }'

Response Example

{
  "code": 10000,
  "data": {
    "task_id": "67fb9e82-126e-4c71-bb16-a3bb3789e3b7",
    "status": "submitted"
  },
  "message": "Success",
  "request_id": "67fb9e82-126e-4c71-bb16-a3bb3789e3b7",
  "status": 10000,
  "time_elapsed": "35.381µs"
}

Authentication

Authorization: Bearer YOUR_API_KEY

Query Parameters

Action

string

Operation type. Fixed value: CVSync2AsyncSubmitTask (submit task).

Version

string

API version. Fixed value: 2022-08-31.

Body

req_key

string

required

Service identifier. Fixed value: jimeng_t2i_v40.

model

string

required

Model name. For example, jimeng-4.0.

prompt

string

required

The prompt used to generate the image. Both Chinese and English are supported. It is recommended to keep it within 800 characters at most; overly long prompts may cause generation anomalies or fail to take effect. You can directly specify the image generation ratio in the prompt.

resolution

string

Resolution. Optional values: 1k, 2k, 4k.

size

integer

The image area to generate (deprecated). Default: 4194304, which is 20482048, generating a 2K resolution image. Range: [10241024, 4096*4096], capable of generating 1K to 4K resolution images.

force_single

boolean

Whether to force generation of a single image. Default: false.

image_urls

array

Image file URLs. Supports 0 to 10 images for image-to-image scenarios.

width

integer

Image width. Recommended values: 1024 (1K), 2048 (2K), 4096 (4K), etc.

height

integer

Image height. Recommended values: 1024 (1K), 2048 (2K), 4096 (4K), etc.

Response

code

integer

Status code. 10000 indicates success.

data

object

Response data container.

data.task_id

string

Task ID. Used to query task status and results later.

data.status

string

Task status.

message

string

Status message.

request_id

string

Request ID.

status

integer

Status code.

time_elapsed

string

Request duration.

Recommended Sizes

1K Resolution

Width x Height	Ratio
1024x1024	1:1

2K Resolution

Width x Height	Ratio
2048x2048	1:1
2304x1728	4:3
2496x1664	3:2
2560x1440	16:9
3024x1296	21:9

4K Resolution

Width x Height	Ratio
4096x4096	1:1
4694x3520	4:3
4992x3328	3:2
5404x3040	16:9
6198x2656	21:9

Jimeng Image Editing Jimeng Official Format Query Task

​Jimeng Official Format Image Generation

​Supported Models

​Method and Path

​Request Example

​Example with Reference Images

​Response Example

​Authentication

​Query Parameters

​Body

​Response

​Recommended Sizes

​1K Resolution

​2K Resolution

​4K Resolution

​Related APIs

Jimeng Official Format Image Generation

Supported Models

Method and Path

Request Example

Example with Reference Images

Response Example

Authentication

Query Parameters

Body

Response

Recommended Sizes

1K Resolution

2K Resolution

4K Resolution

Related APIs