Orbita - Image Generator by PiktID

Orbita 1.0.0

Orbita is an image generator model designed to create high-quality images containing people from text prompts. It allows you to generate images with various aspect ratios and customization options while maintaining visual coherence and artistic quality.

About

Orbita creates authentic-looking people from your text descriptions. It's particularly useful for:

• Content creation: Generate identities for social media, product pages, blogs, and marketing materials
• Design: Create concept art, illustrations, and visual assets

📋 Model Information: For detailed information about Orbita's capabilities, limitations, bias considerations, and responsible use guidelines, please see our Model Card.

Getting Started

The following instructions suppose you have already installed a recent version of Python. To use any PiktID API, an access token is required.

Step 0 - Register here. 10 credits are given for free to all new users.

Step 1 - Clone the Image Generator repository

# Installation commands
$ git clone https://github.com/piktid/create-image.git
$ cd create-image

Step 2 - Export your email and password as environmental variables

$ export CREATE_EMAIL={Your email here}
$ export CREATE_PASSWORD={Your password here}

Step 3 - Run the main function with a text prompt and specify generation parameters

# Basic image generation with a prompt
$ python3 main.py --prompt "a beautiful sunset over mountains" --aspect_ratio "1:1" --seed 0

# Generate multiple images with enhanced prompt
$ python3 main.py --prompt "a futuristic city skyline" --aspect_ratio "9:16" --num_generations 3 --prompt_enhance --seed 42

You can customize the generation parameters with the following options:

# Generate images with specific parameters
$ python3 main.py --prompt "a serene lake with mountains in the background" --aspect_ratio "2:3" --seed 123 --num_generations 2 --prompt_enhance

Available Parameters

• prompt: Text description of the image you want to generate (required)

• aspect_ratio: Aspect ratio of the generated image (default: "1:1")

• seed: Random seed for reproducible results (default: random)

• prompt_enhance: Enable prompt enhancement for better results (flag)

• num_generations: Number of images to create (default: 1)

Available Aspect Ratios

The following aspect ratios are supported:

• 1:1 - Square format
• 1:2 - Portrait format (1:2)
• 2:3 - Portrait format (2:3)
• 3:4 - Portrait format (3:4)
• 9:16 - Mobile/portrait format
• 16:9 - Landscape format
• 3:2 - Landscape format
• 4:3 - Landscape format
• 2:1 - Landscape format

Examples

# Generate a square landscape
$ python3 main.py --prompt "a peaceful meadow with wildflowers" --aspect_ratio "1:1"

# Create a mobile-friendly portrait
$ python3 main.py --prompt "a professional headshot" --aspect_ratio "9:16" --prompt_enhance

# Generate multiple variations
$ python3 main.py --prompt "abstract geometric patterns" --aspect_ratio "2:3" --num_generations 4 --seed 42

Output

Generated images are automatically saved to the outputs directory with descriptive filenames that include:

• The seed value used
• The aspect ratio
• A truncated version of the prompt

Contact

office@piktid.com