Create video

POST

videos

Together AI SDK (Python)

from together import Together
import os

client = Together(
    api_key=os.environ.get("TOGETHER_API_KEY"),
)

response = client.videos.create(
    model="minimax/video-01-director",
    prompt="A cartoon of an astronaut riding a horse on the moon"
)

print(response.id)

import Together from "together-ai";

const client = new Together({
  apiKey: process.env.TOGETHER_API_KEY,
});

const response = await client.videos.create({
  model: "minimax/video-01-director",
  prompt: "A cartoon of an astronaut riding a horse on the moon",
});

console.log(response.id);

import Together from "together-ai";

const client = new Together({
  apiKey: process.env.TOGETHER_API_KEY,
});

const response = await client.videos.create({
  model: "minimax/video-01-director",
  prompt: "A cartoon of an astronaut riding a horse on the moon",
});

console.log(response.id);

curl --request POST \
  --url https://api.together.ai/v2/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "height": 123,
  "width": 123,
  "resolution": "<string>",
  "ratio": "<string>",
  "seconds": "<string>",
  "fps": 123,
  "steps": 30,
  "seed": 123,
  "guidance_scale": 123,
  "output_quality": 123,
  "negative_prompt": "<string>",
  "generate_audio": true,
  "media": {
    "frame_images": [
      {
        "input_image": "<string>",
        "frame": 123
      }
    ],
    "frame_videos": [
      {
        "video": "<string>"
      }
    ],
    "reference_images": [
      "<string>"
    ],
    "reference_videos": [
      {
        "video": "<string>"
      }
    ],
    "source_video": "<string>",
    "audio_inputs": [
      "<string>"
    ]
  }
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.together.ai/v2/videos",
  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>',
    'height' => 123,
    'width' => 123,
    'resolution' => '<string>',
    'ratio' => '<string>',
    'seconds' => '<string>',
    'fps' => 123,
    'steps' => 30,
    'seed' => 123,
    'guidance_scale' => 123,
    'output_quality' => 123,
    'negative_prompt' => '<string>',
    'generate_audio' => true,
    'media' => [
        'frame_images' => [
                [
                                'input_image' => '<string>',
                                'frame' => 123
                ]
        ],
        'frame_videos' => [
                [
                                'video' => '<string>'
                ]
        ],
        'reference_images' => [
                '<string>'
        ],
        'reference_videos' => [
                [
                                'video' => '<string>'
                ]
        ],
        'source_video' => '<string>',
        'audio_inputs' => [
                '<string>'
        ]
    ]
  ]),
  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://api.together.ai/v2/videos"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"height\": 123,\n  \"width\": 123,\n  \"resolution\": \"<string>\",\n  \"ratio\": \"<string>\",\n  \"seconds\": \"<string>\",\n  \"fps\": 123,\n  \"steps\": 30,\n  \"seed\": 123,\n  \"guidance_scale\": 123,\n  \"output_quality\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"generate_audio\": true,\n  \"media\": {\n    \"frame_images\": [\n      {\n        \"input_image\": \"<string>\",\n        \"frame\": 123\n      }\n    ],\n    \"frame_videos\": [\n      {\n        \"video\": \"<string>\"\n      }\n    ],\n    \"reference_images\": [\n      \"<string>\"\n    ],\n    \"reference_videos\": [\n      {\n        \"video\": \"<string>\"\n      }\n    ],\n    \"source_video\": \"<string>\",\n    \"audio_inputs\": [\n      \"<string>\"\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(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.together.ai/v2/videos")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"height\": 123,\n  \"width\": 123,\n  \"resolution\": \"<string>\",\n  \"ratio\": \"<string>\",\n  \"seconds\": \"<string>\",\n  \"fps\": 123,\n  \"steps\": 30,\n  \"seed\": 123,\n  \"guidance_scale\": 123,\n  \"output_quality\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"generate_audio\": true,\n  \"media\": {\n    \"frame_images\": [\n      {\n        \"input_image\": \"<string>\",\n        \"frame\": 123\n      }\n    ],\n    \"frame_videos\": [\n      {\n        \"video\": \"<string>\"\n      }\n    ],\n    \"reference_images\": [\n      \"<string>\"\n    ],\n    \"reference_videos\": [\n      {\n        \"video\": \"<string>\"\n      }\n    ],\n    \"source_video\": \"<string>\",\n    \"audio_inputs\": [\n      \"<string>\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"height\": 123,\n  \"width\": 123,\n  \"resolution\": \"<string>\",\n  \"ratio\": \"<string>\",\n  \"seconds\": \"<string>\",\n  \"fps\": 123,\n  \"steps\": 30,\n  \"seed\": 123,\n  \"guidance_scale\": 123,\n  \"output_quality\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"generate_audio\": true,\n  \"media\": {\n    \"frame_images\": [\n      {\n        \"input_image\": \"<string>\",\n        \"frame\": 123\n      }\n    ],\n    \"frame_videos\": [\n      {\n        \"video\": \"<string>\"\n      }\n    ],\n    \"reference_images\": [\n      \"<string>\"\n    ],\n    \"reference_videos\": [\n      {\n        \"video\": \"<string>\"\n      }\n    ],\n    \"source_video\": \"<string>\",\n    \"audio_inputs\": [\n      \"<string>\"\n    ]\n  }\n}"

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

