Image Generation API

⚡ Available Endpoints

[ BASEURL ] : " HTTPS://ADARSHJI-API.HF.SPACE/ "

🚀 Generate Image

Endpoint: [POST] /generate/image

Description: Generates an AI image based on the given prompt.

Request Body:

{
    "prompt": "A futuristic cityscape",
    "model": "black-forest-labs-flux-1-dev",
    "width": 1024,
    "height": 1024,
    "guidance_scale": 3.5,
    "seed": 0,
    "provider": "blackforestlabs"
}

Response Example:

{
    "Result": "http://adarshji-api.hf.space/images/1234567890.jpg"
}

📌 Get Available Providers

Endpoint: [POST] /providers

Description: Retrieves a list of supported image providers.

Response Example:

{
    "providers": ["blackforestlabs", "flux", "blackforestlabs-schnell"]
}

📋 Get Models by Provider

Endpoint: GET /generate/image/model

Description: Retrieves available models for a given provider.

Request Body:

{
    "provider": "blackforestlabs"
}

Response Example:

{
    "models": ["flux-1", "flux-2", "hyper-realistic-v3"]
}

🏠 Homepage

Endpoint: GET /

Description: Returns this documentation page.

🐍 Python Usage Example

Here is how you can use the API in Python to generate an image:


import requests

BASE_URL = "https://adarshji-api.hf.space/"

def generate_image(
    prompt,
    model="black-forest-labs-flux-1-dev",
    width=1024,
    height=1024,
    guidance_scale=3.5,
    seed=0,
    provider="blackforestlabs"
    ):
    
    url = f"{BASE_URL}/generate/image"
    
    payload = {
        "prompt": prompt,
        "model": model,
        "width": width,
        "height": height,
        "guidance_scale": guidance_scale,
        "seed": seed,
        "provider": provider
    }
    
    headers = {'Content-Type': 'application/json'}
    
    response = requests.post(url, json=payload, headers=headers)
    
    if response.status_code == 200:
    
        try:
            data = response.json()
            print("Image URL:", data)
        except requests.exceptions.JSONDecodeError:
            print("Error: Failed to decode JSON response.")
    
    else:
        print(f"Error: {response.status_code}, {response.text}")

def get_providers():

    url = f"{BASE_URL}/providers"

    headers = {'Content-Type': 'application/json'}
    
    response = requests.get(url, headers=headers)
    
    if response.status_code == 200:
        try:
        data = response.json()
        print("Available Providers:", data.get("providers"))
        except requests.exceptions.JSONDecodeError:
            print("Error: Failed to decode JSON response.")
    else:
        print(f"Error: {response.status_code}, {response.text}")
            
def get_models(provider="blackforestlabs"):
    url = f"{BASE_URL}/generate/image/model"
    payload = {"provider": provider}
    headers = {'Content-Type': 'application/json'}
    
    response = requests.post(url, json=payload, headers=headers)
    
    if response.status_code == 200:
    try:
        data = response.json()
        print(f"Models for {provider}:", data.get("models"))
    except requests.exceptions.JSONDecodeError:
        print("Error: Failed to decode JSON response.")
    else:
        print(f"Error: {response.status_code}, {response.text}")

if __name__ == "__main__":
    print("Getting providers:")
    get_providers()

    print("\nGetting models for 'blackforestlabs':")
    get_models("blackforestlabs")

    print("\nGenerating image:")
    generate_image(prompt="A beautiful sunset over the ocean.")