Alibaba: Wan 2.7 Image Pro (Image to Image) API Reference

About

Wan2.7–image-pro，supports text to image, text/image to sequential images, image editing, multi-image reference generation, and interactive editing. Delivers enhanced performance in text rendering, subject consistency, and complex instruction following.

1. Calling the API

Setup your API Key

To begin using Infron, you first need to create an account and generate your API Key.

Once you have your API key, set it as an environment variable in your runtime environment. This allows your applications to securely access Infron’s API.

export INFRON_KEY="YOUR_API_KEY"

Submit a request

For long-running requests, you can poll for results.

curl https://media.onerouter.pro/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
    "model": "wan/wan2.7/pro/image-to-image",
    "prompt": "Turn image 1 into a pencil drawing.",
    "image_urls": [
        "https://storage.googleapis.com/infron_gcs/quick-upload/2026/07/14/20260714-001511-07902907-dragon-warrior.jpg"
    ],
    "bbox_list": [
        [
            [10, 10, 80, 80]
        ]
    ],
    "size": "2976*1408",
    "watermark": false,
    "sequential_image_generation": "auto",
    "output_format": "png",
    "response_format": "url",
    "n": 1,
    "seed": 214748364
}
EOF

Response with queue task id

The response will look like this:

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20260729060241798539305sHOrPZ0Y",
    "object": "image",
    "model": "wan/wan2.7/pro/image-to-image",
    "status": "created",
    "urls": {
      "query": "https://media.onerouter.pro/v1/images/tasks/20260729060241798539305sHOrPZ0Y"
    },
    "created_at": "2026-07-29 06:02:41.85"
  }
}

Fetch request status

You can fetch the status of a request to check if it is completed or still in progress.

curl https://media.onerouter.pro/v1/images/tasks/{task_id} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" 

# For example
curl https://media.onerouter.pro/v1/images/tasks/20260729060241798539305sHOrPZ0Y \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response with queue task status query

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20260729060241798539305sHOrPZ0Y",
    "object": "image",
    "model": "wan/wan2.7/pro/image-to-image",
    "status": "in_progress",
    "fail_reason": "",
    "submit_time": 1785304962,
    "start_time": 1785304961,
    "finish_time": 0,
    "outputs": [],
    "created_at": "2026-07-29 06:02:42"
  }
}

Possible statuses:

created
in_progress
processing
completed
failed

created -> in_progress → processing → completed | failed

Poll every 1-2 seconds until status is "completed" or "failed"

Get the result (when status is "completed")

Once the request is completed, you can fetch the result. See the Output Schema for the expected result format.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20260729060241798539305sHOrPZ0Y",
    "object": "image",
    "model": "wan/wan2.7/pro/image-to-image",
    "status": "completed",
    "fail_reason": "",
    "submit_time": 1785304962,
    "start_time": 1785304961,
    "finish_time": 1785304996,
    "outputs": [
      "https://infron.ai/cdn/media/image/generated/official_alibaba_image_6e51189f464b4f3d8952ff4c24e34811.png"
    ],
    "usage": {
      "completion_tokens": 2,
      "image_count": 1,
      "image_quality": "",
      "prompt_tokens": 18734,
      "resolution": "2976*1408",
      "total_tokens": 18736,
      "web_search": false
    },
    "cost": {
      "total_cost": 0.06,
      "cost_details": {
        "prompt_cost": 0,
        "completion_cost": 0,
        "image_cost": 0.06,
        "video_cost": 0,
        "audio_cost": 0,
        "native_web_search_cost": 0,
        "plugin_web_search_cost": 0,
        "tools_cost": 0,
        "prompt_cache_read_cost": 0,
        "prompt_cache_write_cost": 0,
        "prompt_cache_write_5_min": 0,
        "prompt_cache_write_1_h": 0,
        "reasoning_cost": 0,
        "discount_rate": 1,
        "is_byok": false,
        "byok_cost": 0
      }
    },
    "created_at": "2026-07-29 06:02:42"
  }
}

2. Schema

Input

