picsart creative apis ts sdk

Picsart 크리에이티브 API

설명

이것은 Picsart 프로그래밍 가능 이미지 API 및 Picsart GenAI API의 TypeScript SDK입니다. JavaScript 또는 Typescript 프로젝트에 코드 몇 줄만 추가하면 이미지로 다양한 작업을 쉽게 수행할 수 있습니다.

설치

패키지를 설치하려면 다음 명령을 실행하십시오.

 npm install --picart-creative-apis-ts-sdk 저장

용법

API 인스턴스 가져오기

 import PicsartEnterprise from "picsart-creative-apis-ts-sdk";// 이미지 API 인스턴스 가져오기const imageApi = PicsartEnterprise.createImageApi('YOUR_API_KEY');// GenAI API 인스턴스 가져오기const genaiApi = PicsartEnterprise.createGenAIApi('YOUR_API_KEY ');

이미지 인스턴스 만들기

 // 공개 이미지에서 urlconst imageSource = ImageApi.fromUrl('https://....');// Picsart 이미지에서 idconst imageSource = ImageApi.fromImageId('your-image-id-here');// From Binaryconst fileContent = fs.readFileSync("examples/image.png");const imageSource = ImageApi.fromFile(fileContent);// streamconst에서 readStream = fs.createReadStream("examples/image.png");const imageSource = ImageApi.fromStream(readStream);

배경 제거

  const result = wait imageApi.removeBackground( new RemoveBackgroundRequest().setImage(imageSource).setBgColor("green"));

  console.log(result.image.url);
  console.log(result.metadata.creditsAvailable);
  console.log(result.metadata.rateLimitResetTime);
  console.log(result.metadata.rateLimit);
  console.log(result.metadata.rateLimitAvailable);
  console.log(result.metadata.correlationId);

이미지 조정

  const result = wait imageApi.adjust( new adjustRequest().setImage(imageSource).setBrightness(90).setSharpen(40));
  console.log(result.image.url);

효과 적용

  const result = wait imageApi. effect( new EffectRequest().setImage(imageSource).setEffectName(EffectName.a1972));

  console.log(result.image.url);

배경 텍스처 생성

  const 결과 = wait imageApi.BackgroundTexture( new BackgroundTextureRequest().setImage(imageSource).setPattern(TexturePattern.diamond).setHeight(800));

  console.log(result.image.url);

이미지에서 선택한 효과 미리보기

  const 결과 = wait imageApi. effectPreviews( new EffectPreviewsRequest().setImage(imageSource).addEffect(EffectName.a1972).addEffect(EffectName.brnz2).addEffect(EffectName.icy3).addEffect(EffectName.apr3),);

  console.log(result.thumbnails);

얼굴 강화

  const 결과 = imageApi를 기다립니다
  .enhanceFace(새로운 EnhanceFaceRequest() .setImage(이미지소스),
  );

  console.log(result.image.url);

잔액 확보

  const 결과 = imageApi.getBalance()를 기다립니다.
  console.log(result.credits);

효과 목록 가져오기

  const 결과 = imageApi.getEffects()를 기다립니다.
  console.log(결과.효과)

표면 지도

  const result = wait imageApi.surfacemap( new SurfacemapRequest().setImage(imageSource1).setMask(imageSource2).setSticker(imageSource3));

  console.log(result.image.url);

텍스트를 이미지로

  const result = wait genaiApi.text2Image( new Text2ImageRequest().setCount(10).setPrompt("항상 코딩").setNegativePrompt("긴장을 풀고 휴식하세요"));
  console.log(result.images);

이미지 업로드

  const fileContent = readFileSync("examples/image.png");
  const blob = new Blob([fileContent]);

  const imageSource = ImageApi.fromFile(blob);
  const 결과 = imageApi.upload(new UploadRequest() .setImage(imageSource) 대기)
  );

  console.log(result.image.url);

고급스러운

  const 결과 = imageApi.upscale(new UpscaleRequest() .setImage(imageSource) .setUpscaleFactor(UpscaleFactor.R2000x2000)을 기다립니다.
  );

  console.log(result.image.url);

울트라 강화

  const 결과 = wait imageApi.ultraEnhance( new UltraEnhanceRequest().setImage(imageSource).setUpscaleFactor(6),);

  console.log(result.image.url);

울트라 업스케일

  const result = wait imageApi.ultraUpscale( new UltraUpscaleRequest().setImage(imageSource).setUpscaleFactor(4).setMode(ProcessingMode.async),);

  console.log(result.image.url);

짓다

패키지를 빌드하려면 다음 명령을 사용하십시오.

 npm 실행 빌드

npm 패키지를 게시할 준비가 된 프로젝트의 루트 디렉터리에 /lib 디렉터리가 생성됩니다.

상용구 라이센스 공지 추가

모든 *.ts 파일에 상용구 라이센스 공지를 추가하려면 다음 명령을 실행하십시오.

 npm 실행 라이센스

이 명령은 모든 새 파일에 헤더를 추가할 뿐만 아니라 필요한 경우 기존 파일도 수정합니다.

macOS에서 이를 실행하려면 GNU sed를 설치해야 합니다. 아직 설치하지 않았다면 다음 단계를 따르세요.

1. Homebrew 설치 : Homebrew가 설치되어 있지 않은 경우 터미널을 열고 다음을 실행합니다.

 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. GNU sed 설치 : Homebrew가 설치되면 다음 명령을 실행하여 GNU sed를 설치하십시오.

 양조 설치 gnu-sed

API 참조 생성

API 참조는 코드의 TSDoc 주석을 기반으로 TypeDoc을 사용하여 생성됩니다. 생성하려면 다음 명령을 실행하십시오.

 npm 실행 생성 문서

이 명령은 /docs 디렉토리에 HTML 형식의 API 문서를 생성합니다.

테스트

테스트를 실행하려면 다음 명령을 사용하십시오.

 npm 테스트

특허

Picsart Creative API SDK는 LICENSE 파일에 있는 MIT 라이선스에 따라 제공됩니다. 이 프로젝트를 사용, 배포 또는 기여함으로써 귀하는 본 라이센스의 이용 약관에 동의하게 됩니다.

이 프로젝트에는 일부 타사 종속성이 있으며 각 종속성은 독립적인 라이선스를 가질 수 있습니다.

• axios:^1.7.2, (MIT): http 클라이언트로 사용됩니다.

• axios-retry:^4.3.0, (Apache License V2.0): 재시도 처리를 위한 axios의 확장으로 사용됩니다.

• form-data:^4.0.0, (MIT): 다중 부분/양식 데이터 페이로드 구축에 사용됩니다.

• yup:^1.4.0, (MIT): 클라이언트 측 요청 검증에 사용됩니다.

어떻게 기여하나요?

Picsart Creative API SDK가 마음에 들고 이 오픈 소스 프로젝트에 기여하고 싶다면 기여 가이드를 확인하세요.