Image Generate | Venice API Docs

POST

image

generate

/api/v1/image/generate

curl --request POST \
  --url https://api.venice.ai/api/v1/image/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-image",
  "prompt": "A beautiful sunset over a mountain range",
  "anon_user_id": "end-user-123",
  "cfg_scale": 7.5,
  "embed_exif_metadata": false,
  "format": "webp",
  "height": 1024,
  "hide_watermark": false,
  "inpaint": "<unknown>",
  "lora_strength": 50,
  "negative_prompt": "Clouds, Rain, Snow",
  "return_binary": false,
  "variants": 3,
  "safe_mode": false,
  "seed": 123456789,
  "steps": 8,
  "style_preset": "3D Model",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "quality": "high",
  "enable_web_search": false,
  "disable_prompt_optimization_thinking": false,
  "enhance_prompt": false,
  "width": 1024,
  "style_references": [
    {
      "image": "https://example.com/style-reference.png",
      "strength": 0.5
    }
  ]
}
'

import requests

url = "https://api.venice.ai/api/v1/image/generate"

payload = {
    "model": "grok-imagine-image",
    "prompt": "A beautiful sunset over a mountain range",
    "anon_user_id": "end-user-123",
    "cfg_scale": 7.5,
    "embed_exif_metadata": False,
    "format": "webp",
    "height": 1024,
    "hide_watermark": False,
    "inpaint": "<unknown>",
    "lora_strength": 50,
    "negative_prompt": "Clouds, Rain, Snow",
    "return_binary": False,
    "variants": 3,
    "safe_mode": False,
    "seed": 123456789,
    "steps": 8,
    "style_preset": "3D Model",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "quality": "high",
    "enable_web_search": False,
    "disable_prompt_optimization_thinking": False,
    "enhance_prompt": False,
    "width": 1024,
    "style_references": [
        {
            "image": "https://example.com/style-reference.png",
            "strength": 0.5
        }
    ]
}
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: 'grok-imagine-image',
    prompt: 'A beautiful sunset over a mountain range',
    anon_user_id: 'end-user-123',
    cfg_scale: 7.5,
    embed_exif_metadata: false,
    format: 'webp',
    height: 1024,
    hide_watermark: false,
    inpaint: '<unknown>',
    lora_strength: 50,
    negative_prompt: 'Clouds, Rain, Snow',
    return_binary: false,
    variants: 3,
    safe_mode: false,
    seed: 123456789,
    steps: 8,
    style_preset: '3D Model',
    aspect_ratio: '1:1',
    resolution: '1K',
    quality: 'high',
    enable_web_search: false,
    disable_prompt_optimization_thinking: false,
    enhance_prompt: false,
    width: 1024,
    style_references: [{image: 'https://example.com/style-reference.png', strength: 0.5}]
  })
};

