Skip to main content
Method: POST
Endpoint: https://api.sciforium.com/v1/images/generations

​
Overview

The /v1/images/generations endpoint creates images from a text prompt and generation parameters.

​
Request Body Parameters

The API expects a JSON body. model and prompt are required.
ParameterTypeRequiredDescription
modelstringYesThe model ID to use.
promptstringYesA text description of the desired image.
nintegerNoNumber of images to generate (commonly 1).
sizestringNoOutput dimensions. Typical values include 1024x1024, 1536x1024, 1024x1536, or auto (model-dependent).
qualitystringNoRendering quality (model-dependent), e.g. low, medium, high.
response_formatstringNoResponse payload format: url or b64_json.
backgroundstringNoBackground mode (model-dependent), e.g. transparent, opaque, auto.
stylestringNoNot currently supported.

​
Example response

The API returns a JSON object containing a timestamp and a data array.
  • created: Unix timestamp when the request was processed.
  • data: Array of image objects, each with:
    • url or b64_json: image output
    • revised_prompt: prompt rewritten by the model
{
  "created": 1775612596,
  "data": [
    {
      "url": "https://oaidalleapiprodscus.blob.core.windows.net/...",
      "revised_prompt": "A sprawling, futuristic metropolitan skyline constructed entirely over shimmering turquoise ocean waters. Skyscrapers are connected by glass bridges, with neon lights reflecting off the waves. The scene is captured in a cinematic style with high contrast and sharp 8k detail."
    }
  ]
}