Create Video

curl --request POST \
  --url https://zx1.deepwl.net/v1/video/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "aspect_ratio": "<string>",
  "size": "<string>",
  "duration": 123
}
'

import requests

url = "https://zx1.deepwl.net/v1/video/create"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "images": ["<string>"],
    "aspect_ratio": "<string>",
    "size": "<string>",
    "duration": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    images: ['<string>'],
    aspect_ratio: '<string>',
    size: '<string>',
    duration: 123
  })
};

fetch('https://zx1.deepwl.net/v1/video/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://zx1.deepwl.net/v1/video/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'prompt' => '<string>',
    'images' => [
        '<string>'
    ],
    'aspect_ratio' => '<string>',
    'size' => '<string>',
    'duration' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://zx1.deepwl.net/v1/video/create"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"size\": \"<string>\",\n  \"duration\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://zx1.deepwl.net/v1/video/create")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"size\": \"<string>\",\n  \"duration\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://zx1.deepwl.net/v1/video/create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"size\": \"<string>\",\n  \"duration\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
  "status": "processing",
  "status_update_time": 1762780400,
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "created_at": "2025-11-08T23:07:57.510141923+08:00"
}

POST

https://zx1.deepwl.net

video

create

Create Video

curl --request POST \
  --url https://zx1.deepwl.net/v1/video/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "aspect_ratio": "<string>",
  "size": "<string>",
  "duration": 123
}
'

import requests

url = "https://zx1.deepwl.net/v1/video/create"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "images": ["<string>"],
    "aspect_ratio": "<string>",
    "size": "<string>",
    "duration": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    images: ['<string>'],
    aspect_ratio: '<string>',
    size: '<string>',
    duration: 123
  })
};

fetch('https://zx1.deepwl.net/v1/video/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://zx1.deepwl.net/v1/video/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'prompt' => '<string>',
    'images' => [
        '<string>'
    ],
    'aspect_ratio' => '<string>',
    'size' => '<string>',
    'duration' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://zx1.deepwl.net/v1/video/create"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"size\": \"<string>\",\n  \"duration\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://zx1.deepwl.net/v1/video/create")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"size\": \"<string>\",\n  \"duration\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://zx1.deepwl.net/v1/video/create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"size\": \"<string>\",\n  \"duration\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
  "status": "processing",
  "status_update_time": 1762780400,
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "created_at": "2025-11-08T23:07:57.510141923+08:00"
}

Create Video

The Grok unified video entry point uses POST /v1/video/create, and the request body is JSON. Unlike Grok video generation in OpenAI format, this endpoint uses fields such as images, aspect_ratio, and size, and supports referencing multiple images in prompt via @img1, @img2.

The routing entry point is POST /v1/video/create.
Reference images are passed through the images array as URLs or base64; text-to-video can pass [].
The common model is grok-video-3; use the model actually available on the current channel.
After a successful submission, id or task_id and status are returned. Use Query Task to poll for the result later.

Method and Path

POST /v1/video/create

Request Example

# Text-to-video / first and last frame (images is empty or images are provided per scenario)
curl -X POST https://zx1.deepwl.net/v1/video/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "model": "grok-video-3",
    "prompt": "cat fish --mode=custom",
    "images": [],
    "aspect_ratio": "3:2",
    "size": "1080P",
    "duration": 10
  }'

# Multi-image reference (use @img1, @img2 in prompt to reference the order in images)
curl -X POST https://zx1.deepwl.net/v1/video/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-3",
    "prompt": "@img1 a cat holding a knife chasing @img2",
    "images": [
      "data:image/png;base64,BASE64_IMAGE_1",
      "data:image/png;base64,BASE64_IMAGE_2"
    ],
    "aspect_ratio": "3:2",
    "size": "1080P",
    "duration": 6
  }'

import requests

resp = requests.post(
    "https://zx1.deepwl.net/v1/video/create",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
        "Accept": "application/json",
    },
    json={
        "model": "grok-video-3",
        "prompt": "cat fish --mode=custom",
        "images": [],
        "aspect_ratio": "3:2",
        "size": "1080P",
        "duration": 10,
    },
    timeout=60,
)
print(resp.json())

const response = await fetch("https://zx1.deepwl.net/v1/video/create", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    Accept: "application/json",
  },
  body: JSON.stringify({
    model: "grok-video-3",
    prompt: "cat fish --mode=custom",
    images: [],
    aspect_ratio: "3:2",
    size: "1080P",
    duration: 10,
  }),
});

console.log(await response.json());

Response Example

{
  "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
  "status": "processing",
  "status_update_time": 1762780400,
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "created_at": "2025-11-08T23:07:57.510141923+08:00"
}

The actual response fields may vary slightly by channel. Please use id or task_id in the response as the credential for subsequent queries.

Authentication

Authorization: Bearer YOUR_API_KEY

Body

string

required

Model name, for example grok-video-3.

string

required

Prompt. When using multi-image reference, you can use placeholders such as @img1 and @img2 in the text, corresponding to the order of indices in the images array.

array<string>

required

List of reference images, where each element is a URL or a base64 data URI. Text-to-video can pass []; first-and-last-frame inputs are usually provided as 2 images in order; multi-image reference supports up to 6 images.

string

required

Video aspect ratio. Optional values are 16:9, 9:16, 2:3, 3:2, 1:1.

string

required

Resolution specification, pass 720P or 1080P.

integer

Video duration in seconds. Default is 10; supports 6, 10, and 15.

Response

string

Task ID, used as the id parameter when querying; some responses may return only task_id.

string

Upstream task ID, which may coexist with id; subject to the actual response.

string

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

integer

Most recent status update time (Unix timestamp).

string

Creation time, which in some responses is an RFC3339 string.

Overview

Text Models

Image Models

Video Models

Uploads

Tasks

Account

Create Video

Create Video

Method and Path

Request Example

Response Example

Authentication

Body

Response

​Create Video

​Method and Path

​Request Example

​Response Example

​Authentication

​Body

​Response

​Related Endpoints

Create Video

Method and Path

Request Example

Response Example

Authentication

Body

Response

Related Endpoints