fetch('https://api.venice.ai/api/v1/image/generate', 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/image/generate",
  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' => 'grok-imagine-image',
    'prompt' => 'A beautiful sunset over a mountain range',
    'anon_user_id' => 'end-user-123',
    'cfg_scale' => 7.5,
    'embed_exif_metadata' => false,
    'format' => 'webp',
    'height' => 1024,
    'hide_watermark' => false,
    'inpaint' => '<unknown>',
    'lora_strength' => 50,
    'negative_prompt' => 'Clouds, Rain, Snow',
    'return_binary' => false,
    'variants' => 3,
    'safe_mode' => false,
    'seed' => 123456789,
    'steps' => 8,
    'style_preset' => '3D Model',
    'aspect_ratio' => '1:1',
    'resolution' => '1K',
    'quality' => 'high',
    'enable_web_search' => false,
    'disable_prompt_optimization_thinking' => false,
    'enhance_prompt' => false,
    'width' => 1024,
    'style_references' => [
        [
                'image' => 'https://example.com/style-reference.png',
                'strength' => 0.5
        ]
    ]
  ]),
  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/image/generate"

	payload := strings.NewReader("{\n  \"model\": \"grok-imagine-image\",\n  \"prompt\": \"A beautiful sunset over a mountain range\",\n  \"anon_user_id\": \"end-user-123\",\n  \"cfg_scale\": 7.5,\n  \"embed_exif_metadata\": false,\n  \"format\": \"webp\",\n  \"height\": 1024,\n  \"hide_watermark\": false,\n  \"inpaint\": \"<unknown>\",\n  \"lora_strength\": 50,\n  \"negative_prompt\": \"Clouds, Rain, Snow\",\n  \"return_binary\": false,\n  \"variants\": 3,\n  \"safe_mode\": false,\n  \"seed\": 123456789,\n  \"steps\": 8,\n  \"style_preset\": \"3D Model\",\n  \"aspect_ratio\": \"1:1\",\n  \"resolution\": \"1K\",\n  \"quality\": \"high\",\n  \"enable_web_search\": false,\n  \"disable_prompt_optimization_thinking\": false,\n  \"enhance_prompt\": false,\n  \"width\": 1024,\n  \"style_references\": [\n    {\n      \"image\": \"https://example.com/style-reference.png\",\n      \"strength\": 0.5\n    }\n  ]\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/image/generate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"grok-imagine-image\",\n  \"prompt\": \"A beautiful sunset over a mountain range\",\n  \"anon_user_id\": \"end-user-123\",\n  \"cfg_scale\": 7.5,\n  \"embed_exif_metadata\": false,\n  \"format\": \"webp\",\n  \"height\": 1024,\n  \"hide_watermark\": false,\n  \"inpaint\": \"<unknown>\",\n  \"lora_strength\": 50,\n  \"negative_prompt\": \"Clouds, Rain, Snow\",\n  \"return_binary\": false,\n  \"variants\": 3,\n  \"safe_mode\": false,\n  \"seed\": 123456789,\n  \"steps\": 8,\n  \"style_preset\": \"3D Model\",\n  \"aspect_ratio\": \"1:1\",\n  \"resolution\": \"1K\",\n  \"quality\": \"high\",\n  \"enable_web_search\": false,\n  \"disable_prompt_optimization_thinking\": false,\n  \"enhance_prompt\": false,\n  \"width\": 1024,\n  \"style_references\": [\n    {\n      \"image\": \"https://example.com/style-reference.png\",\n      \"strength\": 0.5\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.venice.ai/api/v1/image/generate")

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\": \"grok-imagine-image\",\n  \"prompt\": \"A beautiful sunset over a mountain range\",\n  \"anon_user_id\": \"end-user-123\",\n  \"cfg_scale\": 7.5,\n  \"embed_exif_metadata\": false,\n  \"format\": \"webp\",\n  \"height\": 1024,\n  \"hide_watermark\": false,\n  \"inpaint\": \"<unknown>\",\n  \"lora_strength\": 50,\n  \"negative_prompt\": \"Clouds, Rain, Snow\",\n  \"return_binary\": false,\n  \"variants\": 3,\n  \"safe_mode\": false,\n  \"seed\": 123456789,\n  \"steps\": 8,\n  \"style_preset\": \"3D Model\",\n  \"aspect_ratio\": \"1:1\",\n  \"resolution\": \"1K\",\n  \"quality\": \"high\",\n  \"enable_web_search\": false,\n  \"disable_prompt_optimization_thinking\": false,\n  \"enhance_prompt\": false,\n  \"width\": 1024,\n  \"style_references\": [\n    {\n      \"image\": \"https://example.com/style-reference.png\",\n      \"strength\": 0.5\n    }\n  ]\n}"

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

{
  "id": "generate-image-1234567890",
  "images": [
    "<string>"
  ],
  "timing": {
    "inferenceDuration": 123,
    "inferencePreprocessingTime": 123,
    "inferenceQueueTime": 123,
    "total": 123
  },
  "request": "<unknown>"
}

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

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "This API key is restricted to configured IP addresses, and this request's source IP is not allowed"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Sizing Options

Image models use model-specific sizing parameters:

Pixel-based models accept width and height, for example venice-sd35.
Aspect-ratio models accept aspect_ratio, for example qwen-image-2. The Qwen Image family — qwen-image, qwen-image-3, and qwen-image-3-pro — rejects width and height with a 400; use aspect_ratio for those.
Resolution-tier models accept both aspect_ratio and resolution.

For example, gpt-image-2, nano-banana-2, and nano-banana-pro support resolution values of 1K, 2K, and 4K:

{
  "model": "gpt-image-2",
  "prompt": "a cinematic wide shot of Venice at sunset",
  "aspect_ratio": "16:9",
  "resolution": "4K",
  "format": "png"
}

The same resolution-tier sizing pattern also applies to Nano Banana models:

{
  "model": "nano-banana-pro",
  "prompt": "a serene canal in venice at sunset",
  "aspect_ratio": "16:9",
  "resolution": "2K"
}

For models that accept aspect ratio but do not expose resolution tiers, send aspect_ratio without resolution:

{
  "model": "qwen-image-2",
  "prompt": "a serene canal in venice at sunset",
  "aspect_ratio": "16:9"
}

For models that use direct pixel dimensions, send width and height instead:

