🔌 Vigthoria REST API

Complete API reference for integrating Vigthoria services into your applications. Access AI generation, payments, and platform features.

🔐 Authentication

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

Authorization: Bearer YOUR_API_KEY

Get your API key from your account settings at vigtherius.io/settings/api

🌐 Base URLs

https://api.vigthoria.io/v1 Production

https://sandbox.api.vigthoria.io/v1 Sandbox

💻 ViAgen6 - Vibe Coder

POST /viagen6/build Generate a complete application

Parameter	Type	Description
promptrequired	string	Description of the application to build
framework	string	Framework: react, vue, nextjs, nodejs, python
project_id	string	Continue an existing project
preview	boolean	Enable live preview (default: true)

Response

{
  "id": "build_abc123",
  "status": "completed",
  "files": [...],
  "preview_url": "https://preview.vigthoria.io/xyz",
  "project_id": "proj_xyz789"
}

POST /viagen6/chat ViAgen6 coding conversation

Parameter	Type	Description
messagerequired	string	The message or coding request
context	object	Code context for better responses
conversation_id	string	Continue an existing conversation

GET /viagen6/projects List user's projects

🎵 Music AI

POST /music/generate Generate a music track

Parameter	Type	Description
promptrequired	string	Description of the song to generate
genre	string	Genre: pop, rock, jazz, electronic, etc.
duration	integer	Duration in seconds (30-240)
vocals	object	Vocal settings: {enabled, gender, style}
lyrics	string	Custom lyrics with [Verse]/[Chorus] tags

Response

{
  "id": "music_abc123",
  "status": "processing",
  "estimated_time": 120,
  "queue_position": 3
}

GET /music/{id} Get music generation status and result

GET /music/library List user's generated tracks

🎬 Video Generation

POST /video/generate Generate a video

Parameter	Type	Description
promptrequired	string	Description of the video to generate
type	string	Type: text-to-video, image-to-video, avatar
duration	integer	Duration in seconds (5-60)
resolution	string	Resolution: 720p, 1080p, 4k

GET /video/{id} Get video generation status and result

🖼️ Image Generation

POST /image/generate Generate an image

Parameter	Type	Description
promptrequired	string	Description of the image to generate
size	string	Size: 512x512, 1024x1024, 1536x1024
style	string	Style: realistic, artistic, anime, 3d
count	integer	Number of images (1-4)

💳 Payments (Vigthoria Pay)

POST /payments/checkout Create a checkout session

GET /payments/balance Get user's credit balance

GET /payments/transactions List transaction history

⚠️ Error Codes

Code	Description
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid or missing API key
402	Payment Required - Insufficient credits
403	Forbidden - Access denied to resource
404	Not Found - Resource doesn't exist
429	Too Many Requests - Rate limit exceeded
500	Server Error - Internal error, try again

📊 Rate Limits

Plan	Requests/Minute	Requests/Day
Free	10	100
Pro	60	5,000
Enterprise	1,000	Unlimited