Parameter	Type	Required	Default	Range	Description
model	string	Yes	--	Explore all models	Model name.
prompt	string	Yes	--	--	Text prompt for generation; Positive text prompt.
image_urls	array	Yes	`[]`	[1,9]	Image URLs for generation.
bbox_list	array<array<box>>	No	`[]`	[1,9]	The number of sets must match that of `image_urls`; `box=[x1, y1, x2, y2]`, where coordinates are non-negative and `x2 > x1`, `y2 > y1`.
size	string	No	`1K`	`1K`, `2K`, `WIDTH * HEIGHT`	The size of the generated image in pixels (widthheight). Range: 512-4096 per dimension. Total pixels must be between 768768 and 2048*2048. Aspect ratio must be between 1:8 and 8:1.
watermark	boolean	No	`false`	`true`, `false`	Whether to add watermark to the image.
sequentialimagegeneration	string	No	`disabled`	`disabled`, `auto`	Defaults to `disabled`; `auto` indicates a group of images and cannot be used simultaneously with `color_palette`.
color_palette	array<object>	No	`[]`	--	Each item must include `hex` and `ratio`; the sum of the ratios must be 100%; cannot be used simultaneously with `sequential_image_generation=auto`.
output_format	string	No	`png`	`png`	Output format of the image.
response_format	string	No	`url`	`url`	Response format of the image, default is url.
n	integer	No	`1`	[1]	Number of videos to generate.
seed	integer	No	--	>=1	The random seed to use for the generation.

Example request

curl https://media.onerouter.pro/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
    "model": "wan/wan2.7/pro/image-to-image",
    "prompt": "Turn image 1 into a pencil drawing.",
    "image_urls": [
        "https://storage.googleapis.com/infron_gcs/quick-upload/2026/07/14/20260714-001511-07902907-dragon-warrior.jpg"
    ],
    "bbox_list": [
        [
            [10, 10, 80, 80]
        ]
    ],
    "size": "2976*1408",
    "watermark": false,
    "sequential_image_generation": "auto",
    "output_format": "png",
    "response_format": "url",
    "n": 1,
    "seed": 214748364
}
EOF

Output

Parameter	Type	Range	Description
code	integer	--	Status code of the request.
message	string	--	Status message of the request.
data	object	--	Data of the task.
data.task_id	string	--	ID of the task.
data.object	string	--	Object type of the task.
data.model	string	--	Model name of the task.
data.status	string	`created`, `in_progress`, `processing`, `completed`, `failed`	Status of the task.
data.fail_reason	string	--	Fail reason of the task.
data.submit_time	integer	--	Timestamp of the task submission.
data.start_time	integer	--	Timestamp of the task start.
data.finish_time	integer	--	Timestamp of the task finish.
data.outputs	array	--	Outputs of the task.
data.created_at	string	--	Timestamp of the task creation.

Example output

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "20260729060241798539305sHOrPZ0Y",
    "object": "image",
    "model": "wan/wan2.7/pro/image-to-image",
    "status": "completed",
    "fail_reason": "",
    "submit_time": 1785304962,
    "start_time": 1785304961,
    "finish_time": 1785304996,
    "outputs": [
      "https://infron.ai/cdn/media/image/generated/official_alibaba_image_6e51189f464b4f3d8952ff4c24e34811.png"
    ],
    "usage": {
      "completion_tokens": 2,
      "image_count": 1,
      "image_quality": "",
      "prompt_tokens": 18734,
      "resolution": "2976*1408",
      "total_tokens": 18736,
      "web_search": false
    },
    "cost": {
      "total_cost": 0.06,
      "cost_details": {
        "prompt_cost": 0,
        "completion_cost": 0,
        "image_cost": 0.06,
        "video_cost": 0,
        "audio_cost": 0,
        "native_web_search_cost": 0,
        "plugin_web_search_cost": 0,
        "tools_cost": 0,
        "prompt_cache_read_cost": 0,
        "prompt_cache_write_cost": 0,
        "prompt_cache_write_5_min": 0,
        "prompt_cache_write_1_h": 0,
        "reasoning_cost": 0,
        "discount_rate": 1,
        "is_byok": false,
        "byok_cost": 0
      }
    },
    "created_at": "2026-07-29 06:02:42"
  }
}

3. Detailed Pricing

Pricing Type	Unit	Price
Input text	-	-
Input image	-	-
Output image	1 image	$0.075