Bilder

Bilder generieren (OpenAI-kompatible 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 --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",
  "anon_user_id": "end-user-123"
}
'

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",
    "anon_user_id": "end-user-123"
}
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',
    anon_user_id: 'end-user-123'
  })
};

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',
    'anon_user_id' => 'end-user-123'
  ]),
  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  \"anon_user_id\": \"end-user-123\"\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  \"anon_user_id\": \"end-user-123\"\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  \"anon_user_id\": \"end-user-123\"\n}"

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

{
  "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>"
}

Autorisierungen

Authorization

string

header

erforderlich

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

Header

Accept-Encoding

string

Supported compression encodings (gzip, br).

Beispiel:

"gzip, br"

Body

application/json

prompt

string

erforderlich

A text description of the desired image.

Required string length: 1 - 1500

Beispiel:

"A beautiful sunset over mountain ranges"

background

enum<string> | null

Standard:auto

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

Verfügbare Optionen:

transparent,

opaque,

auto

Beispiel:

"auto"

model

string

Standard: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.

Beispiel:

"grok-imagine-image"

moderation

enum<string> | null

Standard:auto

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

Verfügbare Optionen:

low,

auto

Beispiel:

"auto"

integer | null

Standard:1

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

Erforderlicher Bereich: 1 <= x <= 1

Beispiel:

1

output_compression

integer | null

Standard:100

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

Erforderlicher Bereich: 0 <= x <= 100

output_format

enum<string>

Standard:png

Output format for generated images

Verfügbare Optionen:

jpeg,

png,

webp

Beispiel:

"png"

quality

enum<string> | null

Standard:auto

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

Verfügbare Optionen:

auto,

high,

medium,

low,

hd,

standard

Beispiel:

"auto"

response_format

enum<string> | null

Standard:b64_json

Response format. URL will be a data URL.

Verfügbare Optionen:

b64_json,

url

Beispiel:

"b64_json"

size

enum<string> | null

Standard:auto

Size of generated images. Default is 1024x1024

Verfügbare Optionen:

auto,

256x256,

512x512,

1024x1024,

1536x1024,

1024x1536,

1792x1024,

1024x1792

Beispiel:

"1024x1024"

style

enum<string> | null

Standard:natural

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

Verfügbare Optionen:

vivid,

natural

Beispiel:

"natural"

user

string

This parameter is discarded and is supported for compatibility with OpenAI API. It is not an alias of anon_user_id.

Beispiel:

"user123"

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]+$

Beispiel:

"end-user-123"

Antwort

Successfully generated image

created

integer

erforderlich

Unix timestamp for when the request was created

Beispiel:

1713833628

data

object[]

erforderlich

Option 1
Option 2

Show child attributes

⌘I

/api/v1/image/generations

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",
  "anon_user_id": "end-user-123"
}
'

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",
    "anon_user_id": "end-user-123"
}
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',
    anon_user_id: 'end-user-123'
  })
};

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',
    'anon_user_id' => 'end-user-123'
  ]),
  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  \"anon_user_id\": \"end-user-123\"\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  \"anon_user_id\": \"end-user-123\"\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  \"anon_user_id\": \"end-user-123\"\n}"

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

{
  "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>"
}