Image

Generate images

Generate one or more images from a text prompt.

Two output modes are available:

  • output_type: "data_url" (default) — Returns JSON with base64-encoded data URLs. Supports multiple images (n >= 1).
  • output_type: "file" — Returns the raw binary file directly. Only supports a single output (n = 1).
POST
/image/generate
Sign-In-With-X<token>

Base64-encoded JSON envelope containing a CAIP-122 sign-in message and its cryptographic signature.

{
  "message": "<CAIP-122 message>",
  "signature": "<base58 for Solana, hex for EVM>"
}

In: header

Request Body

application/json

model*string

Canonical model slug (e.g. dall-e-3, flux-pro).

prompt*string

Text prompt describing the desired image.

negative_prompt?string

Things to avoid in the generated image.

n?integer

Number of images to generate (1–10).

Default1
Range1 <= value <= 10
width?string

Output image width in pixels (e.g. "1024").

height?string

Output image height in pixels (e.g. "1024").

aspect_ratio?string

Aspect ratio hint (e.g. 16:9, 1:1).

style?string

Free-form style hint.

quality?string

Quality level: low, medium, high, or auto.

Value in"low" | "medium" | "high" | "auto"
output_format?string

Output format: png, jpeg, or webp. Defaults to png.

Value in"png" | "jpeg" | "webp"
output_type?string

data_url for JSON response with base64 images, file for raw binary (single image only).

Value in"data_url" | "file"
seed?integer

-1 for nondeterministic; 0–2147483647 for reproducible results.

guide_scale?number

Guidance scale (0.0–50.0).

stream?boolean

Whether to stream intermediate results.

steps?integer

Number of inference steps.

style_preset?string

Image style preset (e.g. 3D Model, Anime).

resolution?string

Resolution tier (e.g. 1K, 2K, 4K).

hide_watermark?boolean

Whether to hide the watermark.

lora_strength?integer

LoRA strength (0–100).

safe_mode?boolean

Whether to blur adult content.

embed_exif_metadata?boolean

Whether to embed the prompt in EXIF metadata.

enable_web_search?boolean

Whether to enable web search during generation.

user?string

End-user identifier for auditing.

metadata?object

Free-form metadata (max ~4 KB).

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://beta.aimo.network/api/v1/image/generate" \  -H "Content-Type: application/json" \  -d '{    "model": "dall-e-3",    "prompt": "string"  }'
{
  "id": "req-abc123",
  "created": 0,
  "status": "completed",
  "images": [
    {
      "index": 0,
      "data_url": "string",
      "width": 0,
      "height": 0,
      "format": "string",
      "seed": 0
    }
  ],
  "error": {
    "error": {
      "code": "string",
      "message": "string"
    }
  },
  "provider_metadata": {
    "provider": "string",
    "raw": {}
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}