ホーム>プログラミング関連>AI ソースコード
ダウンロード

Picsart クリエイティブ API

説明

これは、Picsart Programmable Image API および Picsart GenAI API の Java SDK です。 Java または Kotlin プロジェクトに数行のコードを追加するだけで、画像に対して多くのアクションを簡単に実行できます。

インストール

SDK を使用するには、Maven pom.xmlファイルに次の依存関係を追加します。 

< dependency >
    < groupId >com.picsartgroupId >
    < artifactId >picsart-creative-apis-java-sdkartifactId >
    < version >1.0.0version >
dependency >

Gradle を使用している場合は、 build.gradleファイルに以下を追加します。 

implementation ' com.picsart:picsart-creative-apis-java-sdk:1.0.0 '

警告: SDK は Reactor java を使用しており、 io.projectreactor:reactor-coreに推移的な依存関係があります。別のバージョンの Reactor を使用している場合は、互換性の問題が発生する可能性があります。この場合、推移的な依存関係を除外し、独自のバージョンの Reactor をプロジェクトに追加できます。

使用法

APIインスタンスを取得する

 import com . picsart . creativeapis . PicsartEnterprise ;
import com . picsart . creativeapis . image . ImageApi ;
import com . picsart . creativeapis . genai . GenAIApi ;

// Get an instance of Image API with default baseUrl and timeout
ImageApi imageApi = PicsartEnterprise . createImageApi ( "YOUR_API_KEY" );

// Get an instance of Image API with custom baseUrl and timeout
ImageApi customBaseUrlImageApi = PicsartEnterprise . createImageApi ( "YOUR_API_KEY" )
                        . withBaseUrl ( "https://custom-base-url.com" )
                        . withTimeout ( Duration . ofSeconds ( 10 ));

// Get an instance of GenAI API
GenAIApi genaiApi = PicsartEnterprise . createGenAIApi ( "YOUR_API_KEY" );

// Get an instance of GenAI API with custom baseUrl and timeout
GenAIApi customBaseUrlGenaiApi = PicsartEnterprise . createGenAIApi ( "YOUR_API_KEY" )
                        . withBaseUrl ( "https://custom-base-url.com" )
                        . withTimeout ( Duration . ofSeconds ( 10 ));

ImageSource インスタンスを作成する

 import com . picsart . busobj . image . ImageSource ;
import com . picsart . creativeapis . image . ImageApi ;
import com . picsart . creativeapis . image . models . ImageSource ;

import java . io . File ;

var imageUrl = ImageSource . fromUrl ( "https://url-to-your-image.jpg" );
// or
var imageFile = ImageSource . fromFile ( new File ( "path/to/your-image.jpg" ));
// or
var imageId = ImageSource . fromImageId ( "your-image-id" );

背景を削除する

 RemoveBackgroundParameters parameters = RemoveBackgroundParameters . builder ( mainImageSource )
        . bgImage ( backgroundImageSource )
        . build ();
Mono < RemoveBackgroundResult > removeBackgroundResultMono = imageApi . removeBackground ( parameters );
removeBackgroundResultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result Image: " + result . image ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、RemoveBackgroundExample.java を参照してください。

画像を調整する

 AdjustParameters parameters = AdjustParameters . builder ( imageSource )
                . brightness ( 20 )
                . contrast ( 30 )
                . saturation ( 40 )
                . build ();
Mono < AdjustResult > adjustResultMono = imageApi . adjust ( parameters );
adjustResultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result Image: " + result . image ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、AdjustExample.java を確認してください。

エフェクトを適用する

 EffectParameters parameters = EffectParameters . builder ( imageSource , effectName )
        . build ();
Mono < EffectResult > resultMono = imageApi . effect ( parameters );
resultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result Image: " + result . image ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、EffectExample.java を確認してください。

エフェクトのリストを取得する

 Mono < ListEffectsResult > resultMono = imageApi . listEffects ();
resultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Effects: " + result . effects ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、ListEffectsExample.java を参照してください。

//エフェクトのプレビュー

画像上の選択した効果をプレビューする

 EffectsPreviewsParameters parameters = EffectsPreviewsParameters . builder ( imageSource )
                . addEffectName ( effectName1 )
                . addEffectName ( effectName2 )
                . addEffectName ( effectName3 )
                . format ( ImageFormat . PNG )
                . build ();
