Vai al contenuto principale
POST
/
v1
/
images
/
generations
Create images
curl --request POST \
  --url https://api.cometapi.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "dall-e-3",
  "prompt": "A paper boat floating on calm water at sunrise."
}
'
{
  "created": 1773311889,
  "data": [
    {
      "revised_prompt": "A paper boat floating on calm water at sunrise, with soft golden light reflecting off the water's surface.",
      "url": "https://filesystem.site/cdn/20260312/1d6826050921c07a13ff173310c640.webp"
    }
  ]
}
Usa questa route per creare immagini da testo con formati di richiesta compatibili con OpenAI su CometAPI.

​
Scegli prima un model

  • Usa dall-e-3 quando vuoi un semplice smoke test basato su URL
  • Usa gpt-image-1, gpt-image-1-mini o gpt-image-1.5 quando vuoi modelli di immagini GPT più recenti e puoi gestire risposte in base64
  • Usa qwen-image quando ti serve specificamente quel provider, ma mantieni n a 1

​
Prima richiesta sicura

  • Inizia con dall-e-3
  • Mantieni size su 1024x1024
  • Imposta response_format: "url" se vuoi una risposta JSON piccola e un URL di download temporaneo
  • Usa un prompt e un’immagine prima di aggiungere la generazione batch o la regolazione dello stile

​
Comportamento della risposta specifico per model

  • dall-e-2 e dall-e-3 supportano risposte URL e risposte base64
  • gpt-image-1, gpt-image-1-mini e gpt-image-1.5 è meglio considerarli come route orientate prima di tutto al base64
  • qwen-image non supporta n > 1
Durante la validazione live del 2026-03-12, una richiesta dall-e-3 con response_format: "url" ha restituito un normale timestamp created, un revised_prompt e un URL immagine temporaneo.
Le immagini generate devono essere conformi alle policy di utilizzo del provider. Non inviare prompt illegali, violenti, pornografici o che violano il copyright.

Autorizzazioni

​
Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
​
model
string
predefinito:dall-e-3
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."

​
n
integer
predefinito:1

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

​
size
string

Requested output size. Supported values depend on the selected model.

Esempio:

"1024x1024"

​
response_format
enum<string>

Requested output encoding for models that support it.

Opzioni disponibili:
url,
b64_json

Risposta

200 - application/json

Image generation result.

​
created
integer
obbligatorio

Unix timestamp for the completed generation.

​
data
object[]
obbligatorio