This tutorial expands on the Quickstart by adding helpful context, checks, and best practices.

​
1) Create an API key and add credits

Authorization header
Authorization: Bearer sk-your-api-key-here
Warning Never store API keys in client-side code. Use environment variables or a secret manager.

​
2) Make your first generation request (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 the status endpoint

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

​
4) Common issues and tips

  • 401 Unauthorized → Check Authorization header
  • 402 Insufficient balance → Add credits
  • 429 Rate limit → Backoff and retry
  • Keep prompts clear and concise
  • Use shorter durations for tests
For comprehensive guidance on writing effective prompts, see the Prompting Guides. These guides cover fundamental principles, text-to-image techniques, and image-to-image workflows that will help you get better results from all Vinci services.

​
Next Steps