图像

生成图像（OpenAI 兼容 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": "This API key is restricted to configured IP addresses, and this request's source IP is not allowed"
}

{
  "error": "<string>"
}

{
  "error": "<string>",
  "suggested_prompt": "A watercolor painting of a lighthouse on a rocky coast at sunset.",
  "recommended_model": "chroma",
  "retryable": true
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

授权

Authorization

string

header

必填

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

请求头

Accept-Encoding

string

Supported compression encodings (gzip, br).

示例:

"gzip, br"

请求体

application/json

prompt

string

必填

A text description of the desired image.

Required string length: 1 - 1500

示例:

"A beautiful sunset over mountain ranges"

background

enum<string> | null

默认值:auto

Set to transparent to return the image with a transparent background (alpha channel). transparent is only supported by models with supportsTransparentBackground: true in their constraints (see GET /api/v1/models) and with output_format png or webp; otherwise the request is rejected. If the model does not exist, the default image model is used. auto, opaque and null keep the model default background.

可用选项:

transparent,

opaque,

auto

示例:

"auto"

model

string

默认值: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.

示例:

"grok-imagine-image"

moderation

enum<string> | null

默认值:auto

Controls blurring of images classified as adult content. auto (the default, also used when null) blurs them; low returns unblurred output. This is the OpenAI-compatible equivalent of safe_mode on /image/generate. No Pro subscription is required, and the mature filter setting in the Venice app does not affect this. The x-venice-is-blurred response header reports whether the returned image was blurred.

可用选项:

low,

auto

示例:

"auto"

integer | null

默认值:1

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

必填范围: 1 <= x <= 1

示例:

1

output_compression

integer | null

默认值:100

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

必填范围: 0 <= x <= 100

output_format

enum<string>

默认值:png

Output format for generated images

可用选项:

jpeg,

png,

webp

示例:

"png"

quality

enum<string> | null

默认值:auto

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

可用选项:

auto,

high,

medium,

low,

hd,

standard

示例:

"auto"

response_format

enum<string> | null

默认值:b64_json

Response format. URL will be a data URL.

可用选项:

b64_json,

url

示例:

"b64_json"

size

enum<string> | null

默认值:auto

Size of generated images. Default is 1024x1024

可用选项:

auto,

256x256,

512x512,

1024x1024,

1536x1024,

1024x1536,

1792x1024,

1024x1792

示例:

"1024x1024"

style

enum<string> | null

默认值:natural

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

可用选项:

vivid,

natural

示例:

"natural"

user

string

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

示例:

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

示例:

"end-user-123"

响应

Successfully generated image

created

integer

必填

Unix timestamp for when the request was created

示例:

1713833628

data

object[]

必填

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": "This API key is restricted to configured IP addresses, and this request's source IP is not allowed"
}

{
  "error": "<string>"
}

{
  "error": "<string>",
  "suggested_prompt": "A watercolor painting of a lighthouse on a rocky coast at sunset.",
  "recommended_model": "chroma",
  "retryable": true
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}