AIHubMix Unified API

Create an AIHubMix video task

Creates a video task with the AIHubMix native media protocol. Video generation is always asynchronous.

post/ai/v1/videos

Request

modelstring required

Video model ID.

promptstring required

durationinteger nullable

Video duration in seconds. Allowed values are model-specific.

aspect_ratiostring nullable

resolution'480p' | '720p' | '1080p' | '1K' | '2K' | '4K' nullable

sizestring nullable

seedinteger nullable

generate_audioboolean nullable

webhook_urlstring uri

webhook_events_filterstring[]

extraobject nullable

Video task

idstring required

Platform task ID.

object'image' | 'video' required

modelstring required

status'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled' required

Current task state. Completed, failed, and cancelled are terminal states.

created_atinteger required

Unix timestamp in seconds.

completed_atinteger nullable required

expires_atinteger nullable required

Artifact expiry time in Unix seconds; may be null before completion.