Use RunComfy's API to run wan-ai/wan-2-6/image-to-video. For accepted inputs and outputs, see the model's schema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/wan-ai/wan-2-6/image-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Overall Description: This video captures the serene and powerful movement of a shark swimming in the open ocean. The visual style is cinematic and documentary-like, emphasizing the clarity of the blue water and the dramatic interplay of sunlight piercing through the surface (God rays). The atmosphere is tense yet majestic.\nShot 1 [0-4 seconds]: A wide, side-profile tracking shot follows the shark gliding effortlessly through the deep blue water. Sunlight filters down from the surface, creating dancing patterns of light on shark's grey skin. The water is crystal clear, with bubbles trailing slightly behind.\nShot 2 [4-7 seconds]: The camera angles up towards the surface (low angle shot). The shark swims directly overhead, its silhouette dark and distinct against the bright, shimmering surface of the water and the sun's glare.\nShot 3 [7-10 seconds]: A close-up shot focuses on shark's face and gills. The shark turns slightly towards the camera, revealing a piercing gaze, before propelling itself forward with a strong tail movement, disappearing into the deep blue gloom of the ocean.",
"img_url": "https://playgrounds-storage-public.runcomfy.net/tools/7276/media-files/input-1-1.png"
}'Set the YOUR_API_TOKEN environment variable with your API key (manage keys in your Profile) and include it on every request as a Bearer token via the Authorization header: Authorization: Bearer $YOUR_API_TOKEN.
Submit an asynchronous generation job and immediately receive a request_id plus URLs to check status, fetch results, and cancel.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/wan-ai/wan-2-6/image-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Overall Description: This video captures the serene and powerful movement of a shark swimming in the open ocean. The visual style is cinematic and documentary-like, emphasizing the clarity of the blue water and the dramatic interplay of sunlight piercing through the surface (God rays). The atmosphere is tense yet majestic.\nShot 1 [0-4 seconds]: A wide, side-profile tracking shot follows the shark gliding effortlessly through the deep blue water. Sunlight filters down from the surface, creating dancing patterns of light on shark's grey skin. The water is crystal clear, with bubbles trailing slightly behind.\nShot 2 [4-7 seconds]: The camera angles up towards the surface (low angle shot). The shark swims directly overhead, its silhouette dark and distinct against the bright, shimmering surface of the water and the sun's glare.\nShot 3 [7-10 seconds]: A close-up shot focuses on shark's face and gills. The shark turns slightly towards the camera, revealing a piercing gaze, before propelling itself forward with a strong tail movement, disappearing into the deep blue gloom of the ocean.",
"img_url": "https://playgrounds-storage-public.runcomfy.net/tools/7276/media-files/input-1-1.png"
}'Fetch the current state for a request_id ("in_queue", "in_progress", "completed", or "cancelled").
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Retrieve the final outputs and metadata for the given request_id; if the job is not complete, the response returns the current state so you can continue polling.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Cancel a queued job by request_id, in-progress jobs cannot be cancelled.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"Provide a publicly reachable HTTPS URL. Ensure the host allows server‑side fetches (no login/cookies required) and isn't rate‑limited or blocking bots. Recommended limits: images ≤ 50 MB (~4K), videos ≤ 100 MB (~2–5 min @ 720p). Prefer stable or pre‑signed URLs for private assets.
{
"type": "object",
"title": "Input",
"required": [
"prompt",
"img_url"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "Length should be less than 1500 characters.",
"type": "string",
"default": "Overall Description: This video captures the serene and powerful movement of a shark swimming in the open ocean. The visual style is cinematic and documentary-like, emphasizing the clarity of the blue water and the dramatic interplay of sunlight piercing through the surface (God rays). The atmosphere is tense yet majestic.\nShot 1 [0-4 seconds]: A wide, side-profile tracking shot follows the shark gliding effortlessly through the deep blue water. Sunlight filters down from the surface, creating dancing patterns of light on shark's grey skin. The water is crystal clear, with bubbles trailing slightly behind.\nShot 2 [4-7 seconds]: The camera angles up towards the surface (low angle shot). The shark swims directly overhead, its silhouette dark and distinct against the bright, shimmering surface of the water and the sun's glare.\nShot 3 [7-10 seconds]: A close-up shot focuses on shark's face and gills. The shark turns slightly towards the camera, revealing a piercing gaze, before propelling itself forward with a strong tail movement, disappearing into the deep blue gloom of the ocean."
},
"audio_url": {
"title": "Audio",
"description": "Audio format must be: wav, mp3. The duration of this audio must be between 3s and 30s. File size should be less than 15 MB.",
"type": "string"
},
"duration": {
"title": "Duration",
"description": "",
"type": "integer",
"enum": [
5,
10,
15
],
"default": 5
},
"img_url": {
"title": "Image",
"description": "Image format must be: jpg, jpeg, png, bmp, webp. File size should be less than 10 MB.",
"type": "string",
"validations": [
{
"validation_rule": "width_pixels>",
"validation_value": 360,
"validation_error": "The uploaded image width and height must exceed 360 pixels."
},
{
"validation_rule": "height_pixels>",
"validation_value": 360,
"validation_error": "The uploaded image width and height must exceed 360 pixels."
},
{
"validation_rule": "width_pixels<",
"validation_value": 2000,
"validation_error": "The uploaded image width and height must not exceed 2000 pixels."
},
{
"validation_rule": "height_pixels<",
"validation_value": 2000,
"validation_error": "The uploaded image width and height must not exceed 2000 pixels."
}
],
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7276/media-files/input-1-1.png"
},
"resolution": {
"title": "Resolution",
"description": "",
"type": "string",
"enum": [
"720P",
"1080P"
],
"default": "720P"
},
"shot_type": {
"title": "Shot Type",
"description": "Shot Type",
"type": "string",
"enum": [
"multi",
"single"
],
"default": "multi"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "",
"type": "string"
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "single image URL"
},
"video": {
"type": "string",
"format": "uri",
"description": "single video URL"
},
"images": {
"type": "array",
"description": "multiple image URLs",
"items": { "type": "string", "format": "uri" }
},
"videos": {
"type": "array",
"description": "multiple video URLs",
"items": { "type": "string", "format": "uri" }
}
}
}
}RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Playground, enabling artists to harness the latest AI tools to create incredible art.