Video Generation

cURL

curl --request POST \
  --url https://api.deapi.ai/api/v2/videos/generations \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A beautiful sunset over mountains",
  "width": 512,
  "height": 512,
  "guidance": 7.5,
  "steps": 1,
  "frames": 120,
  "fps": 30,
  "seed": 42,
  "model": "Ltxv_13B_0_9_8_Distilled_FP8",
  "negative_prompt": "blur, darkness, noise",
  "enhance_prompt": false,
  "webhook_url": "https://your-server.com/webhooks/deapi",
  "webhook_secret": "a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5"
}
'

import requests

url = "https://api.deapi.ai/api/v2/videos/generations"

payload = {
    "prompt": "A beautiful sunset over mountains",
    "width": 512,
    "height": 512,
    "guidance": 7.5,
    "steps": 1,
    "frames": 120,
    "fps": 30,
    "seed": 42,
    "model": "Ltxv_13B_0_9_8_Distilled_FP8",
    "negative_prompt": "blur, darkness, noise",
    "enhance_prompt": False,
    "webhook_url": "https://your-server.com/webhooks/deapi",
    "webhook_secret": "a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5"
}
headers = {
    "Accept": "<accept>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Accept: '<accept>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'A beautiful sunset over mountains',
    width: 512,
    height: 512,
    guidance: 7.5,
    steps: 1,
    frames: 120,
    fps: 30,
    seed: 42,
    model: 'Ltxv_13B_0_9_8_Distilled_FP8',
    negative_prompt: 'blur, darkness, noise',
    enhance_prompt: false,
    webhook_url: 'https://your-server.com/webhooks/deapi',
    webhook_secret: 'a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5'
  })
};

fetch('https://api.deapi.ai/api/v2/videos/generations', 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://api.deapi.ai/api/v2/videos/generations",
  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 beautiful sunset over mountains',
    'width' => 512,
    'height' => 512,
    'guidance' => 7.5,
    'steps' => 1,
    'frames' => 120,
    'fps' => 30,
    'seed' => 42,
    'model' => 'Ltxv_13B_0_9_8_Distilled_FP8',
    'negative_prompt' => 'blur, darkness, noise',
    'enhance_prompt' => false,
    'webhook_url' => 'https://your-server.com/webhooks/deapi',
    'webhook_secret' => 'a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5'
  ]),
  CURLOPT_HTTPHEADER => [
    "Accept: <accept>",
    "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://api.deapi.ai/api/v2/videos/generations"

	payload := strings.NewReader("{\n  \"prompt\": \"A beautiful sunset over mountains\",\n  \"width\": 512,\n  \"height\": 512,\n  \"guidance\": 7.5,\n  \"steps\": 1,\n  \"frames\": 120,\n  \"fps\": 30,\n  \"seed\": 42,\n  \"model\": \"Ltxv_13B_0_9_8_Distilled_FP8\",\n  \"negative_prompt\": \"blur, darkness, noise\",\n  \"enhance_prompt\": false,\n  \"webhook_url\": \"https://your-server.com/webhooks/deapi\",\n  \"webhook_secret\": \"a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5\"\n}")

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

	req.Header.Add("Accept", "<accept>")
	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://api.deapi.ai/api/v2/videos/generations")
  .header("Accept", "<accept>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A beautiful sunset over mountains\",\n  \"width\": 512,\n  \"height\": 512,\n  \"guidance\": 7.5,\n  \"steps\": 1,\n  \"frames\": 120,\n  \"fps\": 30,\n  \"seed\": 42,\n  \"model\": \"Ltxv_13B_0_9_8_Distilled_FP8\",\n  \"negative_prompt\": \"blur, darkness, noise\",\n  \"enhance_prompt\": false,\n  \"webhook_url\": \"https://your-server.com/webhooks/deapi\",\n  \"webhook_secret\": \"a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.deapi.ai/api/v2/videos/generations")

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

request = Net::HTTP::Post.new(url)
request["Accept"] = '<accept>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"A beautiful sunset over mountains\",\n  \"width\": 512,\n  \"height\": 512,\n  \"guidance\": 7.5,\n  \"steps\": 1,\n  \"frames\": 120,\n  \"fps\": 30,\n  \"seed\": 42,\n  \"model\": \"Ltxv_13B_0_9_8_Distilled_FP8\",\n  \"negative_prompt\": \"blur, darkness, noise\",\n  \"enhance_prompt\": false,\n  \"webhook_url\": \"https://your-server.com/webhooks/deapi\",\n  \"webhook_secret\": \"a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5\"\n}"

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

{
  "data": {
    "request_id": "c08a339c-73e5-4d67-a4d5-231302fbff9a"
  }
}

{
  "data": {},
  "message": "<string>",
  "errors": [
    "<unknown>"
  ],
  "statusCode": 123
}

{
  "data": {},
  "message": "<string>",
  "errors": [
    "<unknown>"
  ],
  "statusCode": 123
}

{
  "message": "The selected model does not support Text To Image.",
  "errors": {
    "model": [
      "The selected model does not support Text To Image."
    ]
  }
}

{
  "message": "Too Many Attempts."
}

POST

api

videos

generations

cURL

curl --request POST \
  --url https://api.deapi.ai/api/v2/videos/generations \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A beautiful sunset over mountains",
  "width": 512,
  "height": 512,
  "guidance": 7.5,
  "steps": 1,
  "frames": 120,
  "fps": 30,
  "seed": 42,
  "model": "Ltxv_13B_0_9_8_Distilled_FP8",
  "negative_prompt": "blur, darkness, noise",
  "enhance_prompt": false,
  "webhook_url": "https://your-server.com/webhooks/deapi",
  "webhook_secret": "a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5"
}
'

