API Reference

Images

POST /v1/images/generations — generate images from a text prompt using FLUX.

Endpoint

http

POST https://api.satryx.ai/v1/images/generations

Request parameters

Parameter	Type	Description
promptrequired	string	Text description of the desired image. More detail = better results.
model	string	Model ID. Currently: "flux-dev". Default: "flux-dev".
n	integer	Number of images to generate. 1–4. Default 1.
size	string	Output resolution. "512x512" \| "1024x1024" \| "1024x1792" \| "1792x1024". Default "1024x1024".
response_format	string	"url" (default) — returns a temporary CDN URL. "b64_json" — returns base-64 PNG.

Note:URLs expire after 1 hour. Download and store images you want to keep.

Example

curl

curl https://api.satryx.ai/v1/images/generations \
  -H "Authorization: Bearer $SATRYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A misty mountain at sunrise, oil painting",
    "model": "flux-dev",
    "n": 1,
    "size": "1024x1024"
  }'

json

{
  "created": 1714000000,
  "data": [
    {
      "url": "https://cdn.satryx.ai/images/gen_abc123.png",
      "revised_prompt": null
    }
  ]
}

Models

Parameter	Type	Description
flux-dev	image	FLUX.1-dev. High-quality photorealistic and artistic images. $0.025 per image.

Pricing

Images are billed per image generated, regardless of size. Failed generations (non-200 responses) are not billed.

Current rate: $0.025 per image (25,000 micros).

Prompt tips

Include style descriptors: "oil painting", "photorealistic", "digital art", "cinematic".
Specify lighting: "golden hour", "neon lit", "overcast".
Add camera terms for realism: "shot on 35mm", "shallow depth of field".
Describe the subject before the style: subject → environment → style → lighting → mood.