Wan Spicy: Wan 2.7 I2V Spicy (Image to Video) API Reference

About

Image-to-video with WAN 2.7 Spicy. Animate a starting image with optional driving audio. 720p or 1080p, 2–15 second clips. Integrate this model via REST with endpoint docs, parameters, and code examples.

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/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "wan/wan2.7-i2v-spicy/image-to-video",
  "prompt": "A fictional adult turns naturally toward the camera and delivers a short greeting in a safe studio scene.",
  "image_urls": [
    "https://storage.googleapis.com/infron_gcs/image%2Fgenerated%2Fmulerouter_image_b4bf16cb8a6b44b39a33160595d77f38.png"
  ],
  "negative_prompt": "blurry, distorted face, extra limbs, unstable motion",
  "audio_url": "https://storage.googleapis.com/infron_gcs/image%2Faudio_v2%2Foutput%2Ff6c274b21ca3472c987e5f6383f3fa7b_fbd5c084.mp3",
  "generate_audio": true,
  "duration": "15",
  "resolution": "1080p",
  "enable_prompt_expansion": true,
  "enhance_prompt": true,
  "n": 1,
  "seed": 2147483647
}
EOF

Response with queue task id

The response will look like this:

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "09434c62fb1d4ebead4041744204b17b",
    "object": "video",
    "model": "wan/wan2.7-i2v-spicy/image-to-video",
    "status": "created",
    "urls": {
      "query": "https://media.onerouter.pro/v1/videos/tasks/09434c62fb1d4ebead4041744204b17b"
    },
    "created_at": "2026-07-15 06:42:30.94"
  }
}

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/videos/tasks/{task_id} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" 

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

Response with queue task status query

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "09434c62fb1d4ebead4041744204b17b",
    "object": "video",
    "model": "wan/wan2.7-i2v-spicy/image-to-video",
    "status": "in_progress",
    "fail_reason": "",
    "submit_time": 1784097751,
    "start_time": 1784097751,
    "finish_time": 0,
    "outputs": [],
    "created_at": "2026-07-15 06:42:31"
  }
}

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": "09434c62fb1d4ebead4041744204b17b",
    "object": "video",
    "model": "wan/wan2.7-i2v-spicy/image-to-video",
    "status": "completed",
    "fail_reason": "",
    "submit_time": 1784097751,
    "start_time": 1784097751,
    "finish_time": 1784097971,
    "outputs": [
      "https://storage.googleapis.com/infron_gcs/video%2Fvideo_v2%2Foutput%2Foutput_4dc2c563-c9b8-4592-b842-82e70d24a88b.mp4"
    ],
    "usage": {
      "completion_tokens": 0,
      "duration": 15,
      "generate_audio": true,
      "output_count": 1,
      "prompt_tokens": 1,
      "request_num": 1,
      "resolution": "1080p",
      "tokens": 1,
      "total_tokens": 1,
      "video_duration": 15
    },
    "cost": {
      "total_cost": 3,
      "cost_details": {
        "prompt_cost": 0,
        "completion_cost": 0,
        "image_cost": 0,
        "video_cost": 3,
        "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-15 06:42:31"
  }
}

2. Schema

Input

ParameterTypeRequiredDefaultRangeDescription
modelstringYes--Explore all modelsModel name.
promptstringYes----Text prompt for generation; Positive text prompt.
image_urlsarrayYes--[1]Use only image_urls[0]; supported image formats: JPEG/JPG/PNG (no transparency channel)/BMP/WEBP.
negative_promptstringNo----Negative prompts.
audio_urlstringNo----2–30 seconds, maximum 15m.
generate_audiobooleanNofalsetrue, falseWhether to generate audio.
durationintegerYes5[2, 15]Duration of the video in seconds, 2–15 seconds.
resolutionstringYes720p720p, 1080pResolution of the generated video.
enablepromptexpansionbooleanYestruetrue, falseWhether to enable prompt expansion.
enhance_promptbooleanNotruetrue, falseWhether to enhance the prompt.
nintegerNo1[1]Number of videos to generate.
seedintegerNo-->=1The random seed to use for the generation.

Example request

curl https://media.onerouter.pro/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "wan/wan2.7-i2v-spicy/image-to-video",
  "prompt": "A fictional adult turns naturally toward the camera and delivers a short greeting in a safe studio scene.",
  "image_urls": [
    "https://storage.googleapis.com/infron_gcs/image%2Fgenerated%2Fmulerouter_image_b4bf16cb8a6b44b39a33160595d77f38.png"
  ],
  "negative_prompt": "blurry, distorted face, extra limbs, unstable motion",
  "audio_url": "https://storage.googleapis.com/infron_gcs/image%2Faudio_v2%2Foutput%2Ff6c274b21ca3472c987e5f6383f3fa7b_fbd5c084.mp3",
  "generate_audio": true,
  "duration": "15",
  "resolution": "1080p",
  "enable_prompt_expansion": true,
  "enhance_prompt": true,
  "n": 1,
  "seed": 2147483647
}
EOF

Output

ParameterTypeRangeDescription
codeinteger--Status code of the request.
messagestring--Status message of the request.
dataobject--Data of the video task.
data.task_idstring--ID of the video task.
data.objectstring--Object type of the video task.
data.modelstring--Model name of the video task.
data.statusstringcreated, in_progress, processing, completed, failedStatus of the video task.
data.fail_reasonstring--Fail reason of the video task.
data.submit_timeinteger--Timestamp of the video task submission.
data.start_timeinteger--Timestamp of the video task start.
data.finish_timeinteger--Timestamp of the video task finish.
data.outputsarray--Outputs of the video task.
data.created_atstring--Timestamp of the video task creation.

Example output

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "09434c62fb1d4ebead4041744204b17b",
    "object": "video",
    "model": "wan/wan2.7-i2v-spicy/image-to-video",
    "status": "completed",
    "fail_reason": "",
    "submit_time": 1784097751,
    "start_time": 1784097751,
    "finish_time": 1784097971,
    "outputs": [
      "https://storage.googleapis.com/infron_gcs/video%2Fvideo_v2%2Foutput%2Foutput_4dc2c563-c9b8-4592-b842-82e70d24a88b.mp4"
    ],
    "usage": {
      "completion_tokens": 0,
      "duration": 15,
      "generate_audio": true,
      "output_count": 1,
      "prompt_tokens": 1,
      "request_num": 1,
      "resolution": "1080p",
      "tokens": 1,
      "total_tokens": 1,
      "video_duration": 15
    },
    "cost": {
      "total_cost": 3,
      "cost_details": {
        "prompt_cost": 0,
        "completion_cost": 0,
        "image_cost": 0,
        "video_cost": 3,
        "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-15 06:42:31"
  }
}

3. Detailed Pricing

Pricing TypeUnitPrice
Input text--
Input image--
Output video 720p1 second$0.130
Output video 1080p1 second$0.200
ResolutionSupported DurationEstimated Price
720p2–15 seconds$0.130 / second
1080p2–15 seconds$0.200 / second
ResolutionDurationEstimated Price
720p2 s$0.260
720p5 s$0.650
720p8 s$1.040
720p10 s$1.300
720p15 s$1.950
1080p2 s$0.400
1080p5 s$1.000
1080p8 s$1.600
1080p10 s$2.000
1080p15 s$3.000