Misc
Quickstart
Make your first Cludz API request in seconds.
Ready to get started? This guide will show you how to make your first API request to Cludz API.
Prerequisites
Before you begin, ensure you have:
- An API Key: You can obtain one by signing up at our Developer Dashboard.
- HTTP Client:
curl, Postman, or a standard library likefetchin JavaScript/TypeScript.
Base URL
All API requests should be made to:
https://api.cludz.net
Making Your First Request
Let's verify your connection and API key are working correctly.
curl https://api.cludz.net/ \
-H "X-API-Key: YOUR_API_KEY"
const response = await fetch('https://api.cludz.net/', {
headers: {
'X-API-Key': 'YOUR_API_KEY'
}
});
const text = await response.text();
console.log(text); // "Cludz API V1"
Example 1: Download Media
Here is how to fetch metadata and download links for a YouTube video.
curl "https://api.cludz.net/youtube/download?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ" \
-H "X-API-Key: YOUR_API_KEY"
interface MediaResponse {
title: string;
thumbnail: string;
duration: number;
qualities: { quality: string, url: string }[];
}
const response = await fetch(
'https://api.cludz.net/youtube/download?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ',
{
headers: { 'X-API-Key': 'YOUR_API_KEY' }
}
);
const data = await response.json() as MediaResponse;
console.log(data);
Example 2: AI Chat
Engage with our AI endpoints.
curl "https://api.cludz.net/ai/mimo/chat?text=Hello%20World" \
-H "X-API-Key: YOUR_API_KEY"
const response = await fetch(
'https://api.cludz.net/ai/mimo/chat?text=Hello World',
{
headers: { 'X-API-Key': 'YOUR_API_KEY' }
}
);
const data = await response.json();
console.log(data.data); // AI response text