agentutility(7)$ man image-to-video
/image-to-video
PRICE / CALL
$0.50
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
synthforgeCATEGORY
uncategorized
STATUS
● live
NAME
image-to-video — animates a still image into video via fal.ai bytedance seedance
SYNOPSIS
POST https://x402.agentutility.ai/image-to-video
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Animates a still image into video via fal.ai Bytedance Seedance. Optional prompt steers the motion (camera moves, subject motion). Returns a hosted MP4 URL plus fal request id and seed. Use it for image-to-video, Seedance image-to-video, motion-from-photo, or camera movement on a photo.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| image_url | string | Public http(s) URL of the source image. fal.ai fetches it directly. | required |
| prompt | string | Optional motion description (e.g. 'camera slowly zooms in'). | optional |
| duration | string | Clip length. Default '5s'. | optional |
| resolution | string | Resolution. Default '720p'. | optional |
| model | string | Override the fal.ai model. Default 'fal-ai/bytedance/seedance/v1/pro/image-to-video'. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| video_url | string | Signed URL to the generated MP4 animated from the source image. |
| duration | string | Video length in seconds (e.g., "5s"). |
| aspect_ratio | string | Output aspect ratio inherited from the source image (e.g., "16:9", "9:16"). |
| resolution | string | Output video resolution (e.g., "720p"). |
| model | string | fal.ai model used, typically "fal-ai/bytedance/seedance/v1/pro/image-to-video". |
| prompt | string | Echo of the optional motion prompt that steered camera/subject movement. |
| fal_request_id | string | fal.ai upstream request ID for tracing this image-to-video render. |
| seed | number | Seed used by the fal.ai Seedance generation, when returned. |
| source | string | Origin tag for the render, typically "fal-ai". |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/image-to-video \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the image-to-video tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- synthforgevideo-generationimage-to-videoanimationseedancemotion-from-photo
- methods
- POST
- cluster
- synthforge
- price
- $0.50 USDC per call
ADJACENT — other endpoints in synthforge
| endpoint | description | price |
|---|---|---|
| seedance-video | Generates AI video with fal.ai Bytedance Seedance. | $0.50 |
| text-to-video | Generates video from a text prompt via fal.ai Bytedance Seedance. | $0.50 |
| gpt-image | Generates SFW images with Venice's gpt-image-2 model on a dedicated endpoint. | $0.30 |
| image-generate-ultra | Flagship text-to-image generation for top proprietary Venice models that fit a $0.22 retail price. | $0.22 |
| nano-banana | Generates SFW images with Venice's nano-banana-pro model on a dedicated endpoint. | $0.22 |
| ad-banner-image-expand | Expands existing images into wide, square, or portrait ad banner placements. | $0.15 |
| app-store-screenshot-expand | Expands mobile app screenshots into store, ad, and product-page layouts. | $0.15 |
| banner-image-expand | Turns existing photos into wide website, ad, and email-header canvases. | $0.15 |
SEE ALSO