Memulai
Panduan Cepat (Quickstart)
Pelajari cara membuat kunci API, memasang TypeScript SDK, dan mengunggah aset media pertama Anda dalam kurang dari 3 menit.
1
Buat Kunci API
Sebelum berinteraksi dengan API Cloudizero atau SDK, Anda memerlukan kunci API. Buka Konsol Kunci API dan buat kunci baru.
Jaga Kerahasiaan Kunci API
Kunci API berawalan
cz_live_ memberikan izin penuh untuk mengelola penyimpanan Anda. Jangan pernah mempublikasikan kunci rahasia di bundle sisi klien atau repositori publik GitHub.2
Pasang @cloudizero/sdk
Pasang package resmi menggunakan package manager favorit Anda:
pnpm add @cloudizero/sdk3
Unggah Aset Pertama Anda
Buat skrip unggah (misalnya, upload.ts) dan jalankan:
upload.ts
import { Cloudizero } from "@cloudizero/sdk";
import fs from "fs";
// 1. Inisialisasi Klien Cloudizero (otomatis membaca CLOUDIZERO_API_KEY dari environment)
const cz = new Cloudizero();
async function main() {
// 2. Baca file yang akan diunggah
const fileBuffer = fs.readFileSync("./sample.png");
// 3. Unggah langsung ke Cloudizero Storage
const asset = await cz.storage.upload({
file: fileBuffer,
fileName: "sample.png",
projectId: "your-project-id", // temukan di dashboard /projects
mimeType: "image/png",
});
console.log("Upload Success!");
console.log("Asset ID:", asset.id);
console.log("Public CDN URL:", asset.url);
}
main().catch(console.error);Langkah Selanjutnya
Buka panduan terperinci Panduan Unggah (Uploads) untuk mempelajari upload langsung di browser dengan pelacakan progres real-time, atau telusuri API Storage Explorer untuk mengelola folder dan file secara terstruktur.
