← Back to Home

API Documentation

Integrate TextToReels.in's powerful AI video generation into your applications with our developer-friendly REST API.

🚀 Getting Started

Base URL

https://api.texttoreels.in/v1

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get Your API Key

1. Sign up for a free account at TextToReels.in

2. Go to your dashboard and navigate to API section

3. Generate your API key and start making requests

📊 Rate Limits

🆓

Free Tier

100 requests/month

Basic video quality

⭐

Pro Tier

5,000 requests/month

HD video quality

🚀

Enterprise

Unlimited requests

Custom solutions

🎬 Video Generation

POST /generate

Generate a video from text input with AI

Request Parameters

text (required)
The text content to convert into video. Maximum 500 characters.
language (optional)
Language code (e.g., "hindi", "english", "punjabi"). Default: "english"
platform (optional)
Target platform ("instagram_reels", "youtube_shorts", "whatsapp_status"). Default: "instagram_reels"
style (optional)
Video style ("modern_minimal", "bold_typography", "elegant_script"). Default: "modern_minimal"
emotion (optional)
Emotional tone ("romantic", "inspiring", "happy", "calm"). Default: "inspiring"

Example Request

curl -X POST https://api.texttoreels.in/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "जिंदगी में सफलता पाने के लिए कड़ी मेहनत जरूरी है",
    "language": "hindi",
    "platform": "instagram_reels",
    "style": "bold_typography",
    "emotion": "inspiring"
  }'

Response

{
  "success": true,
  "data": {
    "video_id": "vid_abc123xyz",
    "status": "processing",
    "estimated_time": 30,
    "webhook_url": "https://your-app.com/webhook"
  },
  "message": "Video generation started successfully"
}

📹 Video Status

GET /video/{video_id}

Check the status and get the download URL of a generated video

Example Request

curl -X GET https://api.texttoreels.in/v1/video/vid_abc123xyz \
  -H "Authorization: Bearer YOUR_API_KEY"

Response (Completed)

{
  "success": true,
  "data": {
    "video_id": "vid_abc123xyz",
    "status": "completed",
    "download_url": "https://cdn.texttoreels.in/videos/vid_abc123xyz.mp4",
    "thumbnail_url": "https://cdn.texttoreels.in/thumbs/vid_abc123xyz.jpg",
    "duration": 15,
    "resolution": "1080x1920",
    "file_size": 2048576
  }
}

📋 User Account

GET /account

Get account information including usage and limits

Response

{
  "success": true,
  "data": {
    "user_id": "user_123",
    "plan": "pro",
    "usage": {
      "current_month": 245,
      "limit": 5000,
      "remaining": 4755
    },
    "features": {
      "hd_quality": true,
      "priority_processing": true,
      "webhook_support": true
    }
  }
}

🎨 Supported Options

Languages (50+)

Popular: hindi, english, punjabi, urdu, bengali, tamil, telugu, gujarati, marathi, kannada, malayalam, odia

International: spanish, french, german, portuguese, arabic, chinese, japanese, korean, russian

Platforms

• instagram_reels - 1080x1920, 15-30s

• youtube_shorts - 1080x1920, 15-60s

• whatsapp_status - 1080x1920, 30s

• facebook_stories - 1080x1920, 15s

• tiktok - 1080x1920, 15-60s

Styles

• modern_minimal - Clean, simple design

• bold_typography - Strong, impactful text

• elegant_script - Beautiful, flowing fonts

• gradient_colors - Vibrant gradient backgrounds

• neon_glow - Futuristic neon effects

⚠️ Error Handling

Common Error Codes

400 Bad Request
Invalid parameters or malformed request
401 Unauthorized
Invalid or missing API key
429 Too Many Requests
Rate limit exceeded
500 Internal Server Error
Server error during processing

Error Response Format

{
  "success": false,
  "error": {
    "code": "INVALID_LANGUAGE",
    "message": "Unsupported language code provided",
    "details": "Supported languages: hindi, english, punjabi..."
  }
}

🔗 Webhooks

Get notified when your video generation is complete:

POST /generate
{
  "text": "Your text here",
  "webhook_url": "https://your-app.com/webhook"
}

Webhook Payload

{
  "event": "video.completed",
  "video_id": "vid_abc123xyz",
  "status": "completed",
  "download_url": "https://cdn.texttoreels.in/videos/vid_abc123xyz.mp4"
}

📞 Support

Need help with the API? We're here to assist!

📧 Email: api-support@texttoreels.in

📚 Documentation: docs.texttoreels.in

💬 Developer Chat: Join our Discord community