Picture and video generation
Generate video
Generate videos from a text prompt with optional reference images. You can upload 0 to 6 reference images and submit 1 to 4 generation jobs in a single request.
POST
/
api
/
createNormalVideo
Generate video
curl --request POST \
--url https://alb.neural4d.com:3000/api/createNormalVideo \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=a flower bouquet' \
--form 'images=(binary)' \
--form duration=14 \
--form aspectRatio=9:16 \
--form resolution=480p \
--form jobNum=3 \
--form images.items='@example-file'const form = new FormData();
form.append('prompt', 'a flower bouquet');
form.append('images', '(binary)');
form.append('duration', '14');
form.append('aspectRatio', '9:16');
form.append('resolution', '480p');
form.append('jobNum', '3');
form.append('images.items', '{
"fileName": "example-file"
}');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://alb.neural4d.com:3000/api/createNormalVideo', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://alb.neural4d.com:3000/api/createNormalVideo"
files = { "images.items": ("example-file", open("example-file", "rb")) }
payload = {
"prompt": "a flower bouquet",
"images": "(binary)",
"duration": "14",
"aspectRatio": "9:16",
"resolution": "480p",
"jobNum": "3"
}
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)import fs from 'fs';
const formData = new FormData();
formData.append('prompt', 'a flower bouquet');
formData.append('images', '(binary)');
formData.append('duration', '14');
formData.append('aspectRatio', '9:16');
formData.append('resolution', '480p');
formData.append('jobNum', '3');
formData.append('images.items', await new Response(fs.createReadStream('example-file')).blob());
const url = 'https://alb.neural4d.com:3000/api/createNormalVideo';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}, body: formData};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));const form = new FormData();
form.append('prompt', 'a flower bouquet');
form.append('images', '(binary)');
form.append('duration', '14');
form.append('aspectRatio', '9:16');
form.append('resolution', '480p');
form.append('jobNum', '3');
form.append('images.items', '{
"fileName": "example-file"
}');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://alb.neural4d.com:3000/api/createNormalVideo', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://alb.neural4d.com:3000/api/createNormalVideo"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\na flower bouquet\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"images\"\r\n\r\n(binary)\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"duration\"\r\n\r\n14\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"aspectRatio\"\r\n\r\n9:16\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"resolution\"\r\n\r\n480p\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"jobNum\"\r\n\r\n3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"images.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://alb.neural4d.com:3000/api/createNormalVideo")
.header("Authorization", "Bearer <token>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\na flower bouquet\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"images\"\r\n\r\n(binary)\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"duration\"\r\n\r\n14\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"aspectRatio\"\r\n\r\n9:16\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"resolution\"\r\n\r\n480p\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"jobNum\"\r\n\r\n3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"images.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")
.asString();using RestSharp;
var options = new RestClientOptions("https://alb.neural4d.com:3000/api/createNormalVideo");
var client = new RestClient(options);
var request = new RestRequest("");
request.AlwaysMultipartFormData = true;
request.AddHeader("Authorization", "Bearer <token>");
request.AddParameter("prompt", "a flower bouquet");
request.AddParameter("images", "(binary)");
request.AddParameter("duration", "14");
request.AddParameter("aspectRatio", "9:16");
request.AddParameter("resolution", "480p");
request.AddParameter("jobNum", "3");
request.AddFile("images.items", "example-file");
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3000",
CURLOPT_URL => "https://alb.neural4d.com:3000/api/createNormalVideo",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\na flower bouquet\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"images\"\r\n\r\n(binary)\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"duration\"\r\n\r\n14\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"aspectRatio\"\r\n\r\n9:16\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"resolution\"\r\n\r\n480p\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"jobNum\"\r\n\r\n3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"images.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"success": true,
"data": {
"pointsDeducted": 1344,
"queueStatus": "queued",
"jobNum": 3,
"uuids": [
"18c8eb80-e1b0-43d4-878e-7fdd31a7e525",
"76f14626-e2ef-466c-a720-473dc64ebf43",
"acb40a9d-082b-4842-bd92-1955b7eb1a13"
]
}
}Authorizations
Use the bearer token provided through the Neural4D website.
Body
multipart/form-data
Text prompt describing the desired generated video.
Optional reference images used to guide generation.
Maximum array length:
6Target aspect ratio for the generated video.
Available options:
16:9, 9:16, 1:1, 4:3, 3:4 Number of generation jobs to submit.
Required range:
1 <= x <= 4Target video duration in seconds.
Required range:
4 <= x <= 15Target output resolution.
Available options:
480p, 720p, 1080p Previous
Retrieve generation resultQuery the generation result by UUID. This is a query-only operation and does not consume points.
Next
⌘I
Generate video
curl --request POST \
--url https://alb.neural4d.com:3000/api/createNormalVideo \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=a flower bouquet' \
--form 'images=(binary)' \
--form duration=14 \
--form aspectRatio=9:16 \
--form resolution=480p \
--form jobNum=3 \
--form images.items='@example-file'const form = new FormData();
form.append('prompt', 'a flower bouquet');
form.append('images', '(binary)');
form.append('duration', '14');
form.append('aspectRatio', '9:16');
form.append('resolution', '480p');
form.append('jobNum', '3');
form.append('images.items', '{
"fileName": "example-file"
}');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://alb.neural4d.com:3000/api/createNormalVideo', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://alb.neural4d.com:3000/api/createNormalVideo"
files = { "images.items": ("example-file", open("example-file", "rb")) }
payload = {
"prompt": "a flower bouquet",
"images": "(binary)",
"duration": "14",
"aspectRatio": "9:16",
"resolution": "480p",
"jobNum": "3"
}
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)import fs from 'fs';
const formData = new FormData();
formData.append('prompt', 'a flower bouquet');
formData.append('images', '(binary)');
formData.append('duration', '14');
formData.append('aspectRatio', '9:16');
formData.append('resolution', '480p');
formData.append('jobNum', '3');
formData.append('images.items', await new Response(fs.createReadStream('example-file')).blob());
const url = 'https://alb.neural4d.com:3000/api/createNormalVideo';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}, body: formData};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));const form = new FormData();
form.append('prompt', 'a flower bouquet');
form.append('images', '(binary)');
form.append('duration', '14');
form.append('aspectRatio', '9:16');
form.append('resolution', '480p');
form.append('jobNum', '3');
form.append('images.items', '{
"fileName": "example-file"
}');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://alb.neural4d.com:3000/api/createNormalVideo', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://alb.neural4d.com:3000/api/createNormalVideo"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\na flower bouquet\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"images\"\r\n\r\n(binary)\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"duration\"\r\n\r\n14\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"aspectRatio\"\r\n\r\n9:16\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"resolution\"\r\n\r\n480p\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"jobNum\"\r\n\r\n3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"images.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://alb.neural4d.com:3000/api/createNormalVideo")
.header("Authorization", "Bearer <token>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\na flower bouquet\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"images\"\r\n\r\n(binary)\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"duration\"\r\n\r\n14\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"aspectRatio\"\r\n\r\n9:16\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"resolution\"\r\n\r\n480p\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"jobNum\"\r\n\r\n3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"images.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")
.asString();using RestSharp;
var options = new RestClientOptions("https://alb.neural4d.com:3000/api/createNormalVideo");
var client = new RestClient(options);
var request = new RestRequest("");
request.AlwaysMultipartFormData = true;
request.AddHeader("Authorization", "Bearer <token>");
request.AddParameter("prompt", "a flower bouquet");
request.AddParameter("images", "(binary)");
request.AddParameter("duration", "14");
request.AddParameter("aspectRatio", "9:16");
request.AddParameter("resolution", "480p");
request.AddParameter("jobNum", "3");
request.AddFile("images.items", "example-file");
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3000",
CURLOPT_URL => "https://alb.neural4d.com:3000/api/createNormalVideo",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\na flower bouquet\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"images\"\r\n\r\n(binary)\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"duration\"\r\n\r\n14\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"aspectRatio\"\r\n\r\n9:16\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"resolution\"\r\n\r\n480p\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"jobNum\"\r\n\r\n3\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"images.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"success": true,
"data": {
"pointsDeducted": 1344,
"queueStatus": "queued",
"jobNum": 3,
"uuids": [
"18c8eb80-e1b0-43d4-878e-7fdd31a7e525",
"76f14626-e2ef-466c-a720-473dc64ebf43",
"acb40a9d-082b-4842-bd92-1955b7eb1a13"
]
}
}
