Unified Video

Create Video

Use `POST /v1/video/create` to submit Jimeng asynchronous generation tasks through the unified video format.

POSThttps://zx1.deepwl.net/v1/video/create
Request
curl -X POST https://zx1.deepwl.net/v1/video/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '
{
  "model": "jimeng-video-3.0",
  "prompt": "cat fish",
  "aspect_ratio": "16:9",
  "size": "1080P",
  "images": []
}'
Response
{
  "created_at": "2025-11-08T23:07:57.510141923+08:00",
  "status": "processing",
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114"
}

The Jimeng unified video entry uses POST /v1/video/create, and the request body is JSON. Unlike Jimeng video generation in OpenAI format, this API uses fields such as images, aspect_ratio, size, and duration.

  • Reference images are passed in as a list of URLs through the images array; for text-to-video, you can pass an empty array.
  • A common model example is jimeng-video-3.0; use the model actually available in the current channel.
  • After a successful submission, the task id and status are returned, and the result is polled later via Query Task.

Supported Models

  • jimeng-video-3.0
  • jimeng-video-2.0

Request Headers

Authorizationstring必填

Authentication header. Uses a Bearer token, e.g. Bearer YOUR_API_KEY.

Content-Typestring必填

Request content type, must be application/json.

Request Body

modelstring必填

Model name, for example jimeng-video-3.0.

promptstring必填

Prompt. The text description for video generation, supporting both Chinese and English.

imagesarray<string>必填

List of image URLs. Pass [] for text-to-video, 1 image for first-frame-to-video, or 2 images for first-and-last-frame-to-video. Supports image URLs, with image formats including png, jpeg, jpg, and webp.

aspect_ratiostring必填

Aspect ratio. Available values include 16:9, 4:3, 1:1, 3:4, 9:16, and 21:9.

sizestring必填

Video size. Available values include 720P and 1080P.

Request Examples

Response Examples

Response Fields

created_atstring

Creation time (ISO 8601 format).

statusstring

Task status. Common values include processing, failed, and completed.

task_idstring

Task ID, passed as the id parameter in subsequent queries.