| <!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> |
|
|
