Source: https://ailoot.ai/models/en/minimaxi-t2v-01-director/
Canonical: https://ailoot.ai/models/en/minimaxi-t2v-01-director/
Language: en

# MiniMax: T2V 01 Director

[Markdown](https://ailoot.ai/models/en/minimaxi-t2v-01-director/index.md) · [JSON](https://ailoot.ai/models/en/minimaxi-t2v-01-director/facts.json)

## [MiniMax: T2V 01 Director](https://ailoot.ai/models/en/minimaxi-t2v-01-director/)

T2V 01 Director creates video from text with explicit camera commands. Plan the subject and action, then use documented truck, pan, push, tilt, zoom, tracking or static-shot instructions to shape the camera’s movement through the scene.

- [**Ailoot Ultra · Video** `POST /v1/videos` `minimaxi-t2v-01-director`](https://ailoot.ai/models/en/minimaxi-t2v-01-director/#method-0)

About the model

This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.

T2V 01 Director is MiniMax’s text-to-video edition with documented camera-movement commands. A written prompt establishes the scene and action, while bracketed instructions describe how the camera should move. Use this edition when the shot needs a particular reveal, approach, follow or change of viewpoint to make the scene understandable.

Start with the visual event. A person crossing a courtyard, a small object being placed on a workbench or a vehicle arriving at a doorway can each form one coherent shot. Describe the main subject, the setting and the action in a readable sequence. Then choose the camera movement that shows the important detail rather than adding movement only for its own sake.

The maker documents fifteen commands covering truck, pan, push and pull, pedestal, tilt, zoom, shake, tracking and a static shot. Their spelling is explicit, such as \[Push in\], \[Pan left\] or \[Static shot\]. Keep the distinction between the subject’s movement and the camera’s movement clear: the subject can cross the frame while the camera stays still, or the camera can follow while maintaining the subject’s position in view.

Several commands inside one pair of square brackets request simultaneous movement. Commands placed at successive points in the description request a sequence. The maker recommends combining no more than three movements. Place the command where its effect should begin and state the action that happens with it, so the requested camera work is tied to a visible moment in the shot.

The prompt supports up to 2,000 characters. Use the available text for subject appearance, scene relationships, action and framing. A brief can establish an object on a table, request an approach that reveals its surface and finish on a stable view. Keep the ending useful for the intended edit, especially when the next shot needs to continue from a recognizable composition.

The maker’s legacy text-to-video table lists 720P as the default for T2V 01 Director and does not list a ten-second option for this edition. Six seconds is the documented duration default. Choose a shot plan with enough time for the action and requested camera change, then inspect the actual pacing of the completed clip.

Automatic prompt optimization is enabled by default in the maker’s workflow and can be disabled for closer control of the written description. Record the setting with the exact camera commands when comparing versions. Keep a successful scene description stable while refining a camera move, or retain the camera plan while changing the action that needs correction.

Review the completed sequence for camera direction, framing and subject continuity. Check whether a reveal exposes the intended detail and whether the camera stops or continues as the brief requires. Save the actual video with the prompt and settings, then revise the concrete mismatch observed in the result. This keeps the Director edition’s camera controls connected to the shot’s purpose and makes comparisons between candidate clips easier to judge.

**Ailoot Ultra · Video** `POST /v1/videos` `minimaxi-t2v-01-director`

[`minimaxi-t2v-01-director`](https://ailoot.ai/models/en/#m=minimaxi-t2v-01-director&route=Ultra&caller=minimaxi-t2v-01-director&fmt=videos)

MiniMax /`minimaxi-t2v-01-director`

### Overview

T2V 01 Director creates video from text with explicit camera commands. Plan the subject and action, then use documented truck, pan, push, tilt, zoom, tracking or static-shot instructions to shape the camera’s movement through the scene.

Accepted inputs

Text

Results

Video

### Available in Ailoot · inputs & methods

**Ailoot Ultra · Video** `POST /v1/videos`

Input types

`text`

Output types

`video`

| Field | Type | Requirement | Values & limits | Default |
| --- | --- | --- | --- | --- |
| Field`model` | Type`string` | RequirementRequired | Values & limits minimaxi-t2v-01-director Conditions: Use the exact Ailoot model selector. | Default— |
| Field`prompt` | Type`string` | RequirementRequired | Values & limits Conditions: Describe the scene and motion. | Default— |

Method parameters and lifecycle

| Parameter | Contract |
| --- | --- |
| Parameter`content_type` | Contractapplication/json |
| Parameter`required` | Contractmodel, prompt |
| Parameter`optional` | Contract |
| Parameter`material_types` | Contracttext |
| Parameter`conditions` | ContractUse the exact Ailoot model selector., Describe the scene and motion. |

Method aliases: `/v1/videos/generations`

Lifecycle: `submit_once_poll_original`

`GET /v1/videos/{request_id}`

`GET /v1/videos/generations/{request_id}`

`GET /v1/videos/{request_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

### Pricing

##### How the final charge is calculated

The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.

Tariff references do not add request options. Supported parameters are listed for the selected method.

Fast mode

Not specified When fast mode is selected

Flex mode

Not specified When flex mode is selected

Maximum reasoning effort

Not specified When maximum reasoning effort uses the default adjustment

#### Estimated rates for comparison

#### Prices by configuration

Match each charge to the conditions shown. Use one rate for each set of alternative configurations.

| Configuration | Rate schedule | Forecast quantity | Billing quantity | Charge |
| --- | --- | --- | --- | --- |
| ConfigurationBase token rates | Rate scheduleBase rate | Forecast quantity— | Billing quantity— | Charge Input · Input tokens · Estimate for comparison only **—** / 1K tokens Output · Output tokens · Estimate for comparison only **—** / 1K tokens Input · Cache read · Estimate for comparison only **—** / 1K tokens Input · Cache write · Estimate for comparison only **—** / 1K tokens Input · Cache write, 1 hour · Estimate for comparison only **—** / 1K tokens |
| ConfigurationPer request | Rate schedule— | Forecast quantity— | Billing quantityone request | Charge Input · Estimate for comparison only **$1** per request |
| ConfigurationEstimated generation cost | Rate schedule— | Forecast quantityone generation estimate | Billing quantity— | Charge Output · Estimated generation cost · Estimate for comparison only **$1** estimate before generation This estimate is not an additional charge or a fixed rate for the completed generation. |

Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. [How reservation and settlement work →](https://ailoot.ai/docs/en/billing/reserve/)

### Example requests

#### Ailoot Ultra · Video

curl · create once and retain receiptRead the original taskSave every completed owned asset

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "minimaxi-t2v-01-director",
  "prompt": "A cat is walking on grass."
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
```

### Receive and save results

#### Ailoot Ultra · Video

- `GET /v1/videos/{request_id}`
- `GET /v1/videos/generations/{request_id}`
- `GET /v1/videos/{request_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

##### Keep all completed results

Save every completed video or returned file; retrieve every actual returned asset URL.

Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.

##### If the original response needs checking

Keep the returned public task or operation id and all headers. Read only the original task; unknown or result\_pending\_check does not authorize another creation.

Response fields

| Field | Type |
| --- | --- |
| Field`id` | Typestring |
| Field`polling_url` | Typestring |
| Field`provider_task_id` | Typestring |
| Field`task_id` | Typestring |
| Field`status` | Typestring |
| Field`video_url` | Typestring |

### Aliases

#### Model aliases

**Ailoot Ultra** [`minimaxi-t2v-01-director`](https://ailoot.ai/models/en/#m=minimaxi-t2v-01-director&route=Ultra&caller=minimaxi-t2v-01-director&fmt=videos)

#### Method path aliases

`/v1/videos/generations`

#### Related caller IDs

[`minimaxi-t2v-01-director`](https://ailoot.ai/models/en/#m=minimaxi-t2v-01-director&route=Ultra&caller=minimaxi-t2v-01-director&fmt=videos)

FAQ · MiniMax: T2V 01 Director

What inputs and results are available?

`POST /v1/videos` · `minimaxi-t2v-01-director`: `text` → `video`

Which fields does the request use?

`POST /v1/videos` · `minimaxi-t2v-01-director`: `model`, `prompt`

Connect Ailoot to Claude Code, OpenCode, Hermes or your own app.

## The company and its project portfolio

The company and its project portfolio: millions of customers; monthly sales in the billions.

## Buy tokens at a discount.

Subscription discounts for regular use. Promo codes offer up to 50% off token purchases.

Subscription

Choose a discounted plan for your regular requests.

Promo code: up to 50% off

Enter your code at checkout. The price updates to reflect the current promotion.

Spending in your history

The model, tokens and amount are recorded for each request.

[Choose a subscription](https://ailoot.ai/docs/en/billing/subscriptions/) · [View model prices](https://ailoot.ai/models/en/)

## Connect the API to a product you sell.

Use Ailoot in SaaS, apps and bots under its official service offer and licence agreement. Request a reseller licence for resale.

Commercial application

Add text, image, video and audio generation to paid features in your service.

Reseller licence

Send a description of your project and how you provide access. Request written terms for use and resale.

Documents on the website

The service offer, licence agreement and data processing policy are available before you connect.

[Request a reseller licence](mailto:support@ailoot.ai) · [Service offer and licence agreement](https://ailoot.ai/legal/offer?lang=en)

## Ailoot · The company and its project portfolio





Ailoot combines established operating experience, a large client base, stable service and ongoing KPI control.





The company and its project portfolio: millions of customers; monthly sales in the billions.





Ailoot brings that operating experience to API access for AI features in customer products, agents, applications and automations.
