Badges

Acknowledgements

Authors

Installation

  pip install -U craiyon.py

Versioning

Usage / Examples

fromcraiyonimportCraiyongenerator=Craiyon()# Instantiates the api wrapperresult=generator.generate("Photorealistic image of shrek eating earth",negative_prompt="spoon",model_type="art")print(result.description)# Description about the generated images # >>> Shrek devouring planet Earth with a sinister grinresult.save_images()# Saves the generated images to 'current working directory/generated', you can also provide a custom path

fromcraiyonimportCraiyon,craiyon_utilsfromPILimportImage# pip install pillowfromioimportBytesIOimportbase64generator=Craiyon()# Instantiates the api wrapperresult=generator.generate("Professional photo of Obama flashing a flag with his last name")# Generates 9 images by default and you cannot change thatprint(result.description)# >>> Obama holding up a flag with his last name, smiling confidentlyimages=craiyon_utils.encode_base64(result.images)foriinimages:image=Image.open(BytesIO(base64.decodebytes(i)))# To convert the .webp images to .jpg or .png, you can proceed like this# image.convert("RGB").save("image.jpg", "JPEG") # For ".jpg" images# image.convert("RGBA").save("image.png", "PNG") # For ".png" images# Use the PIL's Image object as per your needs

fromcraiyonimportCraiyongenerator=Craiyon()# Instantiates the api wrapperresult=generator.generate("Photorealistic image of shrek eating earth")print(result.images)# Prints a list of the Direct Image URLs hosted on https://img.craiyon.com# Loops through the list and prints each image URL one by oneforurlinresult.images:print(url)

Async Usage / Examples

fromcraiyonimportCraiyonimportasyncioasyncdefmain():generator=Craiyon()# Instantiates the api wrapperresult=awaitgenerator.async_generate("Photorealistic image of shrek eating earth")awaitresult.async_save_images()# Saves the generated images to 'current working directory/generated', you can also provide a custom pathasyncio.run(main())

fromcraiyonimportCraiyon,craiyon_utilsimportdiscordfromdiscord.extimportcommandsfromioimportBytesIOimportbase64intents=discord.Intents.default()intents.message_content=Truebot=commands.Bot(intents=intents,command_prefix="!")generator=Craiyon()# Initialize Craiyon() class@bot.eventasyncdefon_ready():print(f"Successfully logged in as{bot.user.name}!")# Create command@bot.command()asyncdefgenimage(ctx,*,prompt:str):awaitctx.send(f"Generating prompt\"{prompt}\"...")generated_images=awaitgenerator.async_generate(prompt)# Generate imagesb64_list=awaitcraiyon_utils.async_encode_base64(generated_images.images)# Download images from https://img.craiyon.com and store them as b64 bytestring objectimages1= []forindex,imageinenumerate(b64_list):# Loop through b64_list, keeping track of the indeximg_bytes=BytesIO(base64.b64decode(image))# Decode the image and store it as a bytes objectimage=discord.File(img_bytes)image.filename=f"result{index}.webp"images1.append(image)# Add the image to the images1 listawaitctx.reply(files=images1)# Reply to the user with all 9 images in 1 messagebot.run("your_token_here")

Generation parameters

# These parameters are only supported by the v3 modelfromcraiyonimportCraiyongenerator=Craiyon()result=generator.generate("prompt here",negative_prompt="cap",model_type="art")# The negative prompt and model type are optional parameters# Negative prompt helps filtering out certain things from the images that will be generated, defaults to empty string ""# Model type can be "art", "drawing", "photo" and "none", defaults to "none". It does as it's name suggests.# result.description returns a brief description generated by craiyon about the generated images# result.images returns the list of images generated (v3 returns the image links, v1 returns the base64 image data)# result.model returns the model version

Specify custom tokens/model versions

fromcraiyonimportCraiyon# Importing the v3 model# api_token and model_version are not required, but recommendedgenerator=Craiyon(api_token="your-token-here",model_version="api-model-version")# ...rest is the same stuff as above

api_token

model_version

Backwards Compatibility

Todo

{"image_id":"date/imagepath.ext","model":"none","negative_prompt":"","prompt":"","token":"null","version":"c4ue22fb7kb6wlac"}

Contributing

License