{
  "id": "<string>",
  "model": "<string>",
  "status": "in_progress",
  "created_at": 123,
  "size": "<string>",
  "seconds": "<string>",
  "object": "video",
  "completed_at": 123,
  "error": {
    "message": "<string>",
    "code": "<string>"
  },
  "outputs": {
    "cost": 123,
    "video_url": "<string>"
  }
}

Authorizations

Authorization

string

header

default:default

required

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

Body

application/json

Parameters for creating a new video generation job.

model

string

required

The model to be used for the video creation request.

prompt

string

Text prompt that describes the video to generate.

Required string length: 1 - 32000

height

integer

width

integer

resolution

string

Video resolution.

ratio

string

Aspect ratio of the video.

seconds

string

Clip duration in seconds.

fps

integer

Frames per second. Defaults to 24.

steps

integer

The number of denoising steps the model performs during video generation. More steps typically result in higher quality output but require longer processing time.

Required range: 10 <= x <= 50

seed

integer

Seed to use in initializing the video generation. Using the same seed allows deterministic video generation. If not provided a random seed is generated for each request.

guidance_scale

integer

Controls how closely the video generation follows your prompt. Higher values make the model adhere more strictly to your text description, while lower values allow more creative freedom. guidence_scale affects both visual content and temporal consistency.Recommended range is 6.0-10.0 for most video models. Values above 12 may cause over-guidance artifacts or unnatural motion patterns.

output_format

enum<string>

Specifies the format of the output video. Defaults to MP4.

Available options:

MP4,

WEBM

output_quality

integer

Compression quality. Defaults to 20.

negative_prompt

string

Similar to prompt, but specifies what to avoid instead of what to include

generate_audio

boolean

Whether to generate audio for the video.

media

object

Media inputs for video generation. The accepted fields depend on the model type (e.g. i2v, r2v, t2v, videoedit).

Show child attributes

Response

200 - application/json

Success

Structured information describing a generated video job.

string

required

Unique identifier for the video job.

model

string

required

The video generation model that produced the job.

status

enum<string>

required

Current lifecycle status of the video job.

Available options:

in_progress,

completed,

failed

created_at

number

required

Unix timestamp (seconds) for when the job was created.

size

string

required

The resolution of the generated video.

seconds

string

required

Duration of the generated clip in seconds.

object

any

The object type, which is always video.

completed_at

number

Unix timestamp (seconds) for when the job completed, if finished.

error

object

Error payload that explains why generation failed, if applicable.

Show child attributes

outputs

object

Available upon completion, the outputs provides the cost charged and the hosted url to access the video

Show child attributes

⌘I

Together AI SDK (Python)

from together import Together
import os

client = Together(
    api_key=os.environ.get("TOGETHER_API_KEY"),
)

response = client.videos.create(
    model="minimax/video-01-director",
    prompt="A cartoon of an astronaut riding a horse on the moon"
)

print(response.id)

import Together from "together-ai";

const client = new Together({
  apiKey: process.env.TOGETHER_API_KEY,
});

const response = await client.videos.create({
  model: "minimax/video-01-director",
  prompt: "A cartoon of an astronaut riding a horse on the moon",
});

console.log(response.id);

import Together from "together-ai";

const client = new Together({
  apiKey: process.env.TOGETHER_API_KEY,
});

const response = await client.videos.create({
  model: "minimax/video-01-director",
  prompt: "A cartoon of an astronaut riding a horse on the moon",
});

console.log(response.id);

