Seedance 2.0 Mini Global
seedance-2.0-mini-global
Section titled “seedance-2.0-mini-global”POST /v1/videos
Served through the overseas route.
Supported parameters
Section titled “Supported parameters”Checked against the API request validator on November 7, 2026. The API model ID contains a dot (2.0); the page URL and download filename use hyphens.
| API field | Type | Required | Values / limit |
|---|---|---|---|
model | string | Yes | seedance-2.0-mini-global |
prompt | string | Yes | Nonempty; at most 12,000 characters |
seconds | integer | No | 4–15; default 5 |
metadata.resolution | string | No | 480p, 720p; default 720p |
metadata.ratio | string | No | 9:16, 16:9, 1:1, 21:9, 4:3, 3:4; default 16:9 |
metadata.media | array | No | {type, url} entries; up to 9 reference images and 3 reference videos; 4–15s total reference-video duration |
metadata.generate_audio | boolean | No | true generates audio; false requests silent output; set explicitly when needed |
metadata.watermark | boolean | No | Request or disable a watermark |
metadata.seed | integer | No | -1 through 2147483647 |
Image, video, and audio inputs
Section titled “Image, video, and audio inputs”Each metadata.media entry contains only type and url. Use reference_image for an image and reference_video for a video; these may be mixed in one array. Ordinary media uses public HTTPS URLs (JPEG/PNG/WebP images; MP4/MOV videos). Remove media for text-to-video.
For frame-guided generation, use one first_frame image and optionally one last_frame image. A last frame requires a first frame; frame entries cannot be mixed with reference images/videos. See the first/last-frame payload.
Reference audio is not supported. generate_audio controls generated sound; it does not accept an audio file. Do not send reference_audio, audio_url, or an audio URL as an image/video. Last-frame output (return_last_frame: true) is also unavailable.
Media containing real human faces must first be registered as an asset. Use the returned asset://… handle only after its status becomes Active; it replaces the url value. See asset registration.
Request example
Section titled “Request example”Replace example media URLs with your own publicly accessible files.
curl https://api.apimart.cc/v1/videos \ -H "Authorization: Bearer $HIPIX_API_KEY" \ -H "Content-Type: application/json" \ --data-raw '{"model": "seedance-2.0-mini-global", "prompt": "Animate the scene in @Image1 using the camera movement from @Video1", "seconds": 5, "metadata": {"resolution": "720p", "ratio": "16:9", "generate_audio": true, "media": [{"type": "reference_image", "url": "https://example.com/scene.jpg"}, {"type": "reference_video", "url": "https://example.com/clip.mp4"}]}}'Postman
Section titled “Postman”Download the Postman collection for seedance-2.0-mini-global. Set api_key, replace the example media URLs, and fill the task/asset path IDs from earlier responses. The five requests cover submission, polling/result retrieval, video download, asset registration, and asset status.
Results and pricing
Section titled “Results and pricing”Save the returned id and poll GET /v1/videos/{id}. On completed, url points to the HiPix content endpoint; you can also request /v1/videos/{id}/content. This response does not promise dimensions, duration, or a usage breakdown. Check usage logs for the actual charge.
Prices are per billing-equivalent second, not necessarily one second of output. Actual token usage, resolution, aspect ratio, reference video, and applicable minimum usage affect settlement. Reservation is an estimate, followed by a refund or additional charge. See Pricing & Billing, Polling, and Errors & Recovery.