{
  "info": {
    "_postman_id": "cb365f8a-05e4-52a6-9892-78c955d12711",
    "name": "HiPix Seedance 2.5 (seedance-2.5)",
    "description": "HiPix API requests for model `seedance-2.5`. Set `api_key`, replace example media URLs, and replace task/asset path IDs with values from earlier responses. This collection ships without credentials. Images and videos are supported; reference audio is not supported. `metadata.generate_audio` controls generated sound, not audio input. Docs: https://docs.apimart.cc/models/seedance/seedance-2-5/",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://api.apimart.cc"
    },
    {
      "key": "api_key",
      "value": "",
      "description": "Paste your HiPix API key here (create one at https://apimart.cc)"
    }
  ],
  "item": [
    {
      "name": "Create video",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/v1/videos",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "videos"
          ]
        },
        "description": "Submit a generation task and save the returned `id`. Replace the example media URLs before sending; do not automatically repeat an uncertain POST.\n\n- `model` and nonempty `prompt` (at most 12000 characters) are required.\n- `seconds`: optional integer 4-30, default 5.\n- `metadata.resolution`: 480p, 720p, 1080p; default 720p.\n- `metadata.ratio`: 9:16, 16:9, 1:1, 21:9, 4:3, 3:4; default 16:9.\n- `metadata.media`: optional `{type, url}` entries. Up to 30 reference images and 10 reference videos, with 4-30s total video duration. Mix `reference_image` and `reference_video`, using public HTTPS URLs or Active registered asset handles. Real human faces require asset registration.\n- Alternatively use one `first_frame` image and optionally one `last_frame` image. A last frame requires a first frame; do not mix frame entries with other references.\n- `metadata.generate_audio`: boolean for generated sound. Reference audio and `return_last_frame: true` are not supported.\n- Optional `metadata.watermark`: boolean; `metadata.seed`: integer -1 through 2147483647.\n- Remove `metadata.media` for text-to-video. The reservation is an estimate; final billing uses measured usage.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"model\": \"seedance-2.5\",\n  \"prompt\": \"Animate the scene in @Image1 using the camera movement from @Video1\",\n  \"seconds\": 5,\n  \"metadata\": {\n    \"resolution\": \"720p\",\n    \"ratio\": \"16:9\",\n    \"generate_audio\": true,\n    \"media\": [\n      {\n        \"type\": \"reference_image\",\n        \"url\": \"https://example.com/scene.jpg\"\n      },\n      {\n        \"type\": \"reference_video\",\n        \"url\": \"https://example.com/clip.mp4\"\n      }\n    ]\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "Poll task / Get result",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/v1/videos/:id",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "videos",
            ":id"
          ]
        },
        "description": "Replace `:id` with the id returned by Create video. Poll this same task while status is queued or in_progress. On completed, `url` points to the HiPix content endpoint; use Download video content to retrieve the file. The response does not guarantee dimensions, duration, or a usage breakdown; use account usage logs for charges. Stop on failed or unknown and consult Errors & Recovery instead of automatically submitting another paid task."
      }
    },
    {
      "name": "Download video content",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/v1/videos/:id/content",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "videos",
            ":id",
            "content"
          ]
        },
        "description": "Replace `:id` with a completed task id."
      }
    },
    {
      "name": "Register real-person asset",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/v1/media/assets",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "media",
            "assets"
          ]
        },
        "description": "Only needed when reference media contains real human faces. `asset_type` is `Image` or `Video`; `url` must be a public URL the provider can fetch itself. The response returns `data.ref` (`asset://mva-...`). Poll the Asset status request until `data.status` is `Active`, then use the ref value inside `metadata.media` entries.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"model\": \"seedance-2.5\",\n  \"url\": \"https://example.com/real-person-clip.mp4\",\n  \"asset_type\": \"Video\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "Asset status",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/v1/media/assets/:provider_id/status?model=seedance-2.5",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "media",
            "assets",
            ":provider_id",
            "status"
          ],
          "query": [
            {
              "key": "model",
              "value": "seedance-2.5"
            }
          ]
        },
        "description": "Replace `:provider_id` with the `provider_id` returned by registration."
      }
    }
  ]
}