PixVerse v5
VIDEOFeaturedpixverse-v5
PixVerse v5 is a powerful and user-friendly video generation model from PixVerse AI that has gained popularity for its ability to produce high-quality, stylized video content. It is adept at interpreting creative prompts to generate 1080p videos with vibrant aesthetics and consistent character motion. For the AI art community, PixVerse is a strong and accessible option for creating everything from animated shorts to dynamic, visually rich social media posts.
POST
/v2/workspaces/{workspace_id}/base-models/pixverse-v5/inferences
curl --request POST \ --url https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/pixverse-v5/inferences \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "prompt": "a knight standing in a snowy forest", "aspect_ratio": "LANDSCAPE_16_9_1080p", "duration_seconds": 5, "guidance_file_first_frame": [ { "url": "<file_url>" } ], "guidance_file_last_frame": [ { "url": "<file_url>" } ]}'import requests
url = "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/pixverse-v5/inferences"
payload = { "prompt": "a knight standing in a snowy forest", "aspect_ratio": "LANDSCAPE_16_9_1080p", "duration_seconds": 5, "guidance_file_first_frame": [{ "url": "<file_url>" }], "guidance_file_last_frame": [{ "url": "<file_url>" }]}headers = { "Authorization": "Bearer <token>", "Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.json())const url = 'https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/pixverse-v5/inferences';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"prompt":"a knight standing in a snowy forest","aspect_ratio":"LANDSCAPE_16_9_1080p","duration_seconds":5,"guidance_file_first_frame":[{"url":"<file_url>"}],"guidance_file_last_frame":[{"url":"<file_url>"}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}package main
import ( "fmt" "strings" "net/http" "io")
func main() {
url := "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/pixverse-v5/inferences"
payload := strings.NewReader("{\n \"prompt\": \"a knight standing in a snowy forest\",\n \"aspect_ratio\": \"LANDSCAPE_16_9_1080p\",\n \"duration_seconds\": 5,\n \"guidance_file_first_frame\": [\n {\n \"url\": \"<file_url>\"\n }\n ],\n \"guidance_file_last_frame\": [\n {\n \"url\": \"<file_url>\"\n }\n ]\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(res) fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [ CURLOPT_URL => "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/pixverse-v5/inferences", 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([ 'prompt' => 'a knight standing in a snowy forest', 'aspect_ratio' => 'LANDSCAPE_16_9_1080p', 'duration_seconds' => 5, 'guidance_file_first_frame' => [ [ 'url' => '<file_url>' ] ], 'guidance_file_last_frame' => [ [ 'url' => '<file_url>' ] ] ]), 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;}OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");RequestBody body = RequestBody.create(mediaType, "{\n \"prompt\": \"a knight standing in a snowy forest\",\n \"aspect_ratio\": \"LANDSCAPE_16_9_1080p\",\n \"duration_seconds\": 5,\n \"guidance_file_first_frame\": [\n {\n \"url\": \"<file_url>\"\n }\n ],\n \"guidance_file_last_frame\": [\n {\n \"url\": \"<file_url>\"\n }\n ]\n}");Request request = new Request.Builder() .url("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/pixverse-v5/inferences") .post(body) .addHeader("Authorization", "Bearer <token>") .addHeader("Content-Type", "application/json") .build();
Response response = client.newCall(request).execute();require 'uri'require 'net/http'
url = URI("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/pixverse-v5/inferences")
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 \"prompt\": \"a knight standing in a snowy forest\",\n \"aspect_ratio\": \"LANDSCAPE_16_9_1080p\",\n \"duration_seconds\": 5,\n \"guidance_file_first_frame\": [\n {\n \"url\": \"<file_url>\"\n }\n ],\n \"guidance_file_last_frame\": [\n {\n \"url\": \"<file_url>\"\n }\n ]\n}"
response = http.request(request)puts response.read_bodyvar client = new RestClient("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/pixverse-v5/inferences");var request = new RestRequest("", Method.Post);request.AddHeader("Authorization", "Bearer <token>");request.AddHeader("Content-Type", "application/json");request.AddParameter("application/json", "{\n \"prompt\": \"a knight standing in a snowy forest\",\n \"aspect_ratio\": \"LANDSCAPE_16_9_1080p\",\n \"duration_seconds\": 5,\n \"guidance_file_first_frame\": [\n {\n \"url\": \"<file_url>\"\n }\n ],\n \"guidance_file_last_frame\": [\n {\n \"url\": \"<file_url>\"\n }\n ]\n}", ParameterType.RequestBody);var response = client.Execute(request);Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”workspace_id
required
Workspace Id
Id of the workspace that owns the resource.
string format: uuid
Id of the workspace that owns the resource.
Query Parameters
Section titled “Query Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”PixVerse v5
object
prompt
Prompt
string
negative_prompt
Negative Prompt
Advanced field.
string
aspect_ratio
Aspect Ratio
string
seed
Seed
Advanced field.
integer
duration_seconds
Duration
integer
guidance_file_first_frame
First frame
The frame the video starts on
Array<object>
InferenceFormFileRefA single guidance/reference file supplied to a reference_image_list field.
The slot’s guidance type is fixed by the field it’s attached to; the caller
supplies the file URL and, where the model supports per-file weighting, a weight.
object
url
required
Url
string
weight
Weight
number
guidance_file_last_frame
Last frame
The frame the video ends on
Array<object>
InferenceFormFileRefA single guidance/reference file supplied to a reference_image_list field.
The slot’s guidance type is fixed by the field it’s attached to; the caller
supplies the file URL and, where the model supports per-file weighting, a weight.
object
url
required
Url
string
weight
Weight
number
prompt_language
Prompt Language
Advanced field.
string
Example
{ "prompt": "a knight standing in a snowy forest", "aspect_ratio": "LANDSCAPE_16_9_1080p", "duration_seconds": 5, "guidance_file_first_frame": [ { "url": "<file_url>" } ], "guidance_file_last_frame": [ { "url": "<file_url>" } ]}Responses
Section titled “Responses”Successful Response
ExecuteForgeOutput
object
inference_id
required
Inference Id
Unique identifier for this forge run.
string format: uuid
status
required
InferenceStatus
Current status: IN_PROGRESS.
string
poll_interval_seconds
required
Poll Interval Seconds
Suggested polling interval in seconds.
integer
created_at
required
Created At
Timestamp of when the run was created.
string format: date-time
normalized_parameters
Any of:
NormalizedInferenceParameters
Inference parameters after model-specific normalization.
These reflect the actual values used for generation, including model defaults applied for any parameters not explicitly set.
null
Example
{ "status": "in_progress"}Unauthenticated — missing or invalid Bearer token.
object
type
required
string
title
required
string
status
required
integer
detail
required
string
Example
{ "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description."}Forbidden — insufficient permissions.
object
type
required
string
title
required
string
status
required
integer
detail
required
string
Example
{ "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description."}Resource not found.
object
type
required
string
title
required
string
status
required
integer
detail
required
string
Example
{ "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description."}Invalid input parameters.
object
type
required
string
title
required
string
status
required
integer
detail
required
string
Example
{ "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description."}Rate limited — too many concurrent requests.
object
type
required
string
title
required
string
status
required
integer
detail
required
string
Example
{ "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description."}Internal server error.
object
type
required
string
title
required
string
status
required
integer
detail
required
string
Example
{ "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description."}