Postman Collections

Overview

The eight Seedance models listed below have ready-to-import Postman collections: submit a generation, poll the task and retrieve its result, download the finished file, and register or check real-person reference assets.

Collections use two variables so they ship without any credentials:

Variable	Value	Purpose
base_url	https://api.apimart.cc	HiPix API endpoint
api_key	(empty — fill in)	Your own API key, sent as Authorization: Bearer {{api_key}}

Keep your key secret

Set api_key in the collection variables after importing. Never commit a collection with a real key, and never share an exported collection that contains one.

Import into Postman

1. Download a collection below or from its Seedance model page.
2. In Postman: Import → File → select the downloaded .json.
3. Open the collection → Variables tab → paste your API key into api_key.
4. Replace the example image/video URLs with your own files. For text-to-video, remove metadata.media. Register real-person reference media first and wait for Active before using its handle.
5. Send Create video once and save the returned id. Replace :id in the polling and download request URLs with this value.
6. Run Poll task / Get result while status is queued or in_progress. On completed, use Download video content. Stop on failed or unknown; an uncertain submission must not be automatically repeated.
7. For Asset status, replace :provider_id with the registration response’s data.provider_id and keep the same model query parameter. Stop if the asset is Failed; use data.ref only after it is Active.

metadata.media contains {type, url} entries for reference images/videos or first/last frames. metadata.generate_audio controls generated sound; reference audio is not supported. See Seedance payload examples.

Available collections

Model	Collection
Seedance 2.0	seedance-2-0.json
Seedance 2.0 Fast	seedance-2-0-fast.json
Seedance 2.0 Mini	seedance-2-0-mini.json
Seedance 2.5	seedance-2-5.json
Seedance 2.0 Global	seedance-2-0-global.json
Seedance 2.0 Fast Global	seedance-2-0-fast-global.json
Seedance 2.0 Mini Global	seedance-2-0-mini-global.json
Seedance 2.5 Global	seedance-2-5-global.json

Each collection’s requests carry inline notes about field limits for that exact model. Each listed model page links its collection next to the request example. API model IDs use a dot (seedance-2.5), while filenames and page URLs use hyphens (seedance-2-5).

More models

Collections for additional models follow the same pattern. If a model you use is not listed, its parameters and request example are still documented on the model page.

What’s inside

• Create video — POST /v1/videos with a ready-to-edit JSON body
• Poll task / Get result — GET /v1/videos/:id; returns status and, once completed, a HiPix content url. Dimensions, duration, and a usage breakdown are not guaranteed fields; check usage logs for charges
• Download video content — GET /v1/videos/:id/content
• Register real-person asset — POST /v1/media/assets (only needed when reference media contains real human faces)
• Asset status — GET /v1/media/assets/:provider_id/status

See Submit a Task and Poll Results for the full API contract.