Back to Home

You're viewing the public documentation

The API key shown below is an example placeholder. After you create an account or log in, the documentation will display your real personal API key.

REST API Reference

Connect directly to our high-performance edge network via standards-based REST endpoints.

Example API Key

This is a placeholder key for demonstration. Log in to see and copy your real key.

gvoice_cloude_token_EXAMPLE_KEY_12345678

Base API URL

https://cloud.gvoice.app/api/

Files Endpoints

Specialized actions for your files collection.

POST

Upload File

https://cloud.gvoice.app/api/upload-file.php

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('api_key', 'gvoice_cloude_token_EXAMPLE_KEY_12345678');
formData.append('reduce_size', 'true');

fetch('https://cloud.gvoice.app/api/upload-file.php', { method: 'POST', body: formData });

const formData = new FormData();
formData.append('file', file);
formData.append('api_key', 'gvoice_cloude_token_EXAMPLE_KEY_12345678');
formData.append('reduce_size', 'true');

await axios.post('https://cloud.gvoice.app/api/upload-file.php', formData);

$data = [
    'file' => new CURLFile('path/to/file'),
    'api_key' => 'gvoice_cloude_token_EXAMPLE_KEY_12345678',
    'reduce_size' => 'true'
];
curl_setopt($ch, CURLOPT_URL, 'https://cloud.gvoice.app/api/upload-file.php');
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

GET

View One File

https://cloud.gvoice.app/api/get-media-details.php

fetch('https://cloud.gvoice.app/api/get-media-details.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678&id=12345');

axios.get('https://cloud.gvoice.app/api/get-media-details.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678&id=12345');

file_get_contents('https://cloud.gvoice.app/api/get-media-details.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678&id=12345');

GET

View All Files

https://cloud.gvoice.app/api/get-files.php

fetch('https://cloud.gvoice.app/api/get-files.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678');

axios.get('https://cloud.gvoice.app/api/get-files.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678');

file_get_contents('https://cloud.gvoice.app/api/get-files.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678');

POST

Delete File

https://cloud.gvoice.app/api/delete-file.php

const formData = new FormData();
formData.append('file_id', '12345');
formData.append('api_key', 'gvoice_cloude_token_EXAMPLE_KEY_12345678');

fetch('https://cloud.gvoice.app/api/delete-file.php', { method: 'POST', body: formData });

axios.post('https://cloud.gvoice.app/api/delete-file.php', { file_id: '12345', api_key: 'gvoice_cloude_token_EXAMPLE_KEY_12345678' });

curl_setopt($ch, CURLOPT_URL, 'https://cloud.gvoice.app/api/delete-file.php');

Images Endpoints

Specialized actions for your images collection.

POST

Upload Image

https://cloud.gvoice.app/api/upload-image.php

const formData = new FormData();
formData.append('image', fileInput.files[0]);
formData.append('api_key', 'gvoice_cloude_token_EXAMPLE_KEY_12345678');
formData.append('reduce_size', 'true');

fetch('https://cloud.gvoice.app/api/upload-image.php', { method: 'POST', body: formData });

const formData = new FormData();
formData.append('image', file);
formData.append('api_key', 'gvoice_cloude_token_EXAMPLE_KEY_12345678');
formData.append('reduce_size', 'true');

await axios.post('https://cloud.gvoice.app/api/upload-image.php', formData);

$data = [
    'image' => new CURLFile('path/to/file'),
    'api_key' => 'gvoice_cloude_token_EXAMPLE_KEY_12345678',
    'reduce_size' => 'true'
];
curl_setopt($ch, CURLOPT_URL, 'https://cloud.gvoice.app/api/upload-image.php');
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

GET

View One Image

https://cloud.gvoice.app/api/get-media-details.php

fetch('https://cloud.gvoice.app/api/get-media-details.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678&id=12345');

axios.get('https://cloud.gvoice.app/api/get-media-details.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678&id=12345');

file_get_contents('https://cloud.gvoice.app/api/get-media-details.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678&id=12345');

GET

View All Images

https://cloud.gvoice.app/api/get-images.php

fetch('https://cloud.gvoice.app/api/get-images.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678');

axios.get('https://cloud.gvoice.app/api/get-images.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678');

file_get_contents('https://cloud.gvoice.app/api/get-images.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678');

POST

Delete Image

https://cloud.gvoice.app/api/delete-file.php

