DashboardExplore modelsQuick startDocumentationPricing
Playground
API keysAnalyticsBilling
Contact salesStatus
Studio1MCP2API3
DashboardExplore modelsQuick startDocumentationPricing
Playground
API keysAnalyticsBilling
Contact salesStatus
Explore/Sume/Director Studio 1.0
Videofrom$0.10285 / s

Director Studio 1.0

A directed clip from one prompt: planned shots, a look and a sound bed, with film-setup, camera, lighting and palette settings and up to 50 image, video and audio references · 480p to 1080p · 4–30 s

text_to_videoreference_to_videoeditextend
View docs
curl -X POST https://api.sume.com/v1/sume/director-studio/1.0 \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"On a misty mountain lake at sunrise, a woman in a red canoe paddles through drifting fog toward a lone wooden boathouse; a grey heron lifts off from the reeds beside her, and golden light breaks over the peaks as she glides up to the dock.","duration":10,"resolution":"720p","aspect_ratio":"16:9","generate_audio":true}'
PlaygroundAPIRequestsAnalytics

Input

prompt What happens, in any language. References are named <<<image_1>>>, <<<video_1>>>, <<<audio_1>>>…
image_urls Up to 30 images (HTTPS): people, places, objects or a look.
Drop images here, or click to choose
Additional settings

Customize your input with more control.

Pricing…

Result Example

Example output of the input shown, made with Director Studio 1.0 on Sume. Opening the playground does not charge; Run bills your Sume API balance at the price shown.

Table of contents

About

A directed clip from one prompt: planned shots, a look and a sound bed, with film-setup, camera, lighting and palette settings and up to 50 image, video and audio references · 480p to 1080p · 4–30 s

Model id sume-director-studio-1, sent to POST https://api.sume.com/v1/sume/director-studio/1.0.

1. Calling the API

Install the client

npm install @sume-com/client

Setup your API key

Set SUME_API_KEY as an environment variable in your server runtime. Make the key in Sume API → API keys.

export SUME_API_KEY="YOUR_API_KEY"

Submit a request

This sends the Playground's request, with the input it holds now. Change the input there and this updates. subscribe submits it, waits for the job and returns the result.

import { createSumeClient } from "@sume-com/client";

const sume = createSumeClient({ baseURL: "https://api.sume.com" });

