# GPT Image 2 IMAGEFeaturedopenai-gpt-image-2 **GPT Image 2** is [OpenAI’s](https://openai.com) most advanced image generation model, featuring dramatically improved text rendering, UI generation, and photorealism. With native output support up to 3840px (4K) and three quality tiers (low, medium, high), it delivers exceptional detail and clarity. The model excels at following complex multi-part prompts and maintains consistent style across generations, making it ideal for professional creative workflows. Best for Posters, ads, and UI mockups with crisp text, Photoreal hero imagery at poster-size resolution, Brand-consistent campaign art across variations POST /v2/workspaces/{workspace\_id}/base-models/openai-gpt-image-2/inferences ```bash curl --request POST \ --url https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/openai-gpt-image-2/inferences \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "prompt": "a knight standing in a snowy forest", "aspect_ratio": "SQUARE_1K", "quality": "HIGH", "transparency": false, "guidance_file_init_image": [ { "url": "" } ], "guidance_file_reference_image": [ { "url": "" } ] }' ``` ```python import requests url = "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/openai-gpt-image-2/inferences" payload = { "prompt": "a knight standing in a snowy forest", "aspect_ratio": "SQUARE_1K", "quality": "HIGH", "transparency": False, "guidance_file_init_image": [{ "url": "" }], "guidance_file_reference_image": [{ "url": "" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```js const url = 'https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/openai-gpt-image-2/inferences'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"prompt":"a knight standing in a snowy forest","aspect_ratio":"SQUARE_1K","quality":"HIGH","transparency":false,"guidance_file_init_image":[{"url":""}],"guidance_file_reference_image":[{"url":""}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/openai-gpt-image-2/inferences" payload := strings.NewReader("{\n \"prompt\": \"a knight standing in a snowy forest\",\n \"aspect_ratio\": \"SQUARE_1K\",\n \"quality\": \"HIGH\",\n \"transparency\": false,\n \"guidance_file_init_image\": [\n {\n \"url\": \"\"\n }\n ],\n \"guidance_file_reference_image\": [\n {\n \"url\": \"\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```php "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/openai-gpt-image-2/inferences", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => json_encode([ 'prompt' => 'a knight standing in a snowy forest', 'aspect_ratio' => 'SQUARE_1K', 'quality' => 'HIGH', 'transparency' => null, 'guidance_file_init_image' => [ [ 'url' => '' ] ], 'guidance_file_reference_image' => [ [ 'url' => '' ] ] ]), CURLOPT_HTTPHEADER => [ "Authorization: Bearer ", "Content-Type: application/json" ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` ```java OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\n \"prompt\": \"a knight standing in a snowy forest\",\n \"aspect_ratio\": \"SQUARE_1K\",\n \"quality\": \"HIGH\",\n \"transparency\": false,\n \"guidance_file_init_image\": [\n {\n \"url\": \"\"\n }\n ],\n \"guidance_file_reference_image\": [\n {\n \"url\": \"\"\n }\n ]\n}"); Request request = new Request.Builder() .url("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/openai-gpt-image-2/inferences") .post(body) .addHeader("Authorization", "Bearer ") .addHeader("Content-Type", "application/json") .build(); Response response = client.newCall(request).execute(); ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/openai-gpt-image-2/inferences") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"prompt\": \"a knight standing in a snowy forest\",\n \"aspect_ratio\": \"SQUARE_1K\",\n \"quality\": \"HIGH\",\n \"transparency\": false,\n \"guidance_file_init_image\": [\n {\n \"url\": \"\"\n }\n ],\n \"guidance_file_reference_image\": [\n {\n \"url\": \"\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```csharp var client = new RestClient("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/base-models/openai-gpt-image-2/inferences"); var request = new RestRequest("", Method.Post); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"prompt\": \"a knight standing in a snowy forest\",\n \"aspect_ratio\": \"SQUARE_1K\",\n \"quality\": \"HIGH\",\n \"transparency\": false,\n \"guidance_file_init_image\": [\n {\n \"url\": \"\"\n }\n ],\n \"guidance_file_reference_image\": [\n {\n \"url\": \"\"\n }\n ]\n}", ParameterType.RequestBody); var response = client.Execute(request); ``` * Production ## Authorizations * **[bearerAuth](/docs/v2/rest-api#bearerauth)** ## Parameters ### Path Parameters **workspace\_id** required _Workspace Id_ Id of the workspace that owns the resource. string format: uuid Id of the workspace that owns the resource. ### Query Parameters **session\_name** Any of: **string** string **null** null Organize this run under a named session. A new session is created if none matches. ## Request Bodyrequired _GPT Image 2_object **prompt** required _Prompt_ string **aspect\_ratio** _Aspect Ratio_ string default: SQUARE\_1K Allowed values: SQUARE\_1K LANDSCAPE\_4\_3\_1K PORTRAIT\_3\_4\_1K LANDSCAPE\_3\_2\_1K PORTRAIT\_2\_3\_1K SQUARE\_2K LANDSCAPE\_4\_3\_2K PORTRAIT\_3\_4\_2K LANDSCAPE\_16\_9\_2K PORTRAIT\_9\_16\_2K LANDSCAPE\_16\_9\_2.5K PORTRAIT\_9\_16\_2.5K LANDSCAPE\_16\_9\_4K PORTRAIT\_9\_16\_4K **quality** _Quality_ string default: HIGH Allowed values: LOW MEDIUM HIGH **seed** _Seed_ _Advanced field._ integer nullable **transparency** _Transparent Background_ boolean **guidance\_file\_init\_image** _Source image_ The image to modify Array _InferenceFormFileRef_ A single guidance/reference file supplied to a `reference_image_list` field. The slot’s guidance `type` is fixed by the field it’s attached to; the caller supplies the file URL and, where the model supports per-file weighting, a weight. object **url** required _Url_ string **weight** _Weight_ number nullable **guidance\_file\_reference\_image** _Reference image_ Guides the edit Array _InferenceFormFileRef_ A single guidance/reference file supplied to a `reference_image_list` field. The slot’s guidance `type` is fixed by the field it’s attached to; the caller supplies the file URL and, where the model supports per-file weighting, a weight. object **url** required _Url_ string **weight** _Weight_ number nullable **prompt\_language** _Prompt Language_ _Advanced field._ string nullable ##### Example ```json { "prompt": "a knight standing in a snowy forest", "aspect_ratio": "SQUARE_1K", "quality": "HIGH", "transparency": false, "guidance_file_init_image": [ { "url": "" } ], "guidance_file_reference_image": [ { "url": "" } ] } ``` ## Responses ### 202 Successful Response _ExecuteForgeOutput_object **inference\_id** required _Inference Id_ Unique identifier for this forge run. string format: uuid **status** required _InferenceStatus_ Current status: IN\_PROGRESS. string Allowed values: in\_progress complete failed cancelled deleted **estimated\_price\_creative\_units** Any of: **number** number **null** null **poll\_interval\_seconds** required _Poll Interval Seconds_ Suggested polling interval in seconds. integer **created\_at** required _Created At_ Timestamp of when the run was created. string format: date-time **session\_id** Any of: **string** string format: uuid **null** null **normalized\_parameters** Any of: **NormalizedInferenceParameters** _NormalizedInferenceParameters_ Inference parameters after model-specific normalization. These reflect the actual values used for generation, including model defaults applied for any parameters not explicitly set. object **width** Any of: **null** integer **integer** null **height** Any of: **null** integer **integer** null **batch\_size** Any of: **null** integer **integer** null **num\_inference\_steps** Any of: **null** integer **integer** null **guidance\_scale** Any of: **null** number **number** null **duration\_seconds** Any of: **null** number **number** null **fps** Any of: **null** integer **integer** null **null** null ##### Example ```json { "status": "in_progress" } ``` ### 401 Unauthenticated — missing or invalid Bearer token. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 403 Forbidden — insufficient permissions. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 404 Resource not found. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 422 Invalid input parameters. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 429 Rate limited — too many concurrent requests. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 500 Internal server error. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ```