Generate an image

Generate images from text. Drop-in replacement for OpenAI /v1/images/generations.

Supported models: openai/gpt-image-1.5, openai/dall-e-3, google/gemini-3.1-flash-image, google/gemini-3.1-flash-lite-image, google/gemini-2.5-flash-image, google/gemini-3-pro-image.

POST

https://truememory-api.mvstg.com/v1/images/generations

View as Markdown

Authorization

HTTPBearerHTTPrequired

Header parameters

X-On-Behalf-Ofoptional
One of the following:
string
null
}
X-External-User-Idoptional
One of the following:
string
null
}
X-App-Idoptional
One of the following:
string
null
}

Request bodyJSONrequired

modelstringrequired
Model to use, e.g. 'openai/gpt-image-1.5' or 'google/gemini-3.1-flash-image'
promptstringrequired
Text description of the desired image
noptionalinteger
maximum: 10 · minimum: 1 · default: 1
sizeoptional
Image size, e.g. '1024x1024'
One of the following:
string
null
}
qualityoptional
Image quality, e.g. 'auto', 'hd'
One of the following:
string
null
}
response_formatoptionalurlorb64_json
Response format. Google models always return b64_json.

default: "b64_json"
styleoptional
Image style (dall-e-3 only)
One of the following:
string
null
}

Returns

200

Successful Response

JSON

createdintegerrequired
dataarray ofobjectrequired
- b64_jsonoptional
  One of the following:
  string
  null
- urloptional
  One of the following:
  string
  null
- revised_promptoptional
  One of the following:
  string
  null
}

422

Validation Error

JSON

detailoptionalarray ofobject
- locarray ofrequired
  One of the following:
  string
  integer
- msgstringrequired
- typestringrequired
- inputoptionalunknown
- ctxoptionalobject
}

curl --request POST \ --url https://truememory-api.mvstg.com/v1/images/generations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model": "string", "prompt": "string", "n": 1, "size": "string", "quality": "string", "response_format": "url", "style": "string" } '