Authentication
All endpoints (except /health) require an API key. Pass it via header or query param:
x-api-key: YOUR_KEY
-- or --
?apikey=YOUR_KEY
🎬 Movie & TV
Search for movies, TV shows, and anime.
qrequired — Search query
typeoptional — movie | tv | anime | all (default: all)
pageoptional — Page number (default: 1)
GET /api/search?q=Avengers&type=movie&apikey=KEY
{
"success": true,
"results": [
{
"subjectId": "tt0848228",
"title": "The Avengers",
"subjectType": "MOVIE",
"detailPath": "/movie/tt0848228",
"releaseDate": "2012-05-04",
"poster": "https://...",
"genre": ["Action", "Adventure"],
"imdbRatingValue": 8.0
}
],
"page": 1,
"hasMore": true
}
Get full details for a movie or show including cast, trailer, and episode list.
detailPathrequired — From search results (e.g. /movie/tt0848228)
GET /api/details?detailPath=/movie/tt0848228&apikey=KEY
{
"success": true,
"title": "The Avengers",
"rating": 8.0,
"genre": ["Action"],
"cast": [...],
"totalSeasons": null,
"episodeList": [],
"trailer": { "embed_url": "https://youtube.com/embed/..." }
}
Get stream URLs and subtitles for a movie or TV episode.
idrequired — Subject ID from search
detailPathrequired — Detail path from search
seasonoptional — Season number (0 for movies)
episodeoptional — Episode number (0 for movies)
GET /api/sources?id=tt0848228&detailPath=/movie/tt0848228&season=0&episode=0&apikey=KEY
{
"success": true,
"streams": [
{
"quality": "1080p",
"stream_url": "https://api.zentrixtech.name.ng/zentrix/stream?token=...",
"player_url": "https://api.zentrixtech.name.ng/zentrix/player?token=...",
"download_url": "https://api.zentrixtech.name.ng/zentrix/download?token=..."
}
],
"subtitles": [{ "language": "en", "languageName": "English", "url": "..." }]
}
Get a YouTube trailer for any movie or show by title.
titlerequired — Movie or show title
yearoptional — Release year
GET /api/trailer?title=Inception&year=2010&apikey=KEY
{
"success": true,
"youtube_id": "YoHD9XEInc0",
"embed_url": "https://www.youtube.com/embed/YoHD9XEInc0",
"thumbnail": "https://..."
}
🎌 Anime
Search for anime titles.
qrequired — Anime title
pageoptional — Page number
GET /api/anime/search?q=Naruto&apikey=KEY
Get episode list and season breakdown for an anime.
titlerequired — Anime title to search
idoptional — Anime ID from search results
urloptional — Anime URL from search results
GET /api/anime/episodes?title=Naruto&apikey=KEY
Get stream URLs for a specific anime episode.
titlerequired — Anime title
ep_numberrequired — Episode number
idoptional — Anime ID from search results
urloptional — Anime URL from search results
ep_idoptional — Episode hash ID (speeds up extraction)
GET /api/anime/stream?title=Naruto&ep_number=1&apikey=KEY
💬 AI Chat
Chat with various AI models using the following endpoints.
Multi-model AI chat (ChatGPT, Claude, Gemini, etc.).
messagerequired — User message
modeloptional — AI model (default: chatgpt)
sessionIdoptional — Session memory ID
GET /api/ai/chat?message=hello&model=chatgpt&apikey=KEY
Direct access to Alibaba's Qwen AI.
messagerequired — User message
sessionIdoptional — Session memory ID
GET /api/ai/qwen?message=hello&apikey=KEY
🎵 AI Media
Generate AI music tracks from text prompts.
Start a music generation job. Returns a taskId.
promptrequired — Music description
GET /api/ai/music?prompt=lofi+hip+hop&apikey=KEY
Poll for the result of a music generation job.
taskIdrequired — Task ID from /api/ai/music
GET /api/ai/music/result?taskId=abc&apikey=KEY
🖼️ AI Image
All image endpoints return a hosted URL on files.zentrixtech.name.ng.
Generate an image from a text prompt.
promptrequired — Description of the image
GET /api/image/generate?prompt=a+cat+in+space&apikey=KEY
{
"success": true,
"image": "https://files.zentrixtech.name.ng/xxx.webp"
}
Transform an image with AI. Returns a task_id — poll /api/image/transform/result to get the output.
imagerequired — Source image URL
promptoptional — Transformation instruction
GET /api/image/transform?image=https://...&prompt=change+background+to+space&apikey=KEY
-- then poll --
GET /api/image/transform/result?task_id=abc&fp=xyz&apikey=KEY
Blend up to 4 images together.
image1required — First image URL
image2–4optional — Additional images
promptoptional — Blending instruction
GET /api/image/blend?image1=https://...&image2=https://...&apikey=KEY
⚡ Proxy
Proxy a video stream. Supports range requests for seeking. Use the stream_url from sources directly — no need to call this manually.
Opens an in-browser HTML5 video player for a stream token. Use the player_url from sources in an iframe or browser tab.
<iframe src="https://api.zentrixtech.name.ng/zentrix/player?token=TOKEN"></iframe>