API Documentation

Quick Start

Base URL:

https://vidforgeai.net

All API requests require authentication using a JWT token. Include the token in the Authorization header:

Authorization: Bearer <your_jwt_token>

Authentication

Register User

POST /api/auth/register

{
  "full_name": "John Doe",
  "email": "user@example.com",
  "password": "SecurePass123"
}

Login

POST /api/auth/login

{
  "email": "user@example.com",
  "password": "SecurePass123"
}

Video Generation

Generate Video

POST /api/videos/generate

{
  "source_type": "url",
  "source_value": "https://example.com/product",
  "duration": 30,
  "voice_id": "EXAVITQu4vr4xnSDxMaL",
  "aspect_ratio": "16:9"
}

Source Types: url, image, prompt
Durations: 8, 15, 30, 60 (seconds)
Aspect Ratios: 16:9, 9:16, 1:1

Check Video Status

GET /api/videos/{id}/status

List Videos

GET /api/videos

Subscriptions

Get Subscription Status

GET /api/subscriptions/status

Create Checkout Session

POST /api/subscriptions/checkout

{
  "plan": "professional"
}

Rate Limits

General API: 100 requests per hour per user
Video Generation: 10 concurrent jobs per user
Admin Users: Unlimited

Error Responses

All errors follow this format:

{
  "success": false,
  "error": "Error message here",
  "errors": {
    "field_name": ["Validation error"]
  }
}

200 - Success

400 - Bad Request

401 - Unauthorized

403 - Forbidden

404 - Not Found

429 - Too Many Requests

500 - Internal Server Error

Full Documentation

For complete API documentation, see:

View Full Documentation