Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

SDK for interacting with stability.ai APIs (e.g. stable diffusion inference)

License

NotificationsYou must be signed in to change notification settings

Stability-AI/stability-sdk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

107 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open In Colab

Client implementations that interact with the Stability API.

Getting an API key

Follow theinstructions onPlatform to obtain an API key.

PyPI Package Installation

Install thePyPI package via:

pip install stability-sdk

Python Client

client.py is both a command line client and an API class that wraps the gRPC based API. To try the client:

  • Use Python venv:python3 -m venv pyenv
  • Set up in venv dependencies:pyenv/bin/pip3 install -e .
  • pyenv/bin/activate to use the venv.
  • Set theSTABILITY_HOST environment variable. This is by default set to the production endpointgrpc.stability.ai:443.
  • Set theSTABILITY_KEY environment variable.

Then to invoke:

python3 -m stability_sdk generate -W 1024 -H 1024 "A stunning house."

It will generate and put PNGs in your current directory.

To upscale:python3 -m stability_sdk upscale -i "/path/to/image.png"

Animation UI

Install withpip install stability-sdk[anim_ui]

Then run withpython3 -m stability_sdk animate --gui

SDK Usage

Be sure to check outPlatform for comprehensive documentation on how to interact with our API.

Command line usage

usage: python -m stability_sdk generate [-h] [--height HEIGHT] [--width WIDTH]                 [--start_schedule START_SCHEDULE] [--end_schedule END_SCHEDULE]                 [--cfg_scale CFG_SCALE] [--sampler SAMPLER] [--steps STEPS]                 [--style_preset STYLE_PRESET] [--seed SEED] [--prefix PREFIX] [--engine ENGINE]                [--num_samples NUM_SAMPLES] [--artifact_types ARTIFACT_TYPES]                [--no-store] [--show] [--init_image INIT_IMAGE] [--mask_image MASK_IMAGE]                [prompt ...]positional arguments:  promptoptions:  -h, --help            show this help message and exit  --height HEIGHT, -H HEIGHT                        [1024] height of image  --width WIDTH, -W WIDTH                        [1024] width of image  --start_schedule START_SCHEDULE                        [0.5] start schedule for init image (must be greater than 0; 1 is full strength                        text prompt, no trace of image)  --end_schedule END_SCHEDULE                        [0.01] end schedule for init image  --cfg_scale CFG_SCALE, -C CFG_SCALE                        [7.0] CFG scale factor  --sampler SAMPLER, -A SAMPLER                        [auto-select] (ddim, plms, k_euler, k_euler_ancestral, k_heun, k_dpm_2,                        k_dpm_2_ancestral, k_lms, k_dpmpp_2m, k_dpmpp_2s_ancestral)  --steps STEPS, -s STEPS                        [auto] number of steps  --style_preset STYLE_PRESET                        [none] (3d-model, analog-film, anime, cinematic, comic-book, digital-art, enhance,                         fantasy-art, isometric, line-art, low-poly, modeling-compound, neon-punk, origami,                         photographic, pixel-art, tile-texture)  --seed SEED, -S SEED  random seed to use  --prefix PREFIX, -p PREFIX                        output prefixes for artifacts  --artifact_types ARTIFACT_TYPES, -t ARTIFACT_TYPES                        filter artifacts by type (ARTIFACT_IMAGE, ARTIFACT_TEXT, ARTIFACT_CLASSIFICATIONS, etc)  --no-store            do not write out artifacts  --num_samples NUM_SAMPLES, -n NUM_SAMPLES                        number of samples to generate  --show                open artifacts using PIL  --engine ENGINE, -e ENGINE                        engine to use for inference  --init_image INIT_IMAGE, -i INIT_IMAGE                        Init image  --mask_image MASK_IMAGE, -m MASK_IMAGE                        Mask image

For upscale:

usage: client.py upscale       [-h]       --init_image INIT_IMAGE       [--height HEIGHT] [--width WIDTH] [--prefix PREFIX] [--artifact_types ARTIFACT_TYPES]       [--no-store] [--show] [--engine ENGINE]positional arguments:  prompt (ignored in esrgan engines)options:  -h, --help            show this help message and exit  --init_image INIT_IMAGE, -i INIT_IMAGE                        Init image  --height HEIGHT, -H HEIGHT                        height of upscaled image in pixels  --width WIDTH, -W WIDTH                        width of upscaled image in pixels  --steps STEPS, -s STEPS                        [auto] number of steps (ignored in esrgan engines)  --seed SEED, -S SEED  random seed to use (ignored in esrgan engines)  --cfg_scale CFG_SCALE, -C CFG_SCALE                        [7.0] CFG scale factor (ignored in esrgan engines)  --prefix PREFIX, -p PREFIX                        output prefixes for artifacts  --artifact_types ARTIFACT_TYPES, -t ARTIFACT_TYPES                        filter artifacts by type (ARTIFACT_IMAGE, ARTIFACT_TEXT, ARTIFACT_CLASSIFICATIONS, etc)  --no-store            do not write out artifacts  --show                open artifacts using PIL  --engine ENGINE, -e ENGINE                        engine to use for upscale

Connecting to the API using languages other than Python

If a language you would like to connect to the API with is not currently documented onPlatform you can use the followingprotobuf definition to compile stubs for your language:

Community-contributed clients

Stability API TOS

Usage of the Stability API falls under theSTABILITY AI API Terms of Service.

About

SDK for interacting with stability.ai APIs (e.g. stable diffusion inference)

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors22

[8]ページ先頭
©2009-2026 Movatter.jp