Crea un'immagine

POST

images

generations

curl https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A paper boat floating on calm water at sunrise.",
    "quality": "low",
    "size": "1024x1024",
    "output_format": "jpeg"
  }'

{
  "created": 1781075000,
  "background": "opaque",
  "output_format": "jpeg",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 13,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 13
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 209
  },
  "data": [
    {
      "b64_json": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
    }
  ]
}

Usa questa route per creare immagini dal testo con formati di richiesta compatibili con OpenAI su CometAPI.

Riferimento ufficiale

Leggi la guida di OpenAI alla generazione di immagini prima di fare affidamento su controlli specifici del modello come background, output_compression, streaming o future opzioni per immagini GPT.
Usa il riferimento OpenAI Create image per l’elenco corrente dei parametri.

Scegli prima un modello

Usa un modello di immagini GPT come gpt-image-2 per richieste text-to-image con controlli quali output_format, quality o background
Usa gpt-image-2.5-sunburst o gpt-image-2.5-flare quando ti servono sfondi trasparenti o i livelli di qualità xhigh e max
Usa qwen-image quando ti serve specificamente quel provider, ma mantieni n a 1
Scegli un ID modello di immagini corrente dalla pagina Models

Prima richiesta sicura

Inizia con gpt-image-2
Mantieni size su 1024x1024
I modelli di immagini GPT restituiscono dati immagine codificati in base64 in b64_json; decodificali per salvare il file immagine
Aggiungi output_format solo quando ti serve un tipo di immagine codificata specifico, come jpeg
Usa un solo Prompt e una sola immagine di output prima di aggiungere la generazione in batch o la regolazione dello stile

Esegui un’attività immagine asincrona

Usa async: true per processi di immagini di lunga durata quando il client preferisce un flusso di invio e polling anziché mantenere aperta una connessione HTTP. La richiesta di creazione restituisce data.task_id. Esegui il polling di Recupera un’attività di generazione di immagini finché data.status non è success o failure. Il campo async è un’estensione CometAPI per questa route, non un parametro OpenAI. OpenAI documenta stream e partial_images per i modelli di immagini GPT. La modalità di attività asincrona di CometAPI restituisce metadati dell’attività in JSON e usa il polling. Usa la modalità di attività asincrona con questi ID modello documentati: gpt-image-2 e doubao-seedream-4-0-250828. Per altri modelli di immagini, usa la generazione sincrona o lo streaming, a meno che il supporto per le attività asincrone non sia documentato per quel modello. Quando una richiesta include sia async: true sia stream: true, la modalità di attività asincrona ha la precedenza. La richiesta di creazione restituisce metadati dell’attività JSON anziché un flusso SSE.

Comportamento delle richieste specifico del modello

response_format si applica solo ai modelli DALL·E; i modelli di immagini GPT restituiscono dati base64 e lo ignorano
I modelli di immagini GPT usano i controlli GPT-only quali output_format, quality, background e output_compression
quality accetta low, medium, high e auto sui modelli di immagini GPT; anche gpt-image-2.5-sunburst e gpt-image-2.5-flare accettano xhigh e max
output_compression si applica quando output_format è webp o jpeg; non ha effetto su png
partial_images si applica solo quando stream è true
Segui la guida di OpenAI alla generazione di immagini per le opzioni specifiche del modello più recenti
qwen-image non supporta n > 1

Generare uno sfondo trasparente

Imposta background su transparent per generare un soggetto isolato senza riempimento dello sfondo. Questa opzione è supportata su gpt-image-2.5-sunburst e gpt-image-2.5-flare. La trasparenza richiede un formato di output con un canale alfa. Imposta output_format su png o webp. JPEG non dispone di un canale alfa, pertanto una richiesta di trasparenza con output_format: "jpeg" viene rifiutata. La risposta restituisce dati dell’immagine in base64 in b64_json con un canale alfa. Decodificali per salvare il file:

import base64
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cometapi.com/v1",
    api_key=os.environ["COMETAPI_KEY"],
)

result = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="A single red apple, centered, isolated subject.",
    quality="low",
    size="1024x1024",
    background="transparent",
    output_format="png",
)

with open("apple.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

Imposta background su opaque per forzare uno sfondo uniforme, oppure su auto per lasciare decidere al modello. La risposta riporta il valore applicato nel campo background di primo livello.

Le immagini generate devono rispettare le policy di utilizzo del provider. Non inviare prompt illegali, violenti, pornografici o che violino il copyright.

Autorizzazioni

Authorization

string

header

obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json

model

string

predefinito:gpt-image-2

obbligatorio

The image generation model to use. Choose a current model from the Models page.

prompt

string

obbligatorio

Text description of the image you want to generate.

Esempio:

"A paper boat floating on calm water at sunrise."

integer

predefinito:1

Number of images to generate. Keep this at 1 for the broadest compatibility.

quality

string

Quality setting for models that support it. GPT image models accept low, medium, high, and auto. gpt-image-2.5-sunburst and gpt-image-2.5-flare also accept xhigh and max. dall-e-3 accepts standard and hd. See the OpenAI image generation guide for the latest model-specific values.

Esempio:

"low"

background

enum<string>

Background mode for the generated image. Set transparent to generate an isolated subject with no background fill; this requires output_format set to png or webp, and returns an error with jpeg. Set opaque for a solid background, or auto to let the model decide. Supported on gpt-image-2.5-sunburst and gpt-image-2.5-flare.

Opzioni disponibili:

transparent,

opaque,

auto

output_compression

integer

predefinito:100

Compression level for the output image, from 0 to 100. Applies when output_format is webp or jpeg. Lower values produce smaller files with more compression artifacts.

Intervallo richiesto: 0 <= x <= 100

moderation

enum<string>

predefinito:auto

Content moderation level for GPT image models. low is less restrictive; auto is the default.

Opzioni disponibili:

low,

auto

partial_images

integer

Number of partial images to emit while a streaming response is in progress, from 0 to 3. Each partial image arrives as an image_generation.partial_image event before the final image_generation.completed event. Applies when stream is true.

Intervallo richiesto: 0 <= x <= 3

size

string

Requested output size. Supported values depend on the selected model. See the OpenAI image generation guide for the latest model-specific ranges.

Esempio:

"1024x1024"

response_format

enum<string>

The response container for dall-e-2 and dall-e-3. This parameter is not supported for GPT image models, which return base64-encoded image data.

Opzioni disponibili:

url,

b64_json

output_format

string

The encoded image type for GPT image model results, such as png, jpeg, or webp. See the OpenAI image generation guide for current GPT image output controls.

Esempio:

"jpeg"

stream

boolean

predefinito:false

Set this to true to receive server-sent image generation events instead of waiting for the completed JSON response. Streaming responses use text/event-stream and can include final events such as image_generation.completed. When stream and async are both true, async task mode takes precedence and the create request returns JSON instead of a streaming image response.

async

boolean

predefinito:false

CometAPI asynchronous task mode. Set this to true to return immediately with data.task_id, then poll GET /v1/images/generations/{task_id} for the final image data. Documented model IDs for this mode: gpt-image-2 and doubao-seedream-4-0-250828. This is a CometAPI extension, not an OpenAI parameter. When async and stream are both true, async takes precedence and returns JSON task metadata instead of an SSE stream.

Risposta

Image generation result. Synchronous requests return completed image data. Async requests return a task response with data.task_id.

Completed image response
Async task response

created

integer

obbligatorio

Unix timestamp for the completed generation.

data

object[]

obbligatorio

Show child attributes

background

string

Background mode returned by models that expose it.

output_format

string

Encoded image type returned by GPT image models.

quality

string

Quality level returned by models that expose it.

size

string

Output size returned by models that expose it.

usage

object

Token usage details when returned by the selected model.

Show child attributes

Ultima modifica il 11 settembre 2026

curl https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A paper boat floating on calm water at sunrise.",
    "quality": "low",
    "size": "1024x1024",
    "output_format": "jpeg"
  }'

{
  "created": 1781075000,
  "background": "opaque",
  "output_format": "jpeg",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 13,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 13
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 209
  },
  "data": [
    {
      "b64_json": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
    }
  ]
}

Moderazione dei contenuti

Chiavi API

Riferimento ufficiale

Scegli prima un modello

Prima richiesta sicura

Esegui un’attività immagine asincrona

Comportamento delle richieste specifico del modello

Generare uno sfondo trasparente

Autorizzazioni

Corpo

Risposta

​Riferimento ufficiale

​Scegli prima un modello

​Prima richiesta sicura

​Esegui un’attività immagine asincrona

​Comportamento delle richieste specifico del modello

​Generare uno sfondo trasparente

Autorizzazioni

Corpo

Risposta

Riferimento ufficiale

Scegli prima un modello

Prima richiesta sicura

Esegui un’attività immagine asincrona

Comportamento delle richieste specifico del modello

Generare uno sfondo trasparente