Image Generation API - BetterToken

cURL

curl 'https://bettertoken.ai/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json",
    "output_format": "png"
  }'

import requests

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

payload = {
    "model": "gpt-image-2",
    "prompt": "A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json",
    "output_format": "png"
}
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: 'gpt-image-2',
    prompt: 'A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.',
    n: 1,
    size: '1024x1024',
    response_format: 'b64_json',
    output_format: 'png'
  })
};

fetch('https://bettertoken.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://bettertoken.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' => 'gpt-image-2',
    'prompt' => 'A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.',
    'n' => 1,
    'size' => '1024x1024',
    'response_format' => 'b64_json',
    'output_format' => 'png'
  ]),
  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://bettertoken.ai/v1/images/generations"

	payload := strings.NewReader("{\n  \"model\": \"gpt-image-2\",\n  \"prompt\": \"A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.\",\n  \"n\": 1,\n  \"size\": \"1024x1024\",\n  \"response_format\": \"b64_json\",\n  \"output_format\": \"png\"\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://bettertoken.ai/v1/images/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"gpt-image-2\",\n  \"prompt\": \"A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.\",\n  \"n\": 1,\n  \"size\": \"1024x1024\",\n  \"response_format\": \"b64_json\",\n  \"output_format\": \"png\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://bettertoken.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\": \"gpt-image-2\",\n  \"prompt\": \"A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.\",\n  \"n\": 1,\n  \"size\": \"1024x1024\",\n  \"response_format\": \"b64_json\",\n  \"output_format\": \"png\"\n}"

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

POST

images

generations

cURL

curl 'https://bettertoken.ai/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json",
    "output_format": "png"
  }'

import requests

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

payload = {
    "model": "gpt-image-2",
    "prompt": "A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json",
    "output_format": "png"
}
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: 'gpt-image-2',
    prompt: 'A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.',
    n: 1,
    size: '1024x1024',
    response_format: 'b64_json',
    output_format: 'png'
  })
};

fetch('https://bettertoken.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://bettertoken.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' => 'gpt-image-2',
    'prompt' => 'A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.',
    'n' => 1,
    'size' => '1024x1024',
    'response_format' => 'b64_json',
    'output_format' => 'png'
  ]),
  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://bettertoken.ai/v1/images/generations"

	payload := strings.NewReader("{\n  \"model\": \"gpt-image-2\",\n  \"prompt\": \"A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.\",\n  \"n\": 1,\n  \"size\": \"1024x1024\",\n  \"response_format\": \"b64_json\",\n  \"output_format\": \"png\"\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://bettertoken.ai/v1/images/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"gpt-image-2\",\n  \"prompt\": \"A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.\",\n  \"n\": 1,\n  \"size\": \"1024x1024\",\n  \"response_format\": \"b64_json\",\n  \"output_format\": \"png\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://bettertoken.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\": \"gpt-image-2\",\n  \"prompt\": \"A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic.\",\n  \"n\": 1,\n  \"size\": \"1024x1024\",\n  \"response_format\": \"b64_json\",\n  \"output_format\": \"png\"\n}"

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

POST /v1/images/generations The text-to-image endpoint uses an application/json request body. Submit a prompt, keep the HTTP request open, and read the generated image from data[0].b64_json in the same response.

Use https://bettertoken.ai/v1 as the Base URL. Pass your BetterToken API Key through Authorization: Bearer YOUR_API_KEY.

You can enter Authorization and the request body in the Playground on the right side of the page, then send the request directly to https://bettertoken.ai/v1/images/generations.

Do not put API keys in frontend browser code, Git repositories, tickets, screenshots, or logs. For server-side proxy calls, store API keys only in server environment variables or a secret manager.

Choose the right workflow

Generate an image from text and save the result: stay on this page. Start with the curl example, then use Save the image to decode data[0].b64_json.
Edit an existing image: use Image to image, which sends one or more source files as multipart/form-data.
Choose a model, review parameters, and estimate budget: check current Model IDs and prices in the model plaza, then use Recommended values below for request parameters. The GPT Image 2 first-request article provides the broader request-and-response context.

Quick start with curl

Use https://bettertoken.ai/v1 as the Base URL and send a request to https://bettertoken.ai/v1/images/generations:

curl -X POST "https://bettertoken.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A product photo of a green ceramic mug on a studio table",
    "size": "1024x1024",
    "n": 1,
    "response_format": "b64_json",
    "output_format": "png"
  }'

Recommended values

Send these fields explicitly in every request:

{
  "model": "gpt-image-2",
  "n": 1,
  "response_format": "b64_json",
  "output_format": "png"
}

Parameter	What to send	Purpose
`model`	`gpt-image-2`	Selects the image model.
`prompt`	A text description	Required image description. Include the subject, style, composition, and important constraints.
`size`	For example, `1024x1024`	Selects the output size and aspect ratio.
`n`	`1`	Image count for one request. Send separate requests for multiple images.
`response_format`	`b64_json`	Returns image content as base64 in `data[0].b64_json`.
`output_format`	`png`	Lets you save the result as PNG.

Generate multiple images by sending multiple independent requests. Do not rely on a single request with n > 1.

Recommended sizes