{
  "model": "venice-sd35",
  "prompt": "a serene canal in venice at sunset",
  "width": 1024,
  "height": 1024
}

Check Image Models or the Models endpoint for each model’s supported sizing options before mixing sizing fields across models.

Quality Tiers

Some models accept an optional quality parameter (low, medium, high) that trades visual fidelity for cost. Currently supported by gpt-image-2; other models ignore the parameter.

{
  "model": "gpt-image-2",
  "prompt": "a cinematic wide shot of Venice at sunset",
  "aspect_ratio": "16:9",
  "resolution": "2K",
  "quality": "medium"
}

When you omit quality, the model uses its default tier (high for gpt-image-2). Pricing depends on the combination of resolution and quality — the per-tier prices for gpt-image-2 (1K/2K/4K × low/medium/high) are exposed under model_spec.pricing.quality in the Models endpoint and listed in the Pricing overview.

Quality-aware pricing is the default for all API and SDK callers — no opt-in header required. Requests that omit quality are billed at the model’s default tier (high for gpt-image-2).

Postman Collection

For additional examples, please see this Postman Collection.

Authorizations

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). Only applied when return_binary is false.

Example:

"gzip, br"

Body

application/json

model

string

required

The model to use for image generation.

Example:

"grok-imagine-image"

prompt

string

required

The description for the image. Character limit is model specific and is listed in the promptCharacterLimit setting in the model list endpoint.

Required string length: 1 - 7500

Example:

"A beautiful sunset over a mountain range"

anon_user_id

string

Optional identifier for the API customer's end user. Combined with the Venice user id when attributing the request to upstream providers. Distinct from the discarded OpenAI user field. Must be printable ASCII and must not contain ||.

Required string length: 1 - 128

Pattern: ^[\x20-\x7E]+$

Example:

"end-user-123"

cfg_scale

number

CFG scale parameter. Higher values lead to more adherence to the prompt.

Required range: 0 < x <= 20

Example:

7.5

embed_exif_metadata

boolean

default:false

Embed prompt generation information into the image's EXIF metadata.

Example:

false

format

enum<string>

default:webp

The image format to return. WebP are smaller and optimized for web use. PNG are higher quality but larger in file size.

Available options:

jpeg,

png,

webp

Example:

"webp"

height

integer

default:1024

Height of the generated image.

Required range: 0 < x <= 1280

Example:

1024

hide_watermark

boolean

default:false

Whether to hide the Venice watermark. Venice may ignore this parameter for certain generated content.

Example:

false

inpaint

any | null

deprecated

This feature is deprecated and was disabled on May 19th, 2025. A revised in-painting API will be launched in the near future.

lora_strength

integer

Lora strength for the model. Only applies if the model uses additional Loras.

Required range: 0 <= x <= 100

Example:

50

negative_prompt

string

A description of what should not be in the image. Character limit is model specific and is listed in the promptCharacterLimit constraint in the model list endpoint.

Maximum string length: 7500

Example:

"Clouds, Rain, Snow"

return_binary

boolean

default:false

Whether to return binary image data instead of base64.

Example:

false

variants

integer

Number of images to generate (1–4). Only supported when return_binary is false.

Required range: 1 <= x <= 4

Example:

3

safe_mode

boolean

default:true

Whether to use safe mode. If enabled, this will blur images that are classified as having adult content.

Example:

false

seed

integer

default:0

Random seed for generation. If not provided, a random seed will be used.

Required range: -999999999 <= x <= 999999999

Example:

123456789

steps

integer

default:8

Number of inference steps. This model does not support steps - this field is ignored.

Example:

8

style_preset

string

An image style to apply to the image. Visit https://docs.venice.ai/api-reference/endpoint/image/styles for more details.

Example:

"3D Model"

aspect_ratio

string

Aspect ratio (utilized by certain image models including Nano Banana). Examples: "1:1", "16:9".

Example:

"1:1"

resolution

string

Resolution (utilized by certain image models including Nano Banana). Examples: "1K", "2K", "4K".

Example:

"1K"

quality

enum<string>

Output quality for supported models (e.g. GPT Image 2 / GPT Image 2 Edit). Higher values can increase the final request charge. See the model list for supported options.

Available options:

low,

medium,

high

Example:

"high"

enable_web_search

boolean

Enable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image. Only supported by certain models. If web search is used, additional credits are getting charged.

Example:

false

disable_prompt_optimization_thinking

boolean

Skip the model's prompt-optimization thinking step for faster generation. Only supported by models with supportsOptimizePromptThinking; ignored by others. Omit to use the model default.

