Package Exports

aigen-sdk
aigen-sdk/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (aigen-sdk) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

AigenSDK

Generate AI images and pre-signed secure URLs easily with Node.js or from your terminal. Built for speed, security, and scalability.

GenAI Infrastructure as a Service

Generate unlimited pre-signed image generation URLs without paying
Pay only for results: you pay only for the images opened
Simple pricing: pay for generation and monthly storage
Unlimited bandwidth and distribution with worldwide CDN and cache

🚀 Quick Start

Run directly without installing:

npx aigen-sdk generate 'a beautiful sunset over the ocean'

Or install locally:

npm install aigen-sdk

Get your API secrets and try our platform for Free

Go to https://aigen.run/ and create your free account (no credit card needed). You will get free credits to try our infrastructure.

Then click on your avatar on the top right corner, select "My secret keys".

⚠️ The SDK is meant to be run in a safe environment (in a server), not in the browser. The secret should not be shared with anyone. On the other hand, the generative URL you can safely share and place it anywere.

🛠️ SDK Example

import AigenSDK from 'aigen-sdk' //or: const AigenSDK = require('aigen-sdk')

const aigen = new AigenSDK('your-secret-key') //optionally you can set your secret to the AIGEN_SECRET environment variable

const url = await aigen.generateImage('a futuristic cityscape', {
  width: 1024,
  height: 768,
  model: 'gpt-image-1@openai', // using OpenAI's new GPT image generator
  profile: 'facebook:username' // fetch user's Facebook profile image
})

console.log('Generated URL:', url)

🖥️ CLI Commands

npx aigen-sdk generate 'prompt' [options]

Options:

--width=<width> (default: 768)
--height=<height> (default: 768)
--model=<model> (default: flux-schnell@black-forest-labs)
--original=<url> (optional base image)
--profile=<socialnetwork:username> (optional profile picture)
--duration=<hours> (default: 24)
--secret=<your_key> (required if not saved)
--save-secret (save secret for future use)

Save your secret:

npx aigen-sdk save-secret --secret=your-secret-key

Example using someone's profile:

npx aigen-sdk generate 'A heroic portrait' --profile=facebook:john.doe

Note: the prompt should always be wrapped in single quotes to avoid strange shell interpretations of characters.

✨ New Features

🎨 Now supports OpenAI's ChatGPT latest image model: gpt-image-1@openai

You can generate images using OpenAI's new GPT-powered image generation!

🖼️ Import profile pictures for personalized generations:

Use the --profile option (CLI) or profile (SDK) to fetch and use user profile images from:

facebook:username
instagram:username
linkedin:username

(More networks coming soon!)

✨ Other Features

🖼️ Generate millions of image variations
🔒 Secure HMAC SHA-256 signed URLs
⚡ Global CDN delivery
📦 Easy GET API / Node.js SDK / CLI support

🧠 Available Models

You can specify a model using the --model option or in the SDK.

Some available models:

flux-dev-lora@black-forest-labs
flux-1.1-pro-ultra@black-forest-labs
flux-1.1-pro@black-forest-labs
recraft-v3@recraft-ai
flux-schnell@black-forest-labs
sdxl-lightning-4step@bytedance
imagen-3.0-generate-002@google
imagen-3.0-capability-001@google
gemini-2.0-flash-exp-image-generation@google
imagen-3@google
imagen-3-fast@google
sana@nvidia
stable-diffusion-3.5-medium@stability-ai
stable-diffusion-3.5-large-turbo@stability-ai
stable-diffusion-3.5-large@stability-ai
sdxl@stability-ai
gpt-image-1@openai ← 🆕 ChatGPT’s new image model!

✅ Tip:
If no model is specified, the default is:

flux-schnell@black-forest-labs

👤 Available Profile Variables

When you import a social profile using the --profile option (CLI) or the profile field (SDK), you can dynamically insert user information into your prompts with special variables.

Variable	Description	Available On
`$$profile.name$$`	Full name of the user	Facebook, Instagram, LinkedIn
`$$profile.username$$`	Username or handle	Facebook, Instagram, LinkedIn
`$$profile.bio$$`	User bio or description	Facebook, Instagram, LinkedIn
`$$profile.country$$`	Country of the user	LinkedIn only
`$$profile.location$$`	City or location of the user	LinkedIn only

Examples:

✉️ Custom welcome email hero:

On the top half, write $$profile.name$$ in cursive, round letters.  
On the bottom half, generate a portrait of $$profile.name$$ looking up at their name.  
Use a clean white background and have them wearing our black branded hoodie.

🎈 Birthday greeting card:

Create a colorful birthday card featuring $$profile.name$$ with balloons and confetti.  
Add the message "Happy Birthday $$profile.name$$!" in playful fonts.

🌍 Location based images:

Create a background with the flag of $$profile.country$$ and have $$profile.name$$ proudly holding a product with the country’s colors.

🖼️ Bio-integrated custom artwork:

Design an artistic poster showcasing $$profile.name$$ with visual elements inspired by their bio: "$$profile.bio$$".

During generation, these placeholders will be automatically replaced with real user data.

✅ Notes:

If a variable is missing (e.g., no location), it will be ignored automatically.
More social networks and fields coming soon!

📚 More models coming soon!

📖 Learn More

📚 Full Docs: https://aigen.run/#/developers

🛠️ Support and Bug Reports

If you encounter any issues, need help, or want to request a feature, we’re here to support you!

📬 Email support: support@aigen.run
🐛 Create an issue: GitHub Issues

We typically respond within 24 hours.
Feel free to reach out — your feedback helps us improve!

aigen-sdk