PixMind Docs
API ReferenceVideo ModelsSeedance 2.0 Pro Video Generation

Seedance 2.0 Pro Video Generation

Multi-reference video generation with coordinated characters, scenes, and motion through the PixMind API.

Multi-reference video generation with coordinated characters, scenes, motion, and optional audio.

Provider

ByteDance

Model ID

seedance-2.0-pro

Endpoint

POST /api-platform/v1/generations
Open model playgroundCreate API key

Authentication

Base URL: https://aihub-admin.aimix.pro. Send Authorization: Bearer <PIXMIND_API_KEY> on both creation and polling requests, and Content-Type: application/json when submitting JSON. Keep your key in a server environment variable.

Model notes

  • Reference video uploads support MP4 or MOV, 2-15 seconds each, up to three videos and 15 seconds total.
  • Reference mode currently accepts 480p or 720p source videos.

Request parameters

ParameterTypeRequiredDescription
modelstringYes

Stable PixMind model ID. Use `seedance-2.0-pro`.

Allowed values: seedance-2.0-pro

promptstringYes

Natural-language generation or editing instructions.

resolutionstringNo

Output video resolution.

Allowed values: 480p, 720p, 1080p, 4K

Default: 720p

durationintegerNo

Requested clip duration in seconds.

Allowed values: 5, 10, 15

Default: 5

aspectRatiostringNo

Requested output aspect ratio.

Allowed values: 16:9, 9:16, 1:1, 4:3, 3:4

Default: 16:9

imageUrlstring (URI)No

Starting image for image-to-video generation.

referenceImagesstring[] (URI)No

Reference image URLs used for editing, composition, subject, or style guidance.

reference_videosstring[] (URI)No

Reference video URLs for character, scene, or motion guidance.

generateAudiobooleanNo

Generate synchronized audio when supported by the selected mode.

Allowed values: true, false

Default: true

enable_web_searchbooleanNo

Allow supported modes to use web context during prompt interpretation.

Allowed values: true, false

Default: false

Request example

cURL
curl --request POST 'https://aihub-admin.aimix.pro/api-platform/v1/generations' \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.0-pro",
  "prompt": "Keep the character and product consistent across a three-shot commercial sequence",
  "duration": 10,
  "resolution": "720p",
  "aspectRatio": "16:9",
  "referenceImages": [
    "https://example.com/character.jpg",
    "https://example.com/product.jpg"
  ],
  "generateAudio": true
}'
JavaScript
// Node.js 20+. Keep the API key on your server.
const apiKey = process.env.PIXMIND_API_KEY;
if (!apiKey) throw new Error("PIXMIND_API_KEY is required");

const response = await fetch("https://aihub-admin.aimix.pro/api-platform/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "seedance-2.0-pro",
  "prompt": "Keep the character and product consistent across a three-shot commercial sequence",
  "duration": 10,
  "resolution": "720p",
  "aspectRatio": "16:9",
  "referenceImages": [
    "https://example.com/character.jpg",
    "https://example.com/product.jpg"
  ],
  "generateAudio": true
}),
  signal: AbortSignal.timeout(30_000)
});

const task = await response.json();
if (!response.ok || task.code !== 1000) {
  throw new Error(task.message ?? task.error?.message ?? `HTTP ${response.status}`);
}
console.log(task);

Accepted task response

Generation is asynchronous. Save taskId and poll GET /api-platform/v1/tasks/{taskId} until status is ready or failed.

200 OK
{
  "code": 1000,
  "data": {
    "id": "vid_44160",
    "taskId": 44160,
    "type": "video",
    "model": "seedance-2.0-pro",
    "status": "processing"
  }
}

Query the task and retrieve results

Replace 44160 with data.taskId from the accepted response, using a key belonging to the same user. pending and processing are non-terminal; ready and failed are terminal. On ready, read images (images) or videoUrl (videos); on failed, read errorMessage. The example stops after 60 queries. If it times out, save taskId and query again later instead of creating a duplicate task. Example result URLs are placeholders.

cURL
curl 'https://aihub-admin.aimix.pro/api-platform/v1/tasks/44160' \
  -H "Authorization: Bearer $PIXMIND_API_KEY"
JavaScript
// Continue after the request example above.
const taskId = task.data?.taskId;
if (!Number.isInteger(taskId)) throw new Error("Missing numeric taskId");

async function waitForTask(taskId) {
  for (let attempt = 0; attempt < 60; attempt++) {
    await new Promise(resolve => setTimeout(resolve, Math.min(2000 * 1.5 ** attempt, 10000)));
    const response = await fetch(`https://aihub-admin.aimix.pro/api-platform/v1/tasks/${taskId}`, {
      headers: { Authorization: `Bearer ${apiKey}` },
      signal: AbortSignal.timeout(30_000)
    });
    const result = await response.json();
    if (!response.ok || result.code !== 1000) {
      throw new Error(result.message ?? `HTTP ${response.status}`);
    }
    const data = result.data;
    if (data.status === "ready") return data;
    if (data.status === "failed") {
      throw new Error(data.errorMessage ?? "Generation failed");
    }
    if (!["pending", "processing"].includes(data.status)) {
      throw new Error(`Unexpected task status: ${data.status}`);
    }
  }
  throw new Error(`Polling timed out; save taskId ${taskId} to query again later`);
}

const result = await waitForTask(taskId);
console.log(result.videoUrl);
200 OK · ready
{
  "code": 1000,
  "data": {
    "taskId": 44160,
    "type": "video",
    "model": "seedance-2.0-pro",
    "status": "ready",
    "progress": 100,
    "videoUrl": "https://example.com/result.mp4"
  }
}

Seedance 1.5 Pro Video API

Generate synchronized audio-video clips with Seedance 1.5 Pro through the PixMind API.

Seedance 2.5 Video Generation

Generate native 30-second video with up to 50 multimodal references and region-level editing through the PixMind API.

On this page

AuthenticationModel notesRequest parametersRequest exampleAccepted task responseQuery the task and retrieve results