import requests

url = "https://api.deapi.ai/api/v2/videos/generations"

payload = {
    "prompt": "A beautiful sunset over mountains",
    "width": 512,
    "height": 512,
    "guidance": 7.5,
    "steps": 1,
    "frames": 120,
    "fps": 30,
    "seed": 42,
    "model": "Ltxv_13B_0_9_8_Distilled_FP8",
    "negative_prompt": "blur, darkness, noise",
    "enhance_prompt": False,
    "webhook_url": "https://your-server.com/webhooks/deapi",
    "webhook_secret": "a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5"
}
headers = {
    "Accept": "<accept>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Accept: '<accept>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'A beautiful sunset over mountains',
    width: 512,
    height: 512,
    guidance: 7.5,
    steps: 1,
    frames: 120,
    fps: 30,
    seed: 42,
    model: 'Ltxv_13B_0_9_8_Distilled_FP8',
    negative_prompt: 'blur, darkness, noise',
    enhance_prompt: false,
    webhook_url: 'https://your-server.com/webhooks/deapi',
    webhook_secret: 'a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5'
  })
};

fetch('https://api.deapi.ai/api/v2/videos/generations', 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://api.deapi.ai/api/v2/videos/generations",
  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 beautiful sunset over mountains',
    'width' => 512,
    'height' => 512,
    'guidance' => 7.5,
    'steps' => 1,
    'frames' => 120,
    'fps' => 30,
    'seed' => 42,
    'model' => 'Ltxv_13B_0_9_8_Distilled_FP8',
    'negative_prompt' => 'blur, darkness, noise',
    'enhance_prompt' => false,
    'webhook_url' => 'https://your-server.com/webhooks/deapi',
    'webhook_secret' => 'a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5'
  ]),
  CURLOPT_HTTPHEADER => [
    "Accept: <accept>",
    "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://api.deapi.ai/api/v2/videos/generations"

	payload := strings.NewReader("{\n  \"prompt\": \"A beautiful sunset over mountains\",\n  \"width\": 512,\n  \"height\": 512,\n  \"guidance\": 7.5,\n  \"steps\": 1,\n  \"frames\": 120,\n  \"fps\": 30,\n  \"seed\": 42,\n  \"model\": \"Ltxv_13B_0_9_8_Distilled_FP8\",\n  \"negative_prompt\": \"blur, darkness, noise\",\n  \"enhance_prompt\": false,\n  \"webhook_url\": \"https://your-server.com/webhooks/deapi\",\n  \"webhook_secret\": \"a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5\"\n}")

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

	req.Header.Add("Accept", "<accept>")
	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://api.deapi.ai/api/v2/videos/generations")
  .header("Accept", "<accept>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A beautiful sunset over mountains\",\n  \"width\": 512,\n  \"height\": 512,\n  \"guidance\": 7.5,\n  \"steps\": 1,\n  \"frames\": 120,\n  \"fps\": 30,\n  \"seed\": 42,\n  \"model\": \"Ltxv_13B_0_9_8_Distilled_FP8\",\n  \"negative_prompt\": \"blur, darkness, noise\",\n  \"enhance_prompt\": false,\n  \"webhook_url\": \"https://your-server.com/webhooks/deapi\",\n  \"webhook_secret\": \"a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.deapi.ai/api/v2/videos/generations")

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

request = Net::HTTP::Post.new(url)
request["Accept"] = '<accept>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"A beautiful sunset over mountains\",\n  \"width\": 512,\n  \"height\": 512,\n  \"guidance\": 7.5,\n  \"steps\": 1,\n  \"frames\": 120,\n  \"fps\": 30,\n  \"seed\": 42,\n  \"model\": \"Ltxv_13B_0_9_8_Distilled_FP8\",\n  \"negative_prompt\": \"blur, darkness, noise\",\n  \"enhance_prompt\": false,\n  \"webhook_url\": \"https://your-server.com/webhooks/deapi\",\n  \"webhook_secret\": \"a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5\"\n}"

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

{
  "data": {
    "request_id": "c08a339c-73e5-4d67-a4d5-231302fbff9a"
  }
}

{
  "data": {},
  "message": "<string>",
  "errors": [
    "<unknown>"
  ],
  "statusCode": 123
}

{
  "data": {},
  "message": "<string>",
  "errors": [
    "<unknown>"
  ],
  "statusCode": 123
}

{
  "message": "The selected model does not support Text To Image.",
  "errors": {
    "model": [
      "The selected model does not support Text To Image."
    ]
  }
}

{
  "message": "Too Many Attempts."
}

Generate a video from a text prompt. Returns a request_id for status polling.

Prerequisite: Consult the Model Selection endpoint to identify a valid model slug and check specific limits (resolution, duration, framerate).

OpenAI SDK users: This endpoint is also available via the OpenAI-compatible surface as POST /v1/videos at https://oai.deapi.ai/v1. See OpenAI Compatibility.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

enum<string>

default:application/json

required

Available options:

application/json

Body

application/json

Text to video conversion parameters

prompt

string

required

The main prompt for video generation

Example:

"A beautiful sunset over mountains"

width

integer

required

Width of the generated video in pixels

Example:

512

height

integer

required

Height of the generated video in pixels

Example:

512

guidance

number

required

Guidance scale for the generation

Example:

7.5

steps

integer

required

Number of inference steps. The accepted range is model-specific - read info.limits.min_steps / info.limits.max_steps for your model from the Model Selection endpoint before sending the request; a value outside that range is rejected with 422. For the example model Ltxv_13B_0_9_8_Distilled_FP8 the only accepted value is 1.

Required range: x >= 1

Example:

1

frames

integer

required

Number of video frames to generate. The accepted range is model-specific - read info.limits.min_frames / info.limits.max_frames for your model from the Model Selection endpoint before sending the request; a value outside that range is rejected with 422. For the example model Ltxv_13B_0_9_8_Distilled_FP8 the allowed range is 30-120 (default 120).

Required range: x >= 1

Example:

120

fps

integer

required

FPS of generated video. The accepted range is model-specific - read info.limits.min_fps / info.limits.max_fps for your model from the Model Selection endpoint before sending the request; a value outside that range is rejected with 422. For the example model Ltxv_13B_0_9_8_Distilled_FP8 the only accepted value is 30.

Required range: x >= 1

Example:

30

seed

integer

required

Random seed for generation

Example:

42

model

string

required

The model to use for video generation. Available models can be retrieved via the GET /api/v2/models endpoint.

Example:

"Ltxv_13B_0_9_8_Distilled_FP8"

negative_prompt

string | null

Elements to avoid in the generated video

Example:

"blur, darkness, noise"

enhance_prompt

boolean | null

default:false

When true, the prompt is boosted by the inline prompt booster before generation (async pre-step). Requires a prompt-booster guide configured for the model; the boost fee is billed on the job. Rejected with 422 if no guide exists for the model or the account balance cannot cover the boost fee.

webhook_url

string<uri> | null

Optional HTTPS URL to receive webhook notifications for job status changes (processing, completed, failed). Must be HTTPS. Max 2048 characters. See Webhook Documentation for payload structure and authentication details.

Maximum string length: 2048

Example:

"https://your-server.com/webhooks/deapi"

webhook_secret

string | null

Optional per-request HMAC secret (min. 32 chars) used to sign the webhook callback. When present, overrides the account-default webhook secret. Requires webhook_url to also be set.

Required string length: 32 - 255

Example:

"a1b2c3d4e5f60708091a2b3c4d5e6f7081920a1b2c3d4e5f60708091a2b3c4d5"

Response

ID of the inference request.

data

object

Information from success endpoint

Show child attributes

Overview

Images

Videos

Audio

Embeddings

Prompt Enhancement

Utilities

Video Generation

Authorizations

Headers

Body

Response