curl --request POST \
  --url https://api.together.ai/v2/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "height": 123,
  "width": 123,
  "resolution": "<string>",
  "ratio": "<string>",
  "seconds": "<string>",
  "fps": 123,
  "steps": 30,
  "seed": 123,
  "guidance_scale": 123,
  "output_quality": 123,
  "negative_prompt": "<string>",
  "generate_audio": true,
  "media": {
    "frame_images": [
      {
        "input_image": "<string>",
        "frame": 123
      }
    ],
    "frame_videos": [
      {
        "video": "<string>"
      }
    ],
    "reference_images": [
      "<string>"
    ],
    "reference_videos": [
      {
        "video": "<string>"
      }
    ],
    "source_video": "<string>",
    "audio_inputs": [
      "<string>"
    ]
  }
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.together.ai/v2/videos",
  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>',
    'height' => 123,
    'width' => 123,
    'resolution' => '<string>',
    'ratio' => '<string>',
    'seconds' => '<string>',
    'fps' => 123,
    'steps' => 30,
    'seed' => 123,
    'guidance_scale' => 123,
    'output_quality' => 123,
    'negative_prompt' => '<string>',
    'generate_audio' => true,
    'media' => [
        'frame_images' => [
                [
                                'input_image' => '<string>',
                                'frame' => 123
                ]
        ],
        'frame_videos' => [
                [
                                'video' => '<string>'
                ]
        ],
        'reference_images' => [
                '<string>'
        ],
        'reference_videos' => [
                [
                                'video' => '<string>'
                ]
        ],
        'source_video' => '<string>',
        'audio_inputs' => [
                '<string>'
        ]
    ]
  ]),
  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://api.together.ai/v2/videos"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"height\": 123,\n  \"width\": 123,\n  \"resolution\": \"<string>\",\n  \"ratio\": \"<string>\",\n  \"seconds\": \"<string>\",\n  \"fps\": 123,\n  \"steps\": 30,\n  \"seed\": 123,\n  \"guidance_scale\": 123,\n  \"output_quality\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"generate_audio\": true,\n  \"media\": {\n    \"frame_images\": [\n      {\n        \"input_image\": \"<string>\",\n        \"frame\": 123\n      }\n    ],\n    \"frame_videos\": [\n      {\n        \"video\": \"<string>\"\n      }\n    ],\n    \"reference_images\": [\n      \"<string>\"\n    ],\n    \"reference_videos\": [\n      {\n        \"video\": \"<string>\"\n      }\n    ],\n    \"source_video\": \"<string>\",\n    \"audio_inputs\": [\n      \"<string>\"\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(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.together.ai/v2/videos")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"height\": 123,\n  \"width\": 123,\n  \"resolution\": \"<string>\",\n  \"ratio\": \"<string>\",\n  \"seconds\": \"<string>\",\n  \"fps\": 123,\n  \"steps\": 30,\n  \"seed\": 123,\n  \"guidance_scale\": 123,\n  \"output_quality\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"generate_audio\": true,\n  \"media\": {\n    \"frame_images\": [\n      {\n        \"input_image\": \"<string>\",\n        \"frame\": 123\n      }\n    ],\n    \"frame_videos\": [\n      {\n        \"video\": \"<string>\"\n      }\n    ],\n    \"reference_images\": [\n      \"<string>\"\n    ],\n    \"reference_videos\": [\n      {\n        \"video\": \"<string>\"\n      }\n    ],\n    \"source_video\": \"<string>\",\n    \"audio_inputs\": [\n      \"<string>\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"height\": 123,\n  \"width\": 123,\n  \"resolution\": \"<string>\",\n  \"ratio\": \"<string>\",\n  \"seconds\": \"<string>\",\n  \"fps\": 123,\n  \"steps\": 30,\n  \"seed\": 123,\n  \"guidance_scale\": 123,\n  \"output_quality\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"generate_audio\": true,\n  \"media\": {\n    \"frame_images\": [\n      {\n        \"input_image\": \"<string>\",\n        \"frame\": 123\n      }\n    ],\n    \"frame_videos\": [\n      {\n        \"video\": \"<string>\"\n      }\n    ],\n    \"reference_images\": [\n      \"<string>\"\n    ],\n    \"reference_videos\": [\n      {\n        \"video\": \"<string>\"\n      }\n    ],\n    \"source_video\": \"<string>\",\n    \"audio_inputs\": [\n      \"<string>\"\n    ]\n  }\n}"

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

{
  "id": "<string>",
  "model": "<string>",
  "status": "in_progress",
  "created_at": 123,
  "size": "<string>",
  "seconds": "<string>",
  "object": "video",
  "completed_at": 123,
  "error": {
    "message": "<string>",
    "code": "<string>"
  },
  "outputs": {
    "cost": 123,
    "video_url": "<string>"
  }
}

TOGETHER APIS

SDK LIBRARIES

ERROR CODES

Authorizations

Body

Response