MakeUGC Platform API Documentation

X-Api-Key: YOUR_API_KEY

https://app.makeugc.ai/api/platform

Generate Video

Creates a new AI video with specified avatar and voice script.

POST /video/generate

Request Body:

{
  "avatar_id": "string",     // Required: ID of the avatar to use
  "voice_script": "string",  // Required: Script for the voice (max 1000 chars)
  "video_name": "string",    // Optional: Custom name for the video (defaults to "API Generated Video")
  "voice_settings": {        // Optional: Voice generation settings
    "stability": 0.75,       // Range: 0-1
    "similarity_boost": 0.4, // Range: 0-1
    "style": 0,             // Range: 0-1
    "use_speaker_boost": true
  }
}

Response:

{
  "status": true,
  "message": "Video generation started",
  "data": {
    "id": "video_123"  // Use this ID to check video status
  }
}

Status Codes:

• 200 Success
• 400 Missing required fields or invalid input
• 401 Not authenticated
• 404 Avatar or voice not found
• 500 Server error

Check Video Status

Check the status of a video generation request.

GET /video/status

Query Parameters:

• id: Video ID (required)

Response:

{
  "status": true,
  "message": "Video is processing",
  "data": {
    "status": "processing" | "completed" | "failed",
    "url": "https://..." // Present when status is "completed"
  }
}

Status Codes:

• 200 Success
• 400 Missing video ID
• 401 Not authenticated
• 404 Video not found
• 500 Server error

Get Available Avatars

Retrieve a list of available avatars (both template and custom).

GET /video/avatars

Query Parameters:

• gender: Filter avatars by gender (optional) - "Male" or "Female"

Response:

{
  "status": true,
  "message": "Avatars fetched",
  "data": [
    {
      "id": "avatar_123",
      "name": "Avatar Name",
      "thumbnail": "https://...",
      "gender": "Male"
    }
  ]
}

Status Codes:

• 200 Success
• 401 Not authenticated
• 500 Server error