Video Generation

Submit an asynchronous video generation task.

01Overview

The model selects an enabled video model. Provider-specific paths and credentials are configured on the channel, not exposed to API clients.

POST/api/v1/videos

Base URL https://capi.minapp.xinAPI version v1Authentication Bearer YOUR_API_TOKEN

02Parameters

Name	Type	Description
model*	string	An enabled video model ID.
prompt*	string	Text description of the video.

03Request body

JSON

{
  "model": "YOUR_VIDEO_MODEL",
  "prompt": "A paper kite flying above a quiet coastal town at sunrise"
}

04Notes

Idempotency-Key is required. The first submission returns 202; repeating the request with the same key returns the existing task with 200.
Task statuses are submitting, running, unknown, succeeded, and failed.
Unknown submission states remain reserved for reconciliation; failed tasks release their reservation.

Example

Video Generation

cURL

curl -X POST https://capi.minapp.xin/api/v1/videos \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_VIDEO_MODEL","prompt":"A paper kite above a coastal town at sunrise"}'

HTTP 202· Accepted

{
  "id": "video_42_demo-video-001",
  "object": "video.task",
  "status": "submitting"
}

Task API quickstart →All endpoints →