| | <!DOCTYPE html> |
| | <html lang="en"> |
| | <head> |
| | <meta charset="UTF-8"> |
| | <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| | <title>Image Generation API</title> |
| | <style> |
| | body { |
| | font-family: 'Arial', sans-serif; |
| | background-color: #0d1117; |
| | color: #c9d1d9; |
| | padding: 20px; |
| | } |
| | .container { |
| | max-width: 850px; |
| | margin: auto; |
| | background: #161b22; |
| | padding: 25px; |
| | border-radius: 10px; |
| | box-shadow: 0px 4px 10px rgba(0, 0, 0, 0.5); |
| | border: 1px solid #30363d; |
| | } |
| | h1 { |
| | color: #58a6ff; |
| | text-align: center; |
| | } |
| | h2, h3 { |
| | color: #1f6feb; |
| | } |
| | p { |
| | line-height: 1.6; |
| | } |
| | .endpoint { |
| | padding: 15px; |
| | border-bottom: 1px solid #30363d; |
| | } |
| | code, pre { |
| | display: block; |
| | background-color: #0d1117; |
| | color: #58a6ff; |
| | padding: 10px; |
| | border-radius: 5px; |
| | font-family: 'Courier New', monospace; |
| | white-space: pre-wrap; |
| | word-wrap: break-word; |
| | border-left: 4px solid #58a6ff; |
| | } |
| | .footer { |
| | text-align: center; |
| | margin-top: 20px; |
| | color: #8b949e; |
| | } |
| | |
| | h1{ |
| | font-family: 'Trebuchet MS', 'Lucida Sans Unicode', 'Lucida Grande', 'Lucida Sans', Arial, sans-serif; |
| | color: rgb(3, 234, 219); |
| | padding: 1em; |
| | font-size: 3em; |
| | font-weight: bolder; |
| | } |
| | |
| | .baseurl{ |
| | font-family: 'Trebuchet MS', 'Lucida Sans Unicode', 'Lucida Grande', 'Lucida Sans', Arial, sans-serif; |
| | text-transform:inherit; |
| | position: relative; |
| | text-align: center; |
| | font-size: 1.3em; |
| | } |
| | |
| | .h3{ |
| | font-size: 1.5em; |
| | color: #58a6ff; |
| | |
| | } |
| | |
| | </style> |
| | </head> |
| | <body> |
| | <div class="container"> |
| | <h1>Image Generation API</h1> |
| | <h2>⚡ Available Endpoints</h2> |
| |
|
| | <div class="baseurl"> |
| | <div> |
| | <span class="h3" >[</span> |
| | <span>BASEURL</span> |
| | <span class="h3">]</span> |
| | <span class="h3">:</span> |
| | <span> |
| | <span class="h3">"</span> |
| | <span>HTTPS://ADARSHJI-API.HF.SPACE/</span> |
| | <span class="h3">"</span> |
| | </span> |
| | </div> |
| | </div> |
| | |
| | <div class="endpoint"> |
| | <h3>🚀 Generate Image</h3> |
| | <p><strong>Endpoint:</strong> <code>[POST] /generate/image</code></p> |
| | <p><strong>Description:</strong> Generates an AI image based on the given prompt.</p> |
| | <p><strong>Request Body:</strong></p> |
| | <pre>{ |
| | "prompt": "A futuristic cityscape", |
| | "model": "black-forest-labs-flux-1-dev", |
| | "width": 1024, |
| | "height": 1024, |
| | "guidance_scale": 3.5, |
| | "seed": 0, |
| | "provider": "blackforestlabs" |
| | }</pre> |
| | <p><strong>Response Example:</strong></p> |
| | <pre>{ |
| | "Result": "http://adarshji-api.hf.space/images/1234567890.jpg" |
| | }</pre> |
| | </div> |
| |
|
| | <div class="endpoint"> |
| | <h3>📌 Get Available Providers</h3> |
| | <p><strong>Endpoint:</strong> <code>[POST] /providers</code></p> |
| | <p><strong>Description:</strong> Retrieves a list of supported image providers.</p> |
| | <p><strong>Response Example:</strong></p> |
| | <pre>{ |
| | "providers": ["blackforestlabs", "flux", "blackforestlabs-schnell"] |
| | }</pre> |
| | </div> |
| |
|
| | <div class="endpoint"> |
| | <h3>📋 Get Models by Provider</h3> |
| | <p><strong>Endpoint:</strong> <code>GET /generate/image/model</code></p> |
| | <p><strong>Description:</strong> Retrieves available models for a given provider.</p> |
| | <p><strong>Request Body:</strong></p> |
| | <pre>{ |
| | "provider": "blackforestlabs" |
| | }</pre> |
| | <p><strong>Response Example:</strong></p> |
| | <pre>{ |
| | "models": ["flux-1", "flux-2", "hyper-realistic-v3"] |
| | }</pre> |
| | </div> |
| |
|
| | <div class="endpoint"> |
| | <h3>🏠 Homepage</h3> |
| | <p><strong>Endpoint:</strong> <code>GET /</code></p> |
| | <p><strong>Description:</strong> Returns this documentation page.</p> |
| | </div> |
| |
|
| | <h2>🐍 Python Usage Example</h2> |
| | <p>Here is how you can use the API in Python to generate an image:</p> |
| | <pre><code> |
| | 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.") |
| | |
| | </code></pre> |
| |
|
| | <div class="footer"> |
| | <p>🚀 API v1.0 | Designed By ADARSH ❤❤</p> |
| | </div> |
| | </div> |
| | </body> |
| | </html> |
| |
|
