توليد الصور (واجهة متوافقة مع OpenAI)

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

التفويضات

BearerAuthsiwx

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

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

الخيارات المتاحة: 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

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

الخيارات المتاحة: low, auto

مثال:

"auto"

n · 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 not used in Venice image generation but is supported for compatibility with OpenAI API

مثال:

"user123"

الاستجابة

200

application/json

Successfully generated image

created · integer · مطلوب

Unix timestamp for when the request was created

مثال:

1713833628

data · object[] · مطلوب

Option 1

Option 2

Show child attributes