`size`	Ratio	Use case
`auto`	Auto	Automatic size selection
`1024x1024`	`1:1`	Square images, avatars, covers, assets
`1536x1024`	`3:2`	Landscape posters, banners, scenes
`1024x1536`	`2:3`	Portrait mobile covers and posters
`1536x1152`	`4:3`	Standard landscape images, product images, content graphics
`1152x1536`	`3:4`	Standard portrait images, mobile covers, vertical posters
`2048x2048`	`1:1`	High-resolution square images
`2048x1152`	`16:9`	High-resolution landscape images
`3840x2160`	`16:9`	4K landscape images
`2160x3840`	`9:16`	4K portrait images

size represents the expected aspect ratio and size tier. The actual returned pixels may be mapped or adjusted by the server. Use the decoded image dimensions instead of forcibly cropping the output to the requested value.

Save the image

A successful response follows the OpenAI-compatible image response shape:

{
  "created": 1710000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...(truncated)"
    }
  ]
}

Read data[0].b64_json and save it as base64 image content. The response may include extra fields such as revised_prompt; allow these fields in your client. Always set output_format: "png". Then save the decoded image as .png without inspecting file headers.

import base64
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8"))
b64_json = response["data"][0]["b64_json"]

if "," in b64_json and "base64" in b64_json.split(",", 1)[0]:
    b64_json = b64_json.split(",", 1)[1]

image_bytes = base64.b64decode(b64_json)
Path("output.png").write_bytes(image_bytes)

JavaScript example (Node.js)

import { writeFile } from "node:fs/promises";

const response = await fetch("https://bettertoken.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 green ceramic mug on a studio table",
    size: "1024x1024",
    n: 1,
    response_format: "b64_json",
    output_format: "png",
  }),
});

if (!response.ok) {
  throw new Error(await response.text());
}

const { data } = await response.json();
const b64Json = data[0].b64_json.replace(/^data:.*;base64,/, "");
await writeFile("output.png", Buffer.from(b64Json, "base64"));

Do not rely on output_format: "jpeg" or output_format: "webp" to directly receive JPEG or WebP files. The current endpoint may still return PNG image content. If your product needs JPEG or WebP, receive PNG first and convert it in your own code.

Response flow

This endpoint is synchronous. After sending POST /images/generations, keep the current HTTP request open until the server responds. When generation succeeds, the image content is returned in data[0].b64_json. The endpoint does not return a task_id, and there is no separate status query or result download endpoint.

Timeouts and retries

Set HTTP client timeouts to several minutes.
Retry transport errors, 408, 409, 425, 429, and 5xx.
Do not retry 400, 401, missing parameters, or malformed requests automatically.
Use exponential backoff such as 3s, 8s, and 15s.
If duplicate images are unacceptable, record your own request ID before retrying.

Error handling

Errors usually return JSON. When showing an error, read error.message first, then message, then the HTTP status text.

HTTP status	Meaning	What to do
`400`	Malformed JSON, a missing parameter, or an unsupported size	Check the request body. Do not retry automatically.
`401`	API Key is missing or invalid	Check the `Authorization: Bearer YOUR_API_KEY` header.
`402`	Insufficient balance or quota	Add balance or use an available key.
`429`	Rate limit, concurrency limit, or busy upstream	Wait and retry with exponential backoff.
`5xx`	Gateway or upstream failure	Retry the request. If it still fails, record the request ID and error message.

Integration checklist

The Base URL is https://bettertoken.ai/v1.
The header contains Authorization: Bearer YOUR_API_KEY.
The request uses application/json and POST /images/generations.
model is gpt-image-2, response_format is b64_json, output_format is png, and n is 1.
size is one of the recommended values, such as 1024x1024.
Your HTTP client allows several minutes for generation.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

model

enum<string>

default:gpt-image-2

required

Use the GPT Image 2 model ID.

Available options:

gpt-image-2

Example:

"gpt-image-2"

prompt

string

required

A detailed description of the image to generate.

Example:

"A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic."

default:1

Use 1. Send separate requests when you need multiple output images.

Example:

1

size

enum<string>

default:1024x1024

The requested image size or aspect-ratio tier. The server may map or adjust the final pixel dimensions, so inspect the decoded image for its actual size.

Available options:

auto,

1024x1024,

1536x1024,

1024x1536,

1536x1152,

1152x1536,

2048x2048,

2048x1152,

3840x2160,

2160x3840

Example:

"1024x1024"

response_format

enum<string>

default:b64_json

Use b64_json.

Available options:

b64_json

Example:

"b64_json"

output_format

enum<string>

default:png

Use png. Do not rely on jpeg or webp being returned directly in the selected format.

Available options:

png

Example:

"png"

Response

Image generation result.

​Choose the right workflow

​Quick start with curl

​Recommended values

​Recommended sizes

​Save the image

​JavaScript example (Node.js)

​Response flow

​Timeouts and retries

​Error handling

​Integration checklist

​Related docs

Authorizations

Body

Response

Choose the right workflow

Quick start with curl

Recommended values

Recommended sizes

Save the image

JavaScript example (Node.js)

Response flow

Timeouts and retries

Error handling

Integration checklist

Related docs