Image Generation

AlphaNeural supports OpenAI-compatible image generation for GPT-style image models (and any provider-backed image model you expose through the OpenAI Images interface). The API shape matches OpenAI’s

Create an image

POST /v1/images/generations

You can also find an Azure-style compatibility route in the proxy (/openai/deployments/{model}/images/generations). This docs page focuses on /v1/images/generations.

Request body

AlphaNeural follows the OpenAI Images API request shape. The most commonly used fields are:

• model (string). Image model ID to use.

• prompt (string). Text description of the image you want.

• n (integer). Number of images to generate.

• size (string). Output dimensions (supported values depend on the model).

• quality (string). Quality level (supported values depend on the model).

• style (string). Style hint (primarily for DALL·E models).

• response_format (string). url or b64_json for DALL·E models. Note. GPT image models always return base64 and do not support response_format.

• user (string). End-user identifier for abuse monitoring.

response_format is not supported for GPT image models in OpenAI’s API, because they always return base64-encoded image payloads

Model availability varies by workspace, teams and provider. Use GET /v1/models to discover image-capable models exposed by your AlphaNeural key.

Examples

cURL

curl https://proxy.alfnrl.io/v1/images/generations \
  -H "Authorization: Bearer $ALPHANEURAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A cute baby sea otter in a knitted hat, studio lighting",
    "size": "1024x1024",
    "n": 1
  }'

Python (OpenAI SDK)

from openai import OpenAI
import os, base64
client = OpenAI(api_key=os.environ["ALPHANEURAL_API_KEY"], base_url="https://proxy.alfnrl.io/v1")
r = client.images.generate(model="gpt-image-1", prompt="A tiny robot making espresso, cinematic", size="1024x1024")
img_b64 = r.data[0].b64_json
open("image.png","wb").write(base64.b64decode(img_b64))

Response

The response matches the OpenAI Images API. You will receive a data array with one item per generated image. Depending on the model, each item contains either:

• b64_json (base64-encoded image), or

• url (a temporary URL)

If you receive URLs, they are time-limited. OpenAI’s reference behaviour is that URLs expire after about 60 minutes. OpenAI Platform

Example (truncated):

{
  "created": 1730000000,
  "data": [
    { "b64_json": "iVBORw0KGgoAAA..." }
  ]
}

Decode b64_json

import os, base64, requests
r = requests.post(
  "https://proxy.alfnrl.io/v1/images/generations",
  headers={"Authorization": f"Bearer {os.environ['ALPHANEURAL_API_KEY']}",
           "Content-Type": "application/json"},
  json={"model":"gpt-image-1","prompt":"A minimal owl logo","size":"1024x1024"}
)
b64 = r.json()["data"][0]["b64_json"]
open("out.png","wb").write(base64.b64decode(b64))