Este é um SDK TypeScript de APIs de imagem programável Picsart e APIs Picsart GenAI. Você pode realizar muitas ações facilmente com suas imagens apenas adicionando algumas linhas de código aos seus projetos JavaScript ou Typescript.
Para instalar o pacote, execute o seguinte comando:
npm instalar --save picsart-creative-apis-ts-sdk
import PicsartEnterprise de "picsart-creative-apis-ts-sdk";// Obtenha uma instância da imagem APIconst imageApi = PicsartEnterprise.createImageApi('YOUR_API_KEY');// Obtenha uma instância da GenAI APIconst genaiApi = PicsartEnterprise.createGenAIApi('YOUR_API_KEY ');
// Da imagem pública urlconst imageSource = ImageApi.fromUrl('https://....');// Da imagem Picsart idconst imageSource = ImageApi.fromImageId('your-image-id-here');// Da imagem pública binaryconst fileContent = fs.readFileSync("examples/image.png");const imageSource = ImageApi.fromFile(fileContent);// De streamconst readStream = fs.createReadStream("examples/image.png");const imageSource = ImageApi.fromStream(readStream);
resultado const = aguarda imageApi.removeBackground(new RemoveBackgroundRequest().setImage(imageSource).setBgColor("verde")); console.log(resultado.imagem.url); console.log(result.metadata.creditsAvailable); console.log(result.metadata.rateLimitResetTime); console.log(resultado.metadata.rateLimit); console.log(result.metadata.rateLimitAvailable); console.log(result.metadata.correlationId);
resultado const = aguarda imageApi.adjust( new AdjustRequest().setImage(imageSource).setBrightness(90).setSharpen(40)); console.log(resultado.imagem.url);
resultado const = aguarda imageApi.effect(new EffectRequest().setImage(imageSource).setEffectName(EffectName.a1972)); console.log(resultado.imagem.url);
resultado const = aguarda imageApi.backgroundTexture(new BackgroundTextureRequest().setImage(imageSource).setPattern(TexturePattern.diamond).setHeight(800)); console.log(resultado.imagem.url);
resultado const = aguardar imageApi.effectPreviews( new EffectPreviewsRequest().setImage(imageSource).addEffect(EffectName.a1972).addEffect(EffectName.brnz2).addEffect(EffectName.icy3).addEffect(EffectName.apr3),); console.log(resultado.thumbnails);
resultado const = aguardar imageApi .enhanceFace(novo EnhanceFaceRequest() .setImage(imageSource), ); console.log(resultado.imagem.url);
const resultado = aguarda imageApi.getBalance(); console.log(resultado.créditos);
const resultado = aguarda imageApi.getEffects(); console.log(resultado.efeitos)
resultado const = aguarda imageApi.surfacemap(new SurfacemapRequest().setImage(imageSource1).setMask(imageSource2).setSticker(imageSource3)); console.log(resultado.imagem.url);
const resultado = aguarda genaiApi.text2Image( new Text2ImageRequest().setCount(10).setPrompt("codificando o tempo todo").setNegativePrompt("relaxe e descanse")); console.log(resultado.imagens);
const fileContent = readFileSync("examples/image.png"); const blob = new Blob([fileContent]); const imageSource = ImageApi.fromFile(blob); resultado const = aguarda imageApi.upload(new UploadRequest() .setImage(imageSource) ); console.log(resultado.imagem.url);
resultado const = aguarda imageApi.upscale(new UpscaleRequest() .setImage(imageSource) .setUpscaleFactor(UpscaleFactor.R2000x2000) ); console.log(resultado.imagem.url);
resultado const = aguarda imageApi.ultraEnhance( new UltraEnhanceRequest().setImage(imageSource).setUpscaleFactor(6),); console.log(resultado.imagem.url);
resultado const = aguarda imageApi.ultraUpscale( new UltraUpscaleRequest().setImage(imageSource).setUpscaleFactor(4).setMode(ProcessingMode.async),); console.log(resultado.imagem.url);
Para construir um pacote use o seguinte comando:
npm executar compilação
Ele criará o diretório /lib
no diretório raiz do projeto que conterá o pacote npm pronto para publicar.
Execute o seguinte comando para adicionar o aviso de licença padrão em todos os arquivos *.ts:
licença de execução npm
Este comando não apenas adicionará o cabeçalho a todos os novos arquivos, mas também corrigirá os arquivos existentes, se necessário.
Para poder executar isso no macOS, você precisa instalar o GNU sed. Se você ainda não o instalou, siga estas etapas:
Instale o Homebrew : Se você não tiver o Homebrew instalado, abra o Terminal e execute:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Instale o GNU sed : Depois que o Homebrew estiver instalado, execute o seguinte comando para instalar o GNU sed:
preparar instalar gnu-sed
As referências de API são geradas usando TypeDoc com base nos comentários do TSDoc no código. Execute o seguinte comando para gerá-lo:
npm execute generate-docs
Este comando irá gerar a documentação da API em formato HTML no diretório /docs
.
Para executar testes, use o seguinte comando:
teste npm
O Picsart Creative APIs SDK é fornecido sob a licença MIT que pode ser encontrada no arquivo LICENSE. Ao usar, distribuir ou contribuir para este projeto, você concorda com os termos e condições desta licença.
Este projeto possui algumas dependências de terceiros, cada uma das quais pode ter licenciamento independente:
axios:^1.7.2, (MIT): usado como cliente http
axios-retry:^4.3.0, (Licença Apache V2.0): usado como uma extensão para axios para lidar com novas tentativas
form-data:^4.0.0, (MIT): usado para construir cargas úteis multipart/form-data
sim:^1.4.0, (MIT): Usado para validações de solicitação do lado do cliente
Se você gosta do Picsart Creative APIs SDK e gostaria de contribuir com este projeto de código aberto, verifique o guia de contribuição.