Example:

false

enhance_prompt

boolean

Rewrite the prompt before generation to add clarifying visual detail. Additional credits are charged when a rewrite is generated. Adds up to ~30 seconds before generation starts. When enhancement is applied, the final prompt is returned URL-encoded in the x-venice-enhanced-prompt response header. Defaults to false.

Example:

false

width

integer

default:1024

Width of the generated image.

Required range: 0 < x <= 1280

Example:

1024

style_references

object[]

Style reference images that guide the aesthetic of the generated image. Only supported by models with supportsStyleReferences: true (see GET /api/v1/models for the per-model maxStyleReferences limit).

Show child attributes

Example:

[
  {
    "image": "https://example.com/style-reference.png",
    "strength": 0.5
  }
]

Response

Successfully generated image

string

required

The ID of the request.

Example:

"generate-image-1234567890"

images

string[]

required

Base64 encoded image data.

timing

object

required

Show child attributes

request

any | null

The original request data sent to the API.

⌘I

/api/v1/image/generate

curl --request POST \
  --url https://api.venice.ai/api/v1/image/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-image",
  "prompt": "A beautiful sunset over a mountain range",
  "anon_user_id": "end-user-123",
  "cfg_scale": 7.5,
  "embed_exif_metadata": false,
  "format": "webp",
  "height": 1024,
  "hide_watermark": false,
  "inpaint": "<unknown>",
  "lora_strength": 50,
  "negative_prompt": "Clouds, Rain, Snow",
  "return_binary": false,
  "variants": 3,
  "safe_mode": false,
  "seed": 123456789,
  "steps": 8,
  "style_preset": "3D Model",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "quality": "high",
  "enable_web_search": false,
  "disable_prompt_optimization_thinking": false,
  "enhance_prompt": false,
  "width": 1024,
  "style_references": [
    {
      "image": "https://example.com/style-reference.png",
      "strength": 0.5
    }
  ]
}
'

import requests

url = "https://api.venice.ai/api/v1/image/generate"

payload = {
    "model": "grok-imagine-image",
    "prompt": "A beautiful sunset over a mountain range",
    "anon_user_id": "end-user-123",
    "cfg_scale": 7.5,
    "embed_exif_metadata": False,
    "format": "webp",
    "height": 1024,
    "hide_watermark": False,
    "inpaint": "<unknown>",
    "lora_strength": 50,
    "negative_prompt": "Clouds, Rain, Snow",
    "return_binary": False,
    "variants": 3,
    "safe_mode": False,
    "seed": 123456789,
    "steps": 8,
    "style_preset": "3D Model",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "quality": "high",
    "enable_web_search": False,
    "disable_prompt_optimization_thinking": False,
    "enhance_prompt": False,
    "width": 1024,
    "style_references": [
        {
            "image": "https://example.com/style-reference.png",
            "strength": 0.5
        }
    ]
}
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: 'grok-imagine-image',
    prompt: 'A beautiful sunset over a mountain range',
    anon_user_id: 'end-user-123',
    cfg_scale: 7.5,
    embed_exif_metadata: false,
    format: 'webp',
    height: 1024,
    hide_watermark: false,
    inpaint: '<unknown>',
    lora_strength: 50,
    negative_prompt: 'Clouds, Rain, Snow',
    return_binary: false,
    variants: 3,
    safe_mode: false,
    seed: 123456789,
    steps: 8,
    style_preset: '3D Model',
    aspect_ratio: '1:1',
    resolution: '1K',
    quality: 'high',
    enable_web_search: false,
    disable_prompt_optimization_thinking: false,
    enhance_prompt: false,
    width: 1024,
    style_references: [{image: 'https://example.com/style-reference.png', strength: 0.5}]
  })
};