Mono < EffectsPreviewsResult > resultMono = imageApi . effectsPreviews ( parameters );
resultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result images with effects" + result . effectsPreviews ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、EffectsPreviewsExample.java を参照してください。

画像をアップロードする

 Mono < UploadResult > resultMono = imageApi . upload ( imageFile ); // either imageFile or imageUrl
resultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result Image: " + result . image ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、UploadExample.java を参照してください。

高級感のある

 UpscaleParameters parameters = UpscaleParameters . builder ( imageSource )
        . upscaleFactor ( 4 )
        . format ( ImageFormat . PNG )
        . build ();
Mono < UpscaleResult > resultMono = imageApi . upscale ( parameters );
resultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result Image: " + result . image ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、UpscaleExample.java を参照してください。

超高級

 UltraUpscaleParameters parameters = UltraUpscaleParameters . builder ( imageSource )
        . mode ( UpscaleMode . ASYNC )
        . upscaleFactor ( 4 )
        . format ( ImageFormat . PNG )
        . build ();
Mono < UltraUpscaleResult > resultMono = imageApi . ultraUpscale ( parameters );
resultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result Image: " + result . image ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、UltraUpscaleExample.java を参照してください。

ウルトラエンハンス

 UltraEnhanceParameters parameters = UltraEnhanceParameters . builder ( imageSource )
        . upscaleFactor ( 4 )
        . format ( ImageFormat . PNG )
        . build ();
Mono < UltraEnhanceResult > resultMono = imageApi . ultraEnhance ( parameters );
resultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result Image: " + result . image ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、UltraEnhanceExample.java を参照してください。

顔を強化する

 EnhanceFaceParameters parameters = EnhanceFaceParameters . builder ( imageSource )
                . format ( ImageFormat . PNG )
                . build ();
Mono < EnhanceFaceResult > resultMono = imageApi . enhanceFace ( parameters );
resultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result Image: " + result . image ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、EnhanceFaceExample.java を確認してください。

表面マップ

 SurfaceMapParameters parameters = SurfaceMapParameters . builder ( mainImageSource , maskSource , stickerSource )
                . format ( ImageFormat . PNG )
                . build ();
Mono < SurfaceMapResult > resultMono = imageApi . surfaceMap ( parameters );
resultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result Image: " + result . image ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、SurfaceMapExample.java を確認してください。

背景テクスチャを生成する

 BackgroundTextureParameters parameters = BackgroundTextureParameters . builder ( imageSource )
                . format ( ImageFormat . PNG )
                . width ( 800 )
                . height ( 800 )
                . pattern ( BackgroundTexturePattern . DIAMOND )
                . build ();
        Mono < BackgroundTextureResult > resultMono = imageApi . backgroundTexture ( parameters );
        resultMono
                . subscribe ( result -> { // non-blocking subscribe
                    System . out . println ( "Result Image: " + result . image ());
                    System . out . println ( "Result metadata: " + result . metadata ());
                });

詳細については、BackgroundTextureExample.java を参照してください。

バランスを取る

 Mono < BalanceResult > resultMono = imageApi . balance ();
resultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result credits: " + result . credits ());
        });

詳細については、BalanceExample.java を参照してください。

GenAI を使用してテキストから画像を生成する

 Text2ImageParameters parameters = Text2ImageParameters . builder ( "your-prompt" , "your-negative-prompt" )
        . count ( 1 )
        . width ( 512 )
        . height ( 512 )
        . build ();
Mono < Text2ImageResult > resultMono = genAIApi . text2Image ( parameters );
resultMono
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result Images: " + result . images ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、Text2ImageExample.java を確認してください。

複数の変更を適用する

以下の例では、テキストから画像を生成し、生成された画像から背景を削除し、最後に結果をアップスケーリングしています。 

 Text2ImageParameters parameters = Text2ImageParameters . builder ( "your-prompt" , "your-negative-prompt" )
        . count ( 10 )
        . width ( 512 )
        . height ( 512 )
        . build ();
