MiniMax H3 — API reference

1. Calling the API

Send a JSON request to POST /v1/videos using your Lithovas API key. Keep the returned task ID for polling.

curl https://api.seedance.ch/v1/videos \
  -H "Authorization: Bearer $LITHOVAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"minimax/h3/text-to-video","prompt":"A cinematic scene at sunset","duration":5,"resolution":"2K","aspect_ratio":"auto"}'

2. Authentication

Use Authorization: Bearer $LITHOVAS_API_KEY. Store the key on your server, not in frontend code or source control.

Manage API keys

export LITHOVAS_API_KEY="YOUR_API_KEY"

3. Request parameters

These fields match the current H3 Playground preset. Provider-specific support is subject to the exact model becoming available in the live catalog.

Parameter	Type	Required	Description
model	string	Required	minimax/h3/text-to-video
prompt	string	Required	Describe the video to generate.
duration	integer	Optional	The H3 Playground offers 1, 5, 10, or 15 seconds; default 5.
resolution	string	Optional	The H3 Playground preset is 2K.
aspect_ratio	string	Optional	auto, adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16.

4. Results and polling

After a successful submission, poll the returned task ID. Wait for a completed state before downloading. Do not submit a second generation merely because the first is still queued.

curl "https://api.seedance.ch/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $LITHOVAS_API_KEY"

Download the completed result:

curl "https://api.seedance.ch/v1/videos/$TASK_ID/content" \
  -H "Authorization: Bearer $LITHOVAS_API_KEY" \
  -o result.mp4

5. Errors and availability

401: check your API key. 429: wait before retrying. For validation or unavailable-model errors, read the response message and check the catalog. Use Requests to inspect this model’s request history.

This page remains readable even when the model is unavailable; API documentation and Playground generation are separate views.

View model requests