​
Prerequisites

Keep your API key secret. Do not expose keys in client-side code.

​
1) Install dependencies

Python
pip install requests
JavaScript (Node 18+)
# No extra deps needed for fetch in Node 18+. For older versions, use node-fetch.

​
2) Create your first video (Text-to-Video)

curl -X POST "https://tryvinci.com/api/v1/generate/text-to-video" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene sunset over a calm lake",
    "duration_seconds": 5,
    "aspect_ratio": "16:9"
  }'

​
3) Poll job status

curl -X GET "https://tryvinci.com/api/v1/status/your-request-id" \
  -H "Authorization: Bearer sk-your-api-key-here"

​
Next steps

Authentication

Learn how to properly authenticate your API requests.

Video Generation API

Explore the full video generation API reference.

Billing & Usage

Understand billing and monitor your usage.

Error Handling

Learn how to handle errors gracefully.