const formData = new FormData();
formData.append('file_id', '12345');
formData.append('api_key', 'gvoice_cloude_token_EXAMPLE_KEY_12345678');

fetch('https://cloud.gvoice.app/api/delete-file.php', { method: 'POST', body: formData });

axios.post('https://cloud.gvoice.app/api/delete-file.php', { file_id: '12345', api_key: 'gvoice_cloude_token_EXAMPLE_KEY_12345678' });

curl_setopt($ch, CURLOPT_URL, 'https://cloud.gvoice.app/api/delete-file.php');

Videos Endpoints

Specialized actions for your videos collection.

POST

Upload Video

https://cloud.gvoice.app/api/upload-video.php

const formData = new FormData();
formData.append('video', fileInput.files[0]);
formData.append('api_key', 'gvoice_cloude_token_EXAMPLE_KEY_12345678');
formData.append('reduce_size', 'true');

fetch('https://cloud.gvoice.app/api/upload-video.php', { method: 'POST', body: formData });

const formData = new FormData();
formData.append('video', file);
formData.append('api_key', 'gvoice_cloude_token_EXAMPLE_KEY_12345678');
formData.append('reduce_size', 'true');

await axios.post('https://cloud.gvoice.app/api/upload-video.php', formData);

$data = [
    'video' => new CURLFile('path/to/file'),
    'api_key' => 'gvoice_cloude_token_EXAMPLE_KEY_12345678',
    'reduce_size' => 'true'
];
curl_setopt($ch, CURLOPT_URL, 'https://cloud.gvoice.app/api/upload-video.php');
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

GET

View One Video

https://cloud.gvoice.app/api/get-media-details.php

fetch('https://cloud.gvoice.app/api/get-media-details.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678&id=12345');

axios.get('https://cloud.gvoice.app/api/get-media-details.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678&id=12345');

file_get_contents('https://cloud.gvoice.app/api/get-media-details.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678&id=12345');

GET

View All Videos

https://cloud.gvoice.app/api/get-videos.php

fetch('https://cloud.gvoice.app/api/get-videos.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678');

axios.get('https://cloud.gvoice.app/api/get-videos.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678');

file_get_contents('https://cloud.gvoice.app/api/get-videos.php?api_key=gvoice_cloude_token_EXAMPLE_KEY_12345678');

POST

Delete Video

https://cloud.gvoice.app/api/delete-file.php

const formData = new FormData();
formData.append('file_id', '12345');
formData.append('api_key', 'gvoice_cloude_token_EXAMPLE_KEY_12345678');

fetch('https://cloud.gvoice.app/api/delete-file.php', { method: 'POST', body: formData });

axios.post('https://cloud.gvoice.app/api/delete-file.php', { file_id: '12345', api_key: 'gvoice_cloude_token_EXAMPLE_KEY_12345678' });

curl_setopt($ch, CURLOPT_URL, 'https://cloud.gvoice.app/api/delete-file.php');

Installation

npm install gvoice-cloud-helper axios

Quick Start

Client Setup

Options

apiKey: string (required)
baseURL?: string default: https://cloud.gvoice.app/api/
timeoutMs?: number default: 30000
axiosConfig?: AxiosRequestConfig
axiosInstance?: AxiosInstance

API Reference

Recommended (uppercase API namespace)

Files
client.API.Files.upload(file, { reduceSize? })
client.API.Files.list()
client.API.Files.get(id)
client.API.Files.delete(fileId)
Images
client.API.Images.upload(file, { reduceSize? })
client.API.Images.list()
client.API.Images.get(id)
client.API.Images.delete(fileId)
Videos
client.API.Videos.upload(file, { reduceSize? })
client.API.Videos.list()
client.API.Videos.get(id)
client.API.Videos.delete(fileId)

Also available (direct methods)

uploadFile(file)
uploadImage(file)
uploadVideo(file)
getMediaDetails(id)
getFiles()
getImages()
getVideos()
deleteFile(fileId)

Detailed Examples

Endpoint Mapping

API.Files.upload -> upload-file.php
API.Images.upload -> upload-image.php
API.Videos.upload -> upload-video.php
API.*.get -> get-media-details.php
API.Files.list -> get-files.php
API.Images.list -> get-images.php
API.Videos.list -> get-videos.php
API.*.delete -> delete-file.php

Error Handling Example

Security Notes