const response = await sume.subscribe("/v1/sume/director-studio/1.0", {
  input: {
    "prompt": "On a misty mountain lake at sunrise, a woman in a red canoe paddles through drifting fog toward a lone wooden boathouse; a grey heron lifts off from the reeds beside her, and golden light breaks over the peaks as she glides up to the dock.",
    "duration": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
});

console.log(response.status, response.video?.url);

2. Authentication

API key

Send your Sume API key as a bearer token from server code only. Keys made under Sume API → API keys spend the workspace balance, the same one Studio spends, and call the model API only.

Authorization: Bearer $SUME_API_KEY

3. Queue

A submit answers at once with the job. Poll its status until it is completed, failed or canceled. Failed and canceled jobs are refunded.

Fetch request status

const response = await fetch(`https://api.sume.com/v1/jobs/${jobId}/status`, {
  headers: { authorization: `Bearer ${process.env.SUME_API_KEY}` },
});
const { data: job } = await response.json();

Get the result

A completed job returns its media. A queued or running job answers 409 job_not_completed with the current status; a failed one 409 job_failed with the reason, and a canceled one 409 job_canceled.

const response = await fetch(`https://api.sume.com/v1/jobs/${jobId}/result`, {
  headers: { authorization: `Bearer ${process.env.SUME_API_KEY}` },
});
const { data: result } = await response.json();

Cancel a request

A job can be canceled until generation starts.

const response = await fetch(`https://api.sume.com/v1/jobs/${jobId}/cancel`, {
  method: "POST",
  headers: { authorization: `Bearer ${process.env.SUME_API_KEY}` },
});
const { data: job } = await response.json();

4. Files

Hosted files (URL)

Fields that end in _url or _urls take public HTTPS URLs. Some hosts block or rate-limit fetches from servers.

Uploading files

Upload a local file to Sume's storage, then send the URL it returns.

import { readFile } from "node:fs/promises";
import { createSumeClient } from "@sume-com/client";

const sume = createSumeClient({ baseURL: "https://api.sume.com" });

const url = await sume.uploadImage(await readFile("input.png"), "png");

5. Schema

Input

modelstringrequired
"sume-director-studio-1"
promptstringrequired
What happens, in any language. References are named <<<image_1>>>, <<<video_1>>>, <<<audio_1>>>…
durationinteger
Length in seconds, 4–30.Default value: 5Range: 4–30
resolutionstring
Output resolution.Default value: "720p"Possible enum values: 480p, 720p, 1080p
aspect_ratiostring
Frame shape.Default value: "16:9"Possible enum values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9
generate_audioboolean
Generate a soundtrack with the video.Default value: true
image_urlsstring[]
Up to 30 images (HTTPS): people, places, objects or a look.Range: 0–30
video_urlsstring[]
Up to 10 reference clips (HTTPS).Range: 0–10
audio_urlsstring[]
Up to 10 audio files (HTTPS).Range: 0–10
{
  "model": "sume-director-studio-1",
  "prompt": "On a misty mountain lake at sunrise, a woman in a red canoe paddles through drifting fog toward a lone wooden boathouse; a grey heron lifts off from the reeds beside her, and golden light breaks over the peaks as she glides up to the dock.",
  "duration": 10,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}

Output

data.result.artifactsArtifact[]required
The generated media, in order.
data.jobJobrequired
The job record: id, status, model, input, created_at, started_at and completed_at.

Artifact

urlstringrequired
Public Sume CDN URL for the file. Do not parse the path.
typestringrequired
image, video, audio, model or file.
content_typestringrequired
The file's MIME type.
idstringrequired
Opaque artifact id, safe to log.
widthinteger
Pixels, when known.
heightinteger
Pixels, when known.
duration_msinteger
Length of a video or audio file, when known.
size_bytesinteger
File size, when known.

6. Price before you submit

The estimate is the charge: the same function prices both. This one prices the Playground's input.

const response = await fetch("https://api.sume.com/v1/open/estimate", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "model": "sume-director-studio-1",
    "input": {
      "prompt": "On a misty mountain lake at sunrise, a woman in a red canoe paddles through drifting fog toward a lone wooden boathouse; a grey heron lifts off from the reeds beside her, and golden light breaks over the peaks as she glides up to the dock.",
      "duration": 10,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }),
});
const { data } = await response.json();
console.log(data.usd);

Full reference: /docs

Request history

Updating while a run is going

No requests

Loading this model's requests…

Analytics

Total requests—No requests
Execution p50—No requests
Execution p75—No requests
Execution p90—No requests
Execution p95—No requests
Execution p99—No requests
Success rate—No requests
Startup p50—No requests
Startup p75—No requests
Startup p90—No requests
Startup p95—No requests
Startup p99—No requests

Request counts

Completed 0Failed 0

Loading this model's requests…

End-to-end latency

Total time from request received to response sent.

No latency data available for this time range.

Recent errors

IDWhenTotal timeStatus
No requests foundThere are no requests that match the criteria

Slower requests

IDWhenTotal timeStatus
No requests foundThere are no requests that match the criteria

Pricing

Dollars per unit at each option, from our rate card; a request rounds up to $0.0001. The estimate above is the exact charge.

OptionPrice
480p · per output second$0.10285 / s
720p · per output second$0.23115 / s
1080p · per output second$0.5686 / s

More models by Sume

Price, resolution and duration show each model's full range.

ModelTypePriceResolutionDuration
Remix Motion Transfervideo$0.1230 – $0.6804 / s480p – 1080p4 – 15 s
Remix Object Swapvideo$0.1230 – $0.6804 / s480p – 1080p4 – 15 s
Remix Restylevideo$0.1230 – $0.6804 / s480p – 1080p4 – 15 s
Remix Lite Motion Transfervideo$0.1000 – $0.4000 / s480p – 1080p4 – 15 s
Remix Lite Object Swapvideo$0.1000 – $0.4000 / s480p – 1080p4 – 15 s
Director Cast 1.0image$0.1540 – $0.3040 / image2k – 4k—
Director Locations 1.0image$0.0358 – $0.1031 / image2k – 4k—
Director Cinema 1.0image$0.0200 – $0.0350 / image1.5k – 2k—
Video Background Removervideo$0.0100 / s—1 – 600 s
Video Relightervideo$0.0200 – $0.1000 / s480p – 1080p1 – 600 s