fetch('https://api.venice.ai/api/v1/image/generate', 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/image/generate",
  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' => 'grok-imagine-image',
    'prompt' => 'A beautiful sunset over a mountain range',
    'anon_user_id' => 'end-user-123',
    'cfg_scale' => 7.5,
    'embed_exif_metadata' => false,
    'format' => 'webp',
    'height' => 1024,
    'hide_watermark' => false,
    'inpaint' => '<unknown>',
    'lora_strength' => 50,
    'negative_prompt' => 'Clouds, Rain, Snow',
    'return_binary' => false,
    'variants' => 3,
    'safe_mode' => false,
    'seed' => 123456789,
    'steps' => 8,
    'style_preset' => '3D Model',
    'aspect_ratio' => '1:1',
    'resolution' => '1K',
    'quality' => 'high',
    'enable_web_search' => false,
    'disable_prompt_optimization_thinking' => false,
    'enhance_prompt' => false,
    'width' => 1024,
    'style_references' => [
        [
                'image' => 'https://example.com/style-reference.png',
                'strength' => 0.5
        ]
    ]
  ]),
  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/image/generate"

	payload := strings.NewReader("{\n  \"model\": \"grok-imagine-image\",\n  \"prompt\": \"A beautiful sunset over a mountain range\",\n  \"anon_user_id\": \"end-user-123\",\n  \"cfg_scale\": 7.5,\n  \"embed_exif_metadata\": false,\n  \"format\": \"webp\",\n  \"height\": 1024,\n  \"hide_watermark\": false,\n  \"inpaint\": \"<unknown>\",\n  \"lora_strength\": 50,\n  \"negative_prompt\": \"Clouds, Rain, Snow\",\n  \"return_binary\": false,\n  \"variants\": 3,\n  \"safe_mode\": false,\n  \"seed\": 123456789,\n  \"steps\": 8,\n  \"style_preset\": \"3D Model\",\n  \"aspect_ratio\": \"1:1\",\n  \"resolution\": \"1K\",\n  \"quality\": \"high\",\n  \"enable_web_search\": false,\n  \"disable_prompt_optimization_thinking\": false,\n  \"enhance_prompt\": false,\n  \"width\": 1024,\n  \"style_references\": [\n    {\n      \"image\": \"https://example.com/style-reference.png\",\n      \"strength\": 0.5\n    }\n  ]\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/image/generate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"grok-imagine-image\",\n  \"prompt\": \"A beautiful sunset over a mountain range\",\n  \"anon_user_id\": \"end-user-123\",\n  \"cfg_scale\": 7.5,\n  \"embed_exif_metadata\": false,\n  \"format\": \"webp\",\n  \"height\": 1024,\n  \"hide_watermark\": false,\n  \"inpaint\": \"<unknown>\",\n  \"lora_strength\": 50,\n  \"negative_prompt\": \"Clouds, Rain, Snow\",\n  \"return_binary\": false,\n  \"variants\": 3,\n  \"safe_mode\": false,\n  \"seed\": 123456789,\n  \"steps\": 8,\n  \"style_preset\": \"3D Model\",\n  \"aspect_ratio\": \"1:1\",\n  \"resolution\": \"1K\",\n  \"quality\": \"high\",\n  \"enable_web_search\": false,\n  \"disable_prompt_optimization_thinking\": false,\n  \"enhance_prompt\": false,\n  \"width\": 1024,\n  \"style_references\": [\n    {\n      \"image\": \"https://example.com/style-reference.png\",\n      \"strength\": 0.5\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.venice.ai/api/v1/image/generate")

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\": \"grok-imagine-image\",\n  \"prompt\": \"A beautiful sunset over a mountain range\",\n  \"anon_user_id\": \"end-user-123\",\n  \"cfg_scale\": 7.5,\n  \"embed_exif_metadata\": false,\n  \"format\": \"webp\",\n  \"height\": 1024,\n  \"hide_watermark\": false,\n  \"inpaint\": \"<unknown>\",\n  \"lora_strength\": 50,\n  \"negative_prompt\": \"Clouds, Rain, Snow\",\n  \"return_binary\": false,\n  \"variants\": 3,\n  \"safe_mode\": false,\n  \"seed\": 123456789,\n  \"steps\": 8,\n  \"style_preset\": \"3D Model\",\n  \"aspect_ratio\": \"1:1\",\n  \"resolution\": \"1K\",\n  \"quality\": \"high\",\n  \"enable_web_search\": false,\n  \"disable_prompt_optimization_thinking\": false,\n  \"enhance_prompt\": false,\n  \"width\": 1024,\n  \"style_references\": [\n    {\n      \"image\": \"https://example.com/style-reference.png\",\n      \"strength\": 0.5\n    }\n  ]\n}"

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

{
  "id": "generate-image-1234567890",
  "images": [
    "<string>"
  ],
  "timing": {
    "inferenceDuration": 123,
    "inferencePreprocessingTime": 123,
    "inferenceQueueTime": 123,
    "total": 123
  },
  "request": "<unknown>"
}

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

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "This API key is restricted to configured IP addresses, and this request's source IP is not allowed"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Venice APIs

Generate Images

Sizing Options

Quality Tiers

Postman Collection

Authorizations

Headers

Body

Response

​Sizing Options

​Quality Tiers

​Postman Collection

Authorizations

Headers

Body

Response

Sizing Options

Quality Tiers

Postman Collection