Skip to main content
POST

Authorizations

string
default:"Bearer ${YOUR_API_KEY}"
required
Neural4D API key using the Bearer scheme.

Body application/json

enum<string>
required
GPT Image 2 model identifier.Available option: openai/gpt-image-2.
string
required
Text instruction describing the image to generate or edit.Required string length: 1 - 500.
object[]
Optional reference images uploaded through POST /openapi/v1/files. Only image references are supported. Supported formats are JPG, JPEG, PNG, and WEBP.Allowed array length: 0 - 6 elements.
integer
default:1
Number of image generation tasks to create.Required range: 1 <= x <= 4.
enum<string>
default:"2K"
Named output resolution.Available options: 1K, 2K, 4K.
enum<string>
default:"1:1"
Target image width-to-height ratio.Available options: 1:1, 16:9, 9:16, 4:3, 3:4.

Response

Generation tasks accepted
string
required
Batch task ID returned by the generation request.Example: "normal-image-c50fe63e-699d-4d61-93f5-2099ab159d6d".
object[]
required
Generated child items created by the request.Allowed array length: at least 1 element.
enum<string>
required
Current status shared by the submitted image tasks.Available options: queued, processing, succeeded, failed.
integer<int64>
required
Unix timestamp in seconds when the batch task was created.
enum<string>
required
Image generation mode shared by the submitted tasks.Available options: text_to_image, image_to_image.
enum<string>
required
Image generation model used by the submitted tasks.Available options: openai/gpt-image-2, google/nano-banana-pro, bytedance/seedream-4.5, black-forest-labs/flux-2-pro.
object
Total credits charged for the submitted tasks when available.