Submit Seedance Material Review

POST/v1/video/generations

Submit one absolute HTTPS image, audio, or video URL for asynchronous review and receive a public task ID. Select the matching seedance-review-* model for the media type.

Request Body

application/json

model:requiredstring

Review model. Use seedance-review-image, seedance-review-audio, or seedance-review-video and match it to the submitted media type. The schema default is seedance-review-image.

Allowedseedance-review-imageseedance-review-audioseedance-review-video

Exampleseedance-review-image

prompt:requiredstring

Non-empty material name sent to the review service.

ExamplePortrait test

metadata:requiredobject

Material review payload containing exactly one media item.

metadata.content:requiredarray

Array containing exactly one image_url, audio_url, or video_url item. The nested URL must be an absolute HTTPS URL.

metadata.content[].type:requiredstring

Media type. It must match the review model, and the item must contain only the corresponding URL field.

Allowedimage_urlaudio_urlvideo_url

metadata.content[].image_url:optionalobject

Required when type is image_url.

metadata.content[].image_url.url:optionalstring

Absolute HTTPS image URL. http://, asset://, data: URLs, and local files are not supported.

Examplehttps://example.com/person.jpg

metadata.content[].audio_url:optionalobject

Required when type is audio_url.

metadata.content[].audio_url.url:optionalstring

Absolute HTTPS audio URL. http://, asset://, data: URLs, and local files are not supported.

Examplehttps://example.com/dialogue.mp3

metadata.content[].video_url:optionalobject

Required when type is video_url.

metadata.content[].video_url.url:optionalstring

Absolute HTTPS video URL. http://, asset://, data: URLs, and local files are not supported.

Examplehttps://example.com/reference.mp4

Response

200

A successful request returns a JSON response. The complete example is shown in the code panel.

Request ExamplePOST /v1/video/generations

Request example

1curl --request POST \2  --url 'https://api.unifyllm.top/v1/video/generations' \3  --header 'Authorization: Bearer <YOUR_API_KEY>' \4  --header 'Content-Type: application/json' \5  --data '{6  "model": "seedance-review-image",7  "prompt": "Portrait reference",8  "metadata": {9    "content": [10      {11        "type": "image_url",12        "image_url": {13          "url": "https://example.com/person.jpg"14        }15      }16    ]17  }18}'

1const response = await fetch("https://api.unifyllm.top/v1/video/generations", {2  method: "POST",3  headers: {4    "Authorization": "Bearer <YOUR_API_KEY>",5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    "model": "seedance-review-image",9    "prompt": "Portrait reference",10    "metadata": {11      "content": [12        {13          "type": "image_url",14          "image_url": {15            "url": "https://example.com/person.jpg"16          }17        }18      ]19    }20  }),21});22 23const data = await response.json();24console.log(data);

1import requests2 3response = requests.post(4    "https://api.unifyllm.top/v1/video/generations",5    headers={"Authorization": "Bearer <YOUR_API_KEY>"},6    json={7      "model": "seedance-review-image",8      "prompt": "Portrait reference",9      "metadata": {10        "content": [11          {12            "type": "image_url",13            "image_url": {14              "url": "https://example.com/person.jpg"15            }16          }17        ]18      }19    }20)21response.raise_for_status()22print(response.json())

Request Body

1{2  "model": "seedance-review-image",3  "prompt": "Portrait reference",4  "metadata": {5    "content": [6      {7        "type": "image_url",8        "image_url": {9          "url": "https://example.com/person.jpg"10        }11      }12    ]13  }14}

1curl --request POST \2  --url 'https://api.unifyllm.top/v1/video/generations' \3  --header 'Authorization: Bearer <YOUR_API_KEY>' \4  --header 'Content-Type: application/json' \5  --data '{6  "model": "seedance-review-audio",7  "prompt": "Character dialogue",8  "metadata": {9    "content": [10      {11        "type": "audio_url",12        "audio_url": {13          "url": "https://example.com/dialogue.mp3"14        }15      }16    ]17  }18}'

1const response = await fetch("https://api.unifyllm.top/v1/video/generations", {2  method: "POST",3  headers: {4    "Authorization": "Bearer <YOUR_API_KEY>",5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    "model": "seedance-review-audio",9    "prompt": "Character dialogue",10    "metadata": {11      "content": [12        {13          "type": "audio_url",14          "audio_url": {15            "url": "https://example.com/dialogue.mp3"16          }17        }18      ]19    }20  }),21});22 23const data = await response.json();24console.log(data);

1import requests2 3response = requests.post(4    "https://api.unifyllm.top/v1/video/generations",5    headers={"Authorization": "Bearer <YOUR_API_KEY>"},6    json={7      "model": "seedance-review-audio",8      "prompt": "Character dialogue",9      "metadata": {10        "content": [11          {12            "type": "audio_url",13            "audio_url": {14              "url": "https://example.com/dialogue.mp3"15            }16          }17        ]18      }19    }20)21response.raise_for_status()22print(response.json())

Request Body

1{2  "model": "seedance-review-audio",3  "prompt": "Character dialogue",4  "metadata": {5    "content": [6      {7        "type": "audio_url",8        "audio_url": {9          "url": "https://example.com/dialogue.mp3"10        }11      }12    ]13  }14}

1curl --request POST \2  --url 'https://api.unifyllm.top/v1/video/generations' \3  --header 'Authorization: Bearer <YOUR_API_KEY>' \4  --header 'Content-Type: application/json' \5  --data '{6  "model": "seedance-review-video",7  "prompt": "Reference video",8  "metadata": {9    "content": [10      {11        "type": "video_url",12        "video_url": {13          "url": "https://example.com/reference.mp4"14        }15      }16    ]17  }18}'

1const response = await fetch("https://api.unifyllm.top/v1/video/generations", {2  method: "POST",3  headers: {4    "Authorization": "Bearer <YOUR_API_KEY>",5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    "model": "seedance-review-video",9    "prompt": "Reference video",10    "metadata": {11      "content": [12        {13          "type": "video_url",14          "video_url": {15            "url": "https://example.com/reference.mp4"16          }17        }18      ]19    }20  }),21});22 23const data = await response.json();24console.log(data);

1import requests2 3response = requests.post(4    "https://api.unifyllm.top/v1/video/generations",5    headers={"Authorization": "Bearer <YOUR_API_KEY>"},6    json={7      "model": "seedance-review-video",8      "prompt": "Reference video",9      "metadata": {10        "content": [11          {12            "type": "video_url",13            "video_url": {14              "url": "https://example.com/reference.mp4"15            }16          }17        ]18      }19    }20)21response.raise_for_status()22print(response.json())

Request Body

1{2  "model": "seedance-review-video",3  "prompt": "Reference video",4  "metadata": {5    "content": [6      {7        "type": "video_url",8        "video_url": {9          "url": "https://example.com/reference.mp4"10        }11      }12    ]13  }14}

Response Example

200

1{2  "id": "task_OQDH4qDiUxuyyu27iZRsHx7uPPhmNcyV",3  "task_id": "task_OQDH4qDiUxuyyu27iZRsHx7uPPhmNcyV",4  "object": "video",5  "model": "seedance-review-image",6  "status": "queued",7  "progress": 0,8  "created_at": 17853248479}