Aliyun Bailian | 阿里云百炼 icon

Aliyun Bailian | 阿里云百炼

Access Alibaba Cloud Aliyun Bailian video generation, editing, and task APIs.

Video → Emoji Video | Emoji 视频生成

AI-generated

Summary

Generate an emoji animated video using a portrait image URL and a specified emoji template. Optionally control detection parameters and await task completion to retrieve the final animation result.

Inputs

  • Portrait Image URL (required) — Public URL of the portrait image used for emoji animation, must be suitable for emoji detection.
  • Emoji Template ID (required) — Identifier of the emoji animation template to apply, as listed in the official Aliyun Model Studio documentation.
  • Detection Ratio — Aspect ratio parameter for emoji detection, currently only '1:1' is supported.
  • Advanced Options — Optional settings including overrides for detected face or expression bounding boxes as JSON arrays and debug output inclusion.
  • Wait for Task Completion — If enabled, the operation polls until the video generation task completes or fails, returning final video data; if disabled, returns the task ID immediately.
  • Poll Interval (MS) — Polling frequency in milliseconds when waiting for task completion (default 2000ms).
  • Max Wait (Seconds) — Maximum wait time in seconds before polling times out (default 600s).

Output shape

a structured response including the generated emoji video data or a task ID if polling is disabled

When 'Wait for Task Completion' is true, the operation returns the completed video data after polling the task endpoint; otherwise, it returns immediately with the task ID. Including detection debug output is optional and controlled via advanced options.

Examples

Example 1: Generate an emoji video from a given portrait URL using the 'emoji_zz_heart_love_1' template, waiting for task completion to obtain the final video.

Set 'Portrait Image URL' to the image's public URL, 'Emoji Template ID' to 'emoji_zz_heart_love_1', enable 'Wait for Task Completion', and optionally adjust 'Poll Interval' and 'Max Wait' for polling behavior.

Links

Discussion