Seedance image-to-video generation via micropayments — up to 1080p, 4–12s clips, $0.33–$0.99 per generation.
What it does
This endpoint animates a static image into a video clip using the Seedance model, accessed through StableStudio's pay-per-generation API. It accepts a source image URL (uploaded via StableStudio's file upload flow), a text prompt describing the desired motion, and optional parameters for duration (4–12 seconds), resolution (480p/720p/1080p), aspect ratio, audio generation, camera lock, and seed. An optional `last_image` field enables interpolation between two frames.
Payment is handled via the MPP protocol (Tempo method, one-shot charge) or x402, settling in USDC on Base (EIP-155:8453). The dynamic price ranges from $0.33 to $0.99 depending on resolution and duration. No API keys are needed — callers POST to the endpoint, receive a 402 payment challenge, sign a USDC authorization, and resubmit with a `PAYMENT-SIGNATURE` header. The response returns a `jobId` with status "pending"; callers then poll `GET /api/jobs/{jobId}` (authenticated via SIGN-IN-WITH-X wallet signature) every 10 seconds until the job completes (~1 minute typical). Completed jobs return a `videoUrl` and `thumbnailUrl`.
The endpoint is POST-only, which is why HEAD/GET probes returned 405 — this is expected behavior, not a sign the endpoint is down. StableStudio provides a full OpenAPI 3.1 spec with detailed input schemas, and also offers a faster variant at `/api/generate/seedance-fast/i2v` ($0.04–$0.12, ~40s) for lower-cost generation.
Capabilities
Use cases
- —Animate product photos into short promotional video clips
- —Generate social media video content from a single hero image
- —Create animated storyboard sequences from concept art frames
- —Produce video transitions by interpolating between two keyframes using last_image
- —Build automated video pipelines where agents pay per generation without subscriptions
Fit
Best for
- —Agents or apps needing on-demand image-to-video without API key management
- —Pay-per-use video generation with crypto micropayments
- —Generating 4–12 second clips at up to 1080p from a source image
- —Developers integrating via x402 or MPP payment protocols
Not for
- —Long-form video generation (max 12 seconds per clip)
- —Users who need free or subscription-based access without crypto wallets
- —Real-time or streaming video generation (jobs take ~1 minute)
Quick start
# 1. POST without payment to get 402 challenge
curl -X POST https://stablestudio.dev/api/generate/seedance/i2v \
-H 'Content-Type: application/json' \
-d '{"prompt": "A cat slowly turning its head", "image": "https://your-blob-url.vercel-storage.com/cat.png", "duration": "5", "resolution": "720p"}'
# Returns 402 with PAYMENT-REQUIRED header
# 2. Sign USDC payment, re-POST with PAYMENT-SIGNATURE header
# 3. Poll GET /api/jobs/{jobId} with SIGN-IN-WITH-X headerExample
Request
{
"image": "https://example.blob.vercel-storage.com/uploads/abc/cat.png",
"prompt": "A cat slowly turning its head and blinking",
"duration": "5",
"resolution": "720p",
"aspect_ratio": "16:9",
"camera_fixed": false,
"generate_audio": false
}Response
{
"type": "seedance-i2v",
"jobId": "job_abc123def456",
"status": "pending",
"success": true
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed input/output definitions, clear pricing documentation, and comprehensive guidance text. The endpoint returned 405 on HEAD/GET probes (expected for POST-only), so live 402 challenge was not directly captured, but the OpenAPI spec and agents.txt confirm the payment flow. Slight deduction for no direct 402 capture on this specific endpoint.
Warnings
- —HEAD/GET probes returned 405 — endpoint is POST-only; no direct 402 challenge was captured for this specific route, but the OpenAPI spec confirms the payment flow
- —Images must be uploaded via StableStudio's 3-step file upload flow ($0.01) before use in i2v requests
- —last_image interpolation feature is documented but behavior details are sparse
Citations
- —Seedance i2v costs $0.33–$0.99 per generation and takes ~1 minutehttps://stablestudio.dev
- —Endpoint accepts POST with prompt, image, duration (4-12s), resolution (480p/720p/1080p), aspect_ratio, generate_audio, camera_fixed, seed, and optional last_imagehttps://stablestudio.dev
- —Payment settles in USDC on Base (EIP-155:8453) via x402 or MPP Tempo methodhttps://stablestudio.dev
- —Seedance-fast variant available at $0.04–$0.12 with ~40s generation timehttps://stablestudio.dev
- —File upload requires 3-step flow costing $0.01 to obtain a blobUrlhttps://stablestudio.dev
- —Job polling uses SIGN-IN-WITH-X wallet signature authentication; videos return videoUrl and thumbnailUrlhttps://stablestudio.dev