gpt-image-2 Image Generation API

curl --request POST \
  --url https://octopusx.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "n": 123,
  "size": "<string>",
  "image": [
    "<string>"
  ],
  "response_format": "<string>",
  "quality": "<string>",
  "style": {},
  "background": {},
  "watermark": true
}
'

import requests

url = "https://octopusx.ai/v1/images/generations"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "n": 123,
    "size": "<string>",
    "image": ["<string>"],
    "response_format": "<string>",
    "quality": "<string>",
    "style": {},
    "background": {},
    "watermark": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    n: 123,
    size: '<string>',
    image: ['<string>'],
    response_format: '<string>',
    quality: '<string>',
    style: {},
    background: {},
    watermark: true
  })
};

fetch('https://octopusx.ai/v1/images/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://octopusx.ai/v1/images/generations",
  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([
    'model' => '<string>',
    'prompt' => '<string>',
    'n' => 123,
    'size' => '<string>',
    'image' => [
        '<string>'
    ],
    'response_format' => '<string>',
    'quality' => '<string>',
    'style' => [
        
    ],
    'background' => [
        
    ],
    'watermark' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://octopusx.ai/v1/images/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"size\": \"<string>\",\n  \"image\": [\n    \"<string>\"\n  ],\n  \"response_format\": \"<string>\",\n  \"quality\": \"<string>\",\n  \"style\": {},\n  \"background\": {},\n  \"watermark\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://octopusx.ai/v1/images/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"size\": \"<string>\",\n  \"image\": [\n    \"<string>\"\n  ],\n  \"response_format\": \"<string>\",\n  \"quality\": \"<string>\",\n  \"style\": {},\n  \"background\": {},\n  \"watermark\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://octopusx.ai/v1/images/generations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"size\": \"<string>\",\n  \"image\": [\n    \"<string>\"\n  ],\n  \"response_format\": \"<string>\",\n  \"quality\": \"<string>\",\n  \"style\": {},\n  \"background\": {},\n  \"watermark\": true\n}"

response = http.request(request)
puts response.read_body

{
  "created": 1735689600,
  "data": [
    {
      "url": "https://.../images/img-abc123.png",
      "revised_prompt": "A modern homepage illustration for an API platform, white background, teal-blue blocks, clean whitespace"
    }
  ]
}

{
  "created": 1735689600,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
      "revised_prompt": "A modern homepage illustration for an API platform, white background, teal-blue blocks, clean whitespace"
    }
  ]
}

POST

https://octopusx.ai

images

generations

gpt-image-2 Image Generation API

curl --request POST \
  --url https://octopusx.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "n": 123,
  "size": "<string>",
  "image": [
    "<string>"
  ],
  "response_format": "<string>",
  "quality": "<string>",
  "style": {},
  "background": {},
  "watermark": true
}
'

import requests

url = "https://octopusx.ai/v1/images/generations"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "n": 123,
    "size": "<string>",
    "image": ["<string>"],
    "response_format": "<string>",
    "quality": "<string>",
    "style": {},
    "background": {},
    "watermark": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    n: 123,
    size: '<string>',
    image: ['<string>'],
    response_format: '<string>',
    quality: '<string>',
    style: {},
    background: {},
    watermark: true
  })
};

