# Generating Images Source: https://docs.prodia.com/guides/generating-images/ This guide uses FLUX.1 \[schnell] for fast image generation. You can swap the job type to use any of these image generation models: - [FLUX.2](https://docs.prodia.com/models/flux-2/) — `inference.flux-2.dev.txt2img.v1`, `inference.flux-2.pro.txt2img.v1`, and more - [FLUX.2 Klein](https://docs.prodia.com/models/flux-2-klein/) — `inference.flux-2.klein.txt2img.v1` and `inference.flux-2.klein.9b.txt2img.v1` for sub-second generation - [FLUX.1 Kontext](https://docs.prodia.com/models/flux-kontext/) — `inference.flux-kontext.pro.txt2img.v2` with arbitrary aspect ratios - [Nano Banana](https://docs.prodia.com/models/nano-banana/) — `inference.nano-banana.txt2img.v2` for flat-rate editing - [Gemini 3](https://docs.prodia.com/models/gemini-3/) — `inference.gemini-3-pro.txt2img.v1` and `inference.gemini-3-1-flash.txt2img.v1` with selectable resolution up to 4K - [Recraft V4](https://docs.prodia.com/models/recraft-v4/) — `inference.recraft.v4.txt2img.v1` with native text rendering - [SDXL](https://docs.prodia.com/models/sdxl/) — `inference.sdxl.txt2img.v1` for fast, low-cost generation with style presets - [Seedream](https://docs.prodia.com/models/seedream/) — `inference.seedream-4-5.txt2img.v1` and more - [Wan 2.7](https://docs.prodia.com/models/wan-2-7/) — `inference.wan2-7.txt2img.v1` with Chinese and English support ### Project Setup ```bash # Create a project directory. mkdir prodia-image-generation cd prodia-image-generation ``` ### prodia-js Install Node (if not already installed): ### macOS ```bash brew install node # Close the current terminal and open a new one so that node is available. ``` ### Linux ```bash apt install node # Close the current terminal and open a new one so that node is available. ``` ### Windows ```bash winget install -e --id OpenJS.NodeJS.LTS # Close the current terminal and open a new one so that node is available. ``` Create project skeleton: ```bash # Requires node --version >= 18 # Initialize the project with npm. npm init -y # Install the prodia-js library. npm install prodia --save ``` ### requests Install Python (if not already installed): ### macOS ```bash brew install python # Close the current terminal and open a new one so that python is available. ``` ### Linux ```bash apt install python3 python3-venv python-is-python3 # Close the current terminal and open a new one so that python is available. ``` ### Windows ```bash winget install -e --id Python.Python.3.12 # Close the current terminal and open a new one so that python is available. ``` ```bash # Requires python --version >= 3.12 python -m venv venv source venv/bin/activate pip install requests ``` ### curl Install curl (if not already installed): ### macOS ```bash brew install curl # Close the current terminal and open a new one so that curl is available. ``` ### Linux ```bash apt install curl # Close the current terminal and open a new one so that curl is available. ``` ### Windows ```bash # NOTE: Windows 10 and up have curl installed by default and this can be # skipped. winget install -e --id cURL.cURL # Close the current terminal and open a new one so that curl is available. ``` ```bash # Export your token so it can be used by the main code. export PRODIA_TOKEN=your-token-here ``` > note: > > Your token is exported to an environment variable. If you close or switch your > shell you'll need to run `export PRODIA_TOKEN=your-token-here` again. Create a main file for your project: ### prodia-js ```js title="main.js" const { createProdia } = require("prodia/v2"); const prodia = createProdia({ token: process.env.PRODIA_TOKEN // get it from environment }); ``` ### requests Create the following `main.py` ```python title="main.py" from requests.adapters import HTTPAdapter, Retry import os import requests import sys prodia_token = os.getenv('PRODIA_TOKEN') prodia_url = 'https://inference.prodia.com/v2/job' session = requests.Session() retries = Retry(allowed_methods=None, status_forcelist=Retry.RETRY_AFTER_STATUS_CODES) session.mount('http://', HTTPAdapter(max_retries=retries)) session.mount('https://', HTTPAdapter(max_retries=retries)) session.headers.update({'Authorization': f"Bearer {prodia_token}"}) ``` ### curl ```bash title="main.sh" set -euo pipefail ``` You're now ready to make some API calls! ### Generate an image ### prodia-js ```javascript const { createProdia } = require("prodia/v2"); const fs = require("node:fs/promises"); // add this to imports at the top const prodia = createProdia({ token: process.env.PRODIA_TOKEN, // get it from environment }); (async () => { // run a flux schnell generation const job = await prodia.job({ type: "inference.flux-fast.schnell.txt2img.v2", config: { prompt: "puppies in a cloud, 4k", }, }); const image = await job.arrayBuffer(); await fs.writeFile("puppies.jpg", new Uint8Array(image)); // open puppies.jpg })(); ``` ```bash node main.js ``` ### requests ```python from requests.adapters import HTTPAdapter, Retry import os import requests import sys prodia_token = os.getenv('PRODIA_TOKEN') prodia_url = 'https://inference.prodia.com/v2/job' session = requests.Session() retries = Retry(allowed_methods=None, status_forcelist=Retry.RETRY_AFTER_STATUS_CODES) session.mount('http://', HTTPAdapter(max_retries=retries)) session.mount('https://', HTTPAdapter(max_retries=retries)) session.headers.update({'Authorization': f"Bearer {prodia_token}"}) headers = { 'Accept': 'image/png', } job = { 'type': 'inference.flux-fast.schnell.txt2img.v2', 'config': { 'prompt': 'puppies in a cloud, 4k', }, } res = session.post(prodia_url, headers=headers, json=job) print(f"Request ID: {res.headers['x-request-id']}") print(f"Status: {res.status_code}") if res.status_code != 200: print(res.text) sys.exit(1) with open('puppies.jpg', 'wb') as f: f.write(res.content) ``` ```bash python main.py ``` ### curl ```bash set -euo pipefail job=$(cat <