Ini adalah SDK TypeScript dari API Gambar yang Dapat Diprogram Picsart dan API Picsart GenAI. Anda dapat dengan mudah melakukan banyak tindakan dengan gambar Anda hanya dengan menambahkan beberapa baris kode ke proyek JavaScript atau TypeScript Anda.
Untuk menginstal paket, jalankan perintah berikut:
npm install --simpan picsart-kreatif-apis-ts-sdk
impor PicsartEnterprise dari "picsart-creative-apis-ts-sdk";// Dapatkan instance gambar APIconst imageApi = PicsartEnterprise.createImageApi('YOUR_API_KEY');// Dapatkan instance GenAI APIconst genaiApi = PicsartEnterprise.createGenAIApi('YOUR_API_KEY ');
// Dari gambar publik urlconst imageSource = ImageApi.fromUrl('https://....');// Dari gambar Picsart idconst imageSource = ImageApi.fromImageId('id-gambar-anda-di sini');// Dari binerconst fileContent = fs.readFileSync("examples/image.png");const imageSource = ImageApi.fromFile(fileContent);// Dari streamconst readStream = fs.createReadStream("examples/image.png");const imageSource = ImageApi.fromStream(readStream);
hasil const = menunggu imageApi.removeBackground( new RemoveBackgroundRequest().setImage(imageSource).setBgColor("green")); console.log(hasil.gambar.url); console.log(hasil.metadata.kreditTersedia); console.log(hasil.metadata.rateLimitResetTime); console.log(hasil.metadata.rateLimit); console.log(hasil.metadata.rateLimitAvailable); console.log(hasil.metadata.correlationId);
hasil const = menunggu imageApi.adjust( new AdjustRequest().setImage(imageSource).setBrightness(90).setSharpen(40)); console.log(hasil.gambar.url);
hasil const = menunggu imageApi.effect( new EffectRequest().setImage(imageSource).setEffectName(EffectName.a1972)); console.log(hasil.gambar.url);
hasil const = menunggu imageApi.backgroundTexture( new BackgroundTextureRequest().setImage(imageSource).setPattern(TexturePattern.diamond).setHeight(800)); console.log(hasil.gambar.url);
hasil const = menunggu imageApi.effectPreviews( new EffectPreviewsRequest().setImage(imageSource).addEffect(EffectName.a1972).addEffect(EffectName.brnz2).addEffect(EffectName.icy3).addEffect(EffectName.apr3),); console.log(hasil.thumbnail);
hasil const = menunggu imageApi .enhanceFace(EnhanceFaceRequest baru() .setImage(imageSource), ); console.log(hasil.gambar.url);
hasil const = menunggu imageApi.getBalance(); console.log(hasil.kredit);
hasil const = menunggu imageApi.getEffects(); console.log(hasil.efek)
hasil const = menunggu imageApi.surfacemap( new SurfacemapRequest().setImage(imageSource1).setMask(imageSource2).setSticker(imageSource3)); console.log(hasil.gambar.url);
const result = menunggu genaiApi.text2Image( new Text2ImageRequest().setCount(10).setPrompt("coding sepanjang waktu").setNegativePrompt("santai dan istirahat")); console.log(hasil.gambar);
const fileContent = readFileSync("examples/image.png"); const gumpalan = gumpalan baru([isi file]); const imageSource = ImageApi.fromFile(gumpalan); hasil const = menunggu imageApi.upload(UploadRequest baru() .setImage(imageSource) ); console.log(hasil.gambar.url);
hasil const = menunggu imageApi.upscale(UpscaleRequest baru() .setImage(imageSource) .setUpscaleFactor(UpscaleFactor.R2000x2000) ); console.log(hasil.gambar.url);
hasil const = menunggu imageApi.ultraEnhance( new UltraEnhanceRequest().setImage(imageSource).setUpscaleFactor(6),); console.log(hasil.gambar.url);
hasil const = menunggu imageApi.ultraUpscale( new UltraUpscaleRequest().setImage(imageSource).setUpscaleFactor(4).setMode(ProcessingMode.async),); console.log(hasil.gambar.url);
Untuk membangun sebuah paket gunakan perintah berikut:
npm jalankan pembangunan
Ini akan membuat direktori /lib
di direktori root proyek yang akan berisi paket npm yang siap diterbitkan.
Jalankan perintah berikut untuk menambahkan pemberitahuan lisensi boilerplate di semua file *.ts:
npm menjalankan lisensi
Perintah ini tidak hanya akan menambahkan header ke semua file baru, tetapi juga akan memperbaiki file yang ada jika diperlukan.
Untuk dapat menjalankan ini di MacOS, Anda perlu menginstal GNU sed. Jika Anda belum menginstalnya, ikuti langkah-langkah berikut:
Instal Homebrew : Jika Anda belum menginstal Homebrew, buka Terminal dan jalankan:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Instal GNU sed : Setelah Homebrew diinstal, jalankan perintah berikut untuk menginstal GNU sed:
pembuatan bir instal gnu-sed
Referensi API dihasilkan menggunakan TypeDoc berdasarkan komentar TSDoc dalam kode. Jalankan perintah berikut untuk membuatnya:
npm jalankan generate-docs
Perintah ini akan menghasilkan dokumentasi API dalam format HTML di direktori /docs
.
Untuk menjalankan tes, gunakan perintah berikut:
tes npm
SDK API Kreatif Picsart disediakan di bawah lisensi MIT yang dapat ditemukan di file LISENSI. Dengan menggunakan, mendistribusikan, atau berkontribusi pada proyek ini, Anda menyetujui syarat dan ketentuan lisensi ini.
Proyek ini memiliki beberapa ketergantungan pihak ketiga, yang masing-masing mungkin memiliki lisensi independen:
aksio:^1.7.2, (MIT): Digunakan sebagai klien http
axios-retry:^4.3.0, (Lisensi Apache V2.0): Digunakan sebagai ekstensi aksio untuk menangani percobaan ulang
form-data:^4.0.0, (MIT): Digunakan untuk membuat muatan multipart/form-data
ya:^1.4.0, (MIT): Digunakan untuk validasi permintaan sisi klien
Jika Anda menyukai Picsart Creative APIs SDK dan ingin berkontribusi pada proyek sumber terbuka ini, silakan periksa panduan Kontribusi.