fetch('https://octopusx.ai/v1/images/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://octopusx.ai/v1/images/generations",
  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([
    'model' => '<string>',
    'prompt' => '<string>',
    'n' => 123,
    'size' => '<string>',
    'image' => [
        '<string>'
    ],
    'response_format' => '<string>',
    'quality' => '<string>',
    'style' => [
        
    ],
    'background' => [
        
    ],
    'watermark' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://octopusx.ai/v1/images/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"size\": \"<string>\",\n  \"image\": [\n    \"<string>\"\n  ],\n  \"response_format\": \"<string>\",\n  \"quality\": \"<string>\",\n  \"style\": {},\n  \"background\": {},\n  \"watermark\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://octopusx.ai/v1/images/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"size\": \"<string>\",\n  \"image\": [\n    \"<string>\"\n  ],\n  \"response_format\": \"<string>\",\n  \"quality\": \"<string>\",\n  \"style\": {},\n  \"background\": {},\n  \"watermark\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://octopusx.ai/v1/images/generations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"size\": \"<string>\",\n  \"image\": [\n    \"<string>\"\n  ],\n  \"response_format\": \"<string>\",\n  \"quality\": \"<string>\",\n  \"style\": {},\n  \"background\": {},\n  \"watermark\": true\n}"

response = http.request(request)
puts response.read_body

{
  "created": 1735689600,
  "data": [
    {
      "url": "https://.../images/img-abc123.png",
      "revised_prompt": "A modern homepage illustration for an API platform, white background, teal-blue blocks, clean whitespace"
    }
  ]
}

{
  "created": 1735689600,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
      "revised_prompt": "A modern homepage illustration for an API platform, white background, teal-blue blocks, clean whitespace"
    }
  ]
}

gpt-image-2 Image Generation API

gpt-image-2 uses a unified image generation entry, suitable for text-to-image requests based on standard ratios and size tiers.

The unified entry is POST /v1/images/generations.
Select the target model by setting model = "gpt-image-2".
Supports both url and b64_json response formats.
You can include image in JSON as a reference image; whether it takes effect depends on the actual image channel that is matched.
If n is omitted or explicitly set to 0, the unified layer falls back to 1.

Method and Path

POST /v1/images/generations

Request Example

curl -X POST https://octopusx.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A modern homepage illustration for an API platform, white background, teal-blue blocks, clean whitespace",
    "n": 1,
    "size": "1536x1024",
    "response_format": "url"
  }'

import requests

resp = requests.post(
    "https://octopusx.ai/v1/images/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-image-2",
        "prompt": "A modern homepage illustration for an API platform, white background, teal-blue blocks, clean whitespace",
        "n": 1,
        "size": "1536x1024",
        "response_format": "url",
    },
    timeout=60,
)
print(resp.json())

const response = await fetch("https://octopusx.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2",
    prompt: "A modern homepage illustration for an API platform, white background, teal-blue blocks, clean whitespace",
    n: 1,
    size: "1536x1024",
    response_format: "url",
  }),
});

console.log(await response.json());

Response Example

{
  "created": 1735689600,
  "data": [
    {
      "url": "https://.../images/img-abc123.png",
      "revised_prompt": "A modern homepage illustration for an API platform, white background, teal-blue blocks, clean whitespace"
    }
  ]
}

{
  "created": 1735689600,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
      "revised_prompt": "A modern homepage illustration for an API platform, white background, teal-blue blocks, clean whitespace"
    }
  ]
}

Authentication

Authorization: Bearer YOUR_API_KEY

Body

model

string

required

Must be set to gpt-image-2.

prompt

string

Generation prompt. For text-to-image semantics, this should be treated as required.

integer

Number of images to generate. If omitted or explicitly set to 0, the unified layer falls back to 1.

size

string

Output size. Common base tiers are 1024x1024、1536x1152、1536x1024、1024x1536、1920x1080、1080x1920.

image

string | array<string> | object

Optional reference image input. Commonly written as a Base64 string or Base64 array, suitable for channels that require image style reference.

response_format

string

Response format. Common values are url and b64_json.

quality

string

Quality field. Whether it actually takes effect depends on the final matched channel.

style

string | object

Style field, passed through as-is to supported upstreams.

background

string | object

Background control field, passed through as-is to supported upstreams.

watermark

boolean

Explicit watermark switch. false and omission have different semantics.

Base Ratios and Size Tiers

Preset	Actual Target Size
`1:1`	`1024x1024`
`4:3`	`1536x1152`
`3:2`	`1536x1024`
`2:3`	`1024x1536`
`16:9`	`1920x1080`
`9:16`	`1080x1920`

If the actual channel does not natively accept the target size, the gateway or plugin will fall back to a closer official size and append the ratio intent to the prompt.

Response

created

integer

Generation timestamp.

data[].url

string

The image URL returned when response_format = url.

data[].b64_json

string

The Base64 image data returned when response_format = b64_json.

data[].revised_prompt

string

Some upstreams rewrite the prompt and return it in this field.

Gemini Image Generation API Jimeng Image Overview

Overview

Text Models

Image Models

Video Models

Uploads

Tasks

Account

gpt-image-2 Image Generation API

gpt-image-2 Image Generation API

Method and Path

Request Example

Response Example

Authentication

Body

Base Ratios and Size Tiers

Response

​gpt-image-2 Image Generation API

​Method and Path

​Request Example

​Response Example

​Authentication

​Body

​Base Ratios and Size Tiers

​Response

​Related APIs

gpt-image-2 Image Generation API

Method and Path

Request Example

Response Example

Authentication

Body

Base Ratios and Size Tiers

Response

Related APIs