Never hardcode API keys in public frontend repositories.
Prefer environment variables or a secure backend proxy for production usage.

Ready to integrate?

Create a free account to get your personal API key and start uploading in minutes. No credit card required.

Create Free Account Sign In

GVoice Cloud Documentation

What is GVoice Cloud?

GVoice Cloud is a specialized storage and delivery network (SDN) architected for the high-demand requirements of modern web and mobile applications. It functions as a "headless" media server, providing a robust set of RESTful APIs that allow developers to offload the heavy lifting of file ingestion, media processing, and global content delivery. At its core, the software is designed to handle multi-tenant environments where thousands of files need to be indexed, optimized, and served with sub-millisecond latency.

Why choose GVoice Cloud over local storage?

Local storage often becomes a bottleneck as your user base grows. Server headers aren't optimized for media, disk space is expensive to scale, and processing videos or images on your main application server can lead to downtime. GVoice Cloud centralizes these assets, automatically applies industry-standard optimizations (like WebP conversion and MP4 transcoding), and serves them via a dedicated media engine. This ensures your primary app remains agile while your media infrastructure remains elastic.

Who is GVoice Cloud built for?

Software Developers

Use our NPM package or REST API to automate file handling in minutes.

Marketing Agencies

Centralize assets for multiple clients while maintaining perfect isolation.

E-commerce Platforms

Automatically optimize product images to improve conversion rates and SEO rankings.

Media Companies

Streamline the ingestion of vertical and horizontal video content for social-ready delivery.

Get Started

Create Account

Master Key

Retrieve your unique API token from the 'API Keys' section. This token acts as a master password.

Environment Setup

Store your key in a environment file. Never hard-code it into your frontend logic.

Your Master API Key (Example)

gvoice_cloude_token_EXAMPLE_KEY_12345678

Can I reset my API key if it's leaked?

Navigate to the API Documentation page.

Locate the Reset/Regenerate icon (refresh symbol) at the top of the API Key card.

Confirm the action. GVoice Cloud will instantly invalidate the old key and generate a new one.

Update your application servers immediately. Any request using the old key will receive a 401 response.

GVoice NPM Package

The GVoice-cloud-helper package is the recommended way to integrate with our services. It handles binary streams, auto-retries, and provides typed responses.

1. Installation

npm install gvoice-cloud-helper axios

2. Usage

import { createGVoiceCloudClient } from "gvoice-cloud-helper";

const client = createGVoiceCloudClient({ 
  apiKey: "gvoice_cloude_token_23659277761845915463965359559496" 
});

const res = await client.API.Images.upload(myFile);

GVoice NPM Package

The gvoice-cloud-helper package is our specialized SDK designed to simplify media operations. It handles binary validation, stream buffering, and provides unified response objects.

npm install gvoice-cloud-helper axios

Security & Authentication

Security is handled through isolated API tokens and secure transport layers to ensure your media remains safe.

SSL/TLS

Automatic encryption on all traffic.

Enc

Encrypted master API key storage.

SCAN

Malware scanning on all incoming binary streams.

LIMIT

Protection against brute-force token harvesting.

Limitations

Constraints to protect infrastructure stability:

Tier-Based Size

Free accounts are restricted to smaller file sizes.

Rate Limiting

Standard limits apply to prevent API abuse.

Storage Quotas

Total storage is determined by your active package.

Blocked Extensions

Executable formats are restricted for safety.

Supported Upload Categories

Category	Extensions Supported
images	jpg, jpeg, png, gif, webp, svg
media	mp4, webm, mov, avi, mkv, flv, wmv, 3gp, mpg, mpeg, vob, 3g2, m2ts, ts, mts, m4v, asf, divx, xvid, m4p
documents	pdf, doc, docx, xls, xlsx, ppt, pptx, txt, csv
archives	zip, rar, 7z, tar, gz
audio	mp3, wav, ogg, m4a, aac, flac, wma, aiff

Optimization

Built-in media engine ensures high performance for all assets.

IMG

Image Engine

Lossless and lossy compression specifically tuned for WebP and AVIF.

VID

Video Transcoding

Auto-transcoding for better web playback across all devices.

CDN

Global CDN

Anycast-routed delivery for sub-50ms latency in 80+ cities.

Ready to integrate?

Create a free account to get your personal API key and start uploading in minutes. No credit card required.

Create Free Account Sign In