AIVidLab API

AI Video & Image Generation API v1.0

Authentication: All endpoints require Authorization: Bearer YOUR_API_KEY header.
Get your API key via /apikey command in @AIVidLab_bot on Telegram.

Endpoints

GET/v1/balance

Check your current token balance.

GET/v1/models

List all available models with pricing info.

POST/v1/video/generate

Submit a video generation job. Returns a task ID for polling.

Body (JSON)

Field	Type	Required	Description
model	string	Yes	Model name (from /v1/models)
prompt	string	Yes	Text prompt describing the video
image_url	string	No	Reference image URL (for i2v/multimodal)
duration	integer	No	Duration in seconds (default: model-specific)
resolution	string	No	e.g. "720p", "1080p"
aspect_ratio	string	No	e.g. "16:9", "9:16", "1:1"

GET/v1/video/{task_id}

Check video generation status. Returns progress, status, and result URL when complete.

POST/v1/image/generate

Submit an image generation job.

Body (JSON)

Field	Type	Required	Description
model	string	Yes	Model name (from /v1/models)
prompt	string	Yes	Text prompt describing the image
aspect_ratio	string	No	e.g. "1:1", "16:9"

GET/v1/image/{task_id}

Check image generation status and get result URL.

Response Format

{
  "task_id": "abc123",
  "status": "processing",  // pending | processing | completed | failed
  "progress": 45,
  "result_url": null,      // URL when completed
  "model": "omni-flash"
}

Error Codes

Code	Meaning
401	Invalid or missing API key
402	Insufficient token balance
422	Invalid request parameters
429	Rate limit exceeded (30 req/min)

Rate Limits

30 requests per minute per API key. Exceeded requests return 429.