Mono < Text2ImageResult > resultMono = genAIApi . text2Image ( parameters );
resultMono
        . flatMapIterable ( Text2ImageResult :: images ) // flatMapIterable is used to iterate over the result images and process each of them individually
        . flatMap ( image -> { // this will be called for each image in the result (10 times in this case)
            RemoveBackgroundParameters removeBackgroundParameters = RemoveBackgroundParameters
                    . builder ( image . toImageSource ())
                    . build ();
            return imageApi . removeBackground ( removeBackgroundParameters ); // remove background from each image
        })
        . flatMap ( removeBackgroundResult -> { // this will be called for each image in the result (10 times in this case)
            var imageSource = removeBackgroundResult . image (). toImageSource ();
            UpscaleParameters upscaleParameters = UpscaleParameters . builder ( imageSource )
                     . upscaleFactor ( 2 )
                     . build ();
            return imageApi . upscale ( upscaleParameters ); // upscale each image
        })
        . subscribe ( result -> { // non-blocking subscribe
            // each image will be printed separately
            System . out . println ( "Result Image: " + result . image ());
            System . out . println ( "Result metadata: " + result . metadata ());
        });

詳細については、Text2ImageRemoveBackgroundUpscaleExample.java を確認してください。

エラー処理と再試行

API 例外は SDK によって処理され、ApiException またはその子としてスローされます。レスポンスステータスが 2xx 以外の場合、レスポンスステータスコードに応じてFailureResponseExceptionまたはその子がスローされます。 ServiceUnavailableExceptionなど、リクエストを再試行することで解決できる可能性のある例外は、Recoverable インターフェイスでマークされます。必要に応じて、これらの例外をキャッチし、リクエストを再試行できます。

回復可能な例外が発生した場合にリクエストを再試行する例: 

 Mono < BalanceResult > resultMono = imageApi . balance ();
resultMono
        // can be used to perform a side-effect in case of an error
        . doOnError ( throwable -> {
            System . out . println ( "exception: " + throwable . getMessage ());
        })
        // Retry 3 times with an initial backoff of 2 seconds. 
        // The delay between retries will increase exponentially up to max delay of 5 seconds.
        . retryWhen ( Retry . backoff ( 3 , Duration . ofSeconds ( 2 ))
                . maxBackoff ( Duration . ofSeconds ( 5 ))
                 . filter ( throwable -> throwable instanceof Recoverable )
                . onRetryExhaustedThrow (( retryBackoffSpec , retrySignal ) -> new RuntimeException ( "Retry exhausted" , retrySignal . failure ()))
        )
        . subscribe ( result -> { // non-blocking subscribe
            System . out . println ( "Result credits: " + result . credits ());
        });

ライセンス

Picsart Creative API SDK は、LICENSE ファイルにある MIT ライセンスに基づいて提供されます。このプロジェクトを使用、配布、または貢献すると、このライセンスの利用規約に同意したことになります。

このプロジェクトにはサードパーティの依存関係がいくつかあり、それぞれに独立したライセンスが付与されている場合があります。

  • Jackson Databind:2.17.1 (Apache ソフトウェア ライセンス、バージョン 2.0)
  • Guava:33.2.1-jre (Apache ソフトウェア ライセンス、バージョン 2.0)
  • Reactor Netty HTTP:1.1.19 (Apache ソフトウェア ライセンス、バージョン 2.0)
  • Reactor Core:3.6.6 (Apache ソフトウェア ライセンス、バージョン 2.0)
  • Jakarta Validation API:3.1.0 (Apache ソフトウェア ライセンス、バージョン 2.0)
  • Apache BVal JSR:3.0.0 (Apache ソフトウェア ライセンス、バージョン 2.0)
  • Apache Tika Core:2.9.2 (Apache ソフトウェア ライセンス、バージョン 2.0)
  • MapStruct:1.5.5.Final (Apache ソフトウェア ライセンス、バージョン 2.0)
  • SLF4J API:2.0.13 (MIT ライセンス)
  • SLF4J シンプル:2.0.13 (MIT ライセンス)

貢献するにはどうすればよいですか?

Picsart Creative API SDK が気に入っており、このオープンソース プロジェクトに貢献したい場合は、貢献ガイドを確認してください。

拡大する
追加情報
関連アプリ
おすすめ
関連情報 すべて