Skip to documentation
Developer docsPython SDK v1.3.0·stdio MCP
Browse documentation

Tutorials

Create your first video

Build a Lisbon → Porto → Braga road-trip animation, review it, and export an MP4.

Package v1.3.0·Reviewed September 29, 2026
On this pageBefore you start1. Create and inspect the route2. Choose the look3. Estimate and review4. Render and follow progress5. Review the result

Before you start

Finish the quickstart and verify the MCP tools. This tutorial requests a 20-second road-trip video; let the server validate duration and rendering support before committing.

1. Create and inspect the route

Ask for a named project and review the returned waypoint order. The assistant should use an explicit project ID throughout the workflow.

Prompt
Check Travel Animator capabilities and sign-in. Create a project named Portugal road trip with Lisbon, Porto, and Braga in that order. Use real roads where supported. Show me the route and project ID. Do not render yet.

2. Choose the look

Choose available maps and models from their catalogues. If your requested style is unavailable, ask the assistant to show alternatives before replacing it.

Prompt
For that project, find the Terrain map and a car in the available catalogues. Apply them with a red route line and a requested duration of 20 seconds. Show me the resulting settings and any validation issues. Do not render yet.

3. Estimate and review

Confirm the stops, map, vehicle, output size, and estimated time. Exporting costs one credit. Check your balance with get_credit_balance; if it is zero, purchase credits before continuing.

Prompt
Inspect this project and estimate the render. Summarize the route, duration, framing, and resolution. Check my credit balance and tell me whether I have the one credit needed to export. Wait for my approval before starting.

4. Render and follow progress

After approving, the assistant starts the render and follows its session. It should report progress while waiting and return the result only when the job has completed.

Prompt
Render the approved project. Use await_render to follow the session and relay progress messages. When it finishes, return the actual MP4 path. If it fails, show the error and stop.

5. Review the result

Open the returned file on the machine that ran the server. Check stop order, labels, line visibility, and pacing. Keep the project ID for edits instead of rebuilding the route.