TsgcHTTP_API_OpenAI › Methods › CreateImage

CreateImage Method

Generates one or more images from a text prompt using the OpenAI Images endpoint

Syntax

function CreateImage(const aRequest: TsgcOpenAIClass_Request_Image) : TsgcOpenAIClass_Response_Image;

Parameters

Name	Type	Description
aRequest	const TsgcOpenAIClass_Request_Image	Request payload describing the prompt, model, number of images, size, quality and response format.

Return Value

Parsed response object exposing the generated images as URLs or base64-encoded PNG data. (TsgcOpenAIClass_Response_Image)

Remarks

Issues a POST to /v1/images/generations, synthesizing images with DALL-E 2, DALL-E 3 or gpt-image-1. Supply the textual prompt, desired resolution (for example 1024x1024, 1792x1024) and how many samples to produce. When response_format is url the returned URLs are valid for a short time; use b64_json to receive the image bytes inline and save them locally.

Example

oRequest := TsgcOpenAIClass_Request_Image.Create;
try
  oRequest.Model := 'gpt-image-1';
  oRequest.Prompt := 'A watercolor painting of a Delphi coder at sunset';
  oRequest.Size := '1024x1024';
  oRequest.N := 1;
  oResponse := oAPI.CreateImage(oRequest);
  ShowMessage(oResponse.Data[0].Url);
finally
  oRequest.Free;
end;

Back to Methods