{"uid":"cap_WDb1J3ifpYp4VrmLcphyQ","slug":"stablestudio-seedance-image-to-video-generation-147d8a99","name":"StableStudio Seedance Image-to-Video Generation","description":"Pay-per-generation AI image and video creation. No subscriptions ever.","url":"https://stablestudio.io/api/generate/seedance/i2v","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["keyframe","reference"],"type":"string","default":"keyframe","description":"Use keyframe image-to-video or reference-guided generation"},"urls":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":12,"minItems":1,"description":"Public image/video reference URLs"},"prompt":{"type":"string","maxLength":4000,"minLength":1,"description":"A detailed description of the video to generate"},"duration":{"enum":["4","5","6","7","8","9","10","11","12","13","14","15"],"type":"string","default":"5","description":"Duration of the video in seconds"},"audioUrls":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":3,"description":"Public audio reference URLs"},"resolution":{"enum":["720x720","720x960","960x720","1280x720","720x1280","1280x540"],"type":"string","description":"Optional exact pixel resolution override"},"aspectRatio":{"enum":["1:1","3:4","4:3","16:9","9:16","21:9"],"type":"string","default":"16:9","description":"Aspect ratio of the output video"},"callBackUrl":{"type":"string","format":"uri","description":"Optional Kinovi callback URL for API users"},"urlMediaTypes":{"type":"array","items":{"enum":["image","video"],"type":"string"},"maxItems":12,"description":"One media type per urls item, aligned by index. Include this for API clarity; Stable Studio also infers and persists it from URL content types before charging."},"outputResolution":{"enum":["480p","720p","1080p"],"type":"string","default":"720p","description":"Output quality tier"},"upscaleResolution":{"type":"string","const":"4k","description":"Upscale the generated video to 4K"}}},"responseSchema":{"type":"json","example":{"type":"seedance-i2v","jobId":"cmpbmzaee000j04jrzx4f43tw","status":"pending","pollUrl":"https://stablestudio.dev/api/jobs/cmpbmzaee000j04jrzx4f43tw","success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"20","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$20/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"20","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"20","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2U_vLUxxzGUiWgxcT-FKw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"20","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submits an image-to-video (i2v) generation job using the Seedance model, returning a job ID for async polling","exampleAgentPrompt":"Use StableStudio to animate my image into a video — the prompt is 'a serene ocean wave crashing on a rocky shore at sunset, cinematic motion', 16:9 aspect ratio, 1 MP resolution, webp output at quality 85, with safety tolerance 2.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a jobId (e.g. 'cmpbmzaee000j04jrzx4f43tw'), a status of 'pending', the generation type 'seedance-i2v', and a success boolean. The agent must use the jobId to poll for the completed video output separately.","failureModes":["Missing or empty prompt returns validation error","Invalid enum value for resolution or aspect_ratio returns 400","Safety tolerance out of range (below 1 or above 5) returns validation error","Insufficient USDC balance or failed x402 payment returns payment error","Seedance model backend unavailable returns 503 or timeout","Job creation succeeds but downstream generation fails — agent must handle pending/failed status on polling"],"whenToPreferThis":"Choose this endpoint when you need pay-per-use AI video generation from text/image prompts without committing to a subscription, specifically when using the Seedance i2v model via StableStudio. Prefer this over subscription-based services when generating videos occasionally or when crypto (USDC) micropayment via x402 is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:00.513Z","isFirstParty":false}