Generate Images (OpenAI Compatible API)

Generate an image based on input parameters using an OpenAI compatible endpoint. This endpoint does not support the full feature set of the Venice Image Generation endpoint, but is compatible with the existing OpenAI endpoint.

Authentication: This endpoint accepts either a Bearer API key or a SIGN-IN-WITH-X header for x402 wallet-based authentication. The legacy X-Sign-In-With-X header is also accepted during migration. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.

POST /images/generations

/api/v1/image/generations

cURL

curl --request POST \
  --url https://api.venice.ai/api/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A beautiful sunset over mountain ranges",
  "background": "auto",
  "model": "grok-imagine-image",
  "moderation": "auto",
  "n": 1,
  "output_compression": 100,
  "output_format": "png",
  "quality": "auto",
  "response_format": "b64_json",
  "size": "1024x1024",
  "style": "natural",
  "user": "user123"
}
'

import requests

url = "https://api.venice.ai/api/v1/images/generations"

payload = {
    "prompt": "A beautiful sunset over mountain ranges",
    "background": "auto",
    "model": "grok-imagine-image",
    "moderation": "auto",
    "n": 1,
    "output_compression": 100,
    "output_format": "png",
    "quality": "auto",
    "response_format": "b64_json",
    "size": "1024x1024",
    "style": "natural",
    "user": "user123"
}
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({
    prompt: 'A beautiful sunset over mountain ranges',
    background: 'auto',
    model: 'grok-imagine-image',
    moderation: 'auto',
    n: 1,
    output_compression: 100,
    output_format: 'png',
    quality: 'auto',
    response_format: 'b64_json',
    size: '1024x1024',
    style: 'natural',
    user: 'user123'
  })
};

fetch('https://api.venice.ai/api/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://api.venice.ai/api/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([
    'prompt' => 'A beautiful sunset over mountain ranges',
    'background' => 'auto',
    'model' => 'grok-imagine-image',
    'moderation' => 'auto',
    'n' => 1,
    'output_compression' => 100,
    'output_format' => 'png',
    'quality' => 'auto',
    'response_format' => 'b64_json',
    'size' => '1024x1024',
    'style' => 'natural',
    'user' => 'user123'
  ]),
  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://api.venice.ai/api/v1/images/generations"

	payload := strings.NewReader("{\n  \"prompt\": \"A beautiful sunset over mountain ranges\",\n  \"background\": \"auto\",\n  \"model\": \"grok-imagine-image\",\n  \"moderation\": \"auto\",\n  \"n\": 1,\n  \"output_compression\": 100,\n  \"output_format\": \"png\",\n  \"quality\": \"auto\",\n  \"response_format\": \"b64_json\",\n  \"size\": \"1024x1024\",\n  \"style\": \"natural\",\n  \"user\": \"user123\"\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://api.venice.ai/api/v1/images/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A beautiful sunset over mountain ranges\",\n  \"background\": \"auto\",\n  \"model\": \"grok-imagine-image\",\n  \"moderation\": \"auto\",\n  \"n\": 1,\n  \"output_compression\": 100,\n  \"output_format\": \"png\",\n  \"quality\": \"auto\",\n  \"response_format\": \"b64_json\",\n  \"size\": \"1024x1024\",\n  \"style\": \"natural\",\n  \"user\": \"user123\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.venice.ai/api/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  \"prompt\": \"A beautiful sunset over mountain ranges\",\n  \"background\": \"auto\",\n  \"model\": \"grok-imagine-image\",\n  \"moderation\": \"auto\",\n  \"n\": 1,\n  \"output_compression\": 100,\n  \"output_format\": \"png\",\n  \"quality\": \"auto\",\n  \"response_format\": \"b64_json\",\n  \"size\": \"1024x1024\",\n  \"style\": \"natural\",\n  \"user\": \"user123\"\n}"

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

200

{
  "created": 1713833628,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

{
  "error": "<string>",
  "details": {
    "_errors": [],
    "field": {
      "_errors": [
        "Field is required"
      ]
    }
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Authorizations

BearerAuthsiwx

Authorization · string · header · required

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

Headers

Accept-Encoding · string

Supported compression encodings (gzip, br).

Example:

"gzip, br"

Body

application/json

prompt · string · required

A text description of the desired image.

Required string length: 1 - 1500

Example:

"A beautiful sunset over mountain ranges"

background · enum<string> | null · default: auto

This parameter is not used in Venice image generation but is supported for compatibility with OpenAI API

Available options: transparent, opaque, auto

Example:

"auto"

model · string · default: default

The model to use for image generation. Defaults to Venice's default image model. If a non-existent model is specified (ie an OpenAI model name), it will default to Venice's default image model.

Example:

"grok-imagine-image"

moderation · enum<string> | null · default: auto

auto enables safe venice mode which will blur out adult content. low disables safe venice mode.

Available options: low, auto

Example:

"auto"

n · integer | null · default: 1

Number of images to generate. Venice presently only supports 1 image per request.

Required range: 1 <= x <= 1

Example:

1

output_compression · integer | null · default: 100

This parameter is not used in Venice image generation but is supported for compatibility with OpenAI API

Required range: 0 <= x <= 100

output_format · enum<string> · default: png

Output format for generated images

Available options: jpeg, png, webp

Example:

"png"

quality · enum<string> | null · default: auto

This parameter is not used in Venice image generation but is supported for compatibility with OpenAI API

Available options: auto, high, medium, low, hd, standard

Example:

"auto"

response_format · enum<string> | null · default: b64_json

Response format. URL will be a data URL.

Available options: b64_json, url

Example:

"b64_json"

size · enum<string> | null · default: auto

Size of generated images. Default is 1024x1024

Available options: auto, 256x256, 512x512, 1024x1024, 1536x1024, 1024x1536, 1792x1024, 1024x1792

Example:

"1024x1024"

style · enum<string> | null · default: natural

This parameter is not used in Venice image generation but is supported for compatibility with OpenAI API

Available options: vivid, natural

Example:

"natural"

user · string

This parameter is not used in Venice image generation but is supported for compatibility with OpenAI API

Example:

"user123"

Response

200

application/json

Successfully generated image

created · integer · required

Unix timestamp for when the request was created

Example:

1713833628

data · object[] · required

Option 1

Option 2

Show child attributes