Перейти до основного вмісту
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"
    }
  ]
}
Використовуйте цей маршрут, щоб створювати зображення з тексту за допомогою сумісних з OpenAI форматів запиту в CometAPI.

​
Спочатку виберіть модель

  • Використовуйте dall-e-3, якщо вам потрібен простий smoke test на основі URL
  • Використовуйте gpt-image-1, gpt-image-1-mini або gpt-image-1.5, якщо вам потрібні новіші GPT-моделі для зображень і ви можете працювати з base64-відповідями
  • Використовуйте qwen-image, якщо вам потрібен саме цей провайдер, але залишайте n рівним 1

​
Безпечний перший запит

  • Почніть із dall-e-3
  • Залишайте size значенням 1024x1024
  • Установіть response_format: "url", якщо вам потрібна невелика JSON-відповідь і тимчасовий URL для завантаження
  • Використовуйте один prompt і одне зображення, перш ніж додавати пакетну генерацію або налаштування стилю

​
Поведінка відповіді залежно від моделі

  • dall-e-2 і dall-e-3 підтримують відповіді у форматі URL і base64
  • gpt-image-1, gpt-image-1-mini і gpt-image-1.5 краще розглядати як маршрути з пріоритетом base64
  • qwen-image не підтримує n > 1
Під час живої валідації 2026-03-12 запит dall-e-3 з response_format: "url" повернув звичайну часову мітку created, revised_prompt і тимчасовий URL зображення.
Згенеровані зображення мають відповідати політикам використання провайдера. Не надсилайте незаконні, насильницькі, порнографічні або такі, що порушують авторські права, prompts.

Авторизації

​
Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Тіло

application/json
​
model
string
за замовчуванням:dall-e-3
обов'язково

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

​
prompt
string
обов'язково

Text description of the image you want to generate.

Приклад:

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

​
n
integer
за замовчуванням: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.

Приклад:

"1024x1024"

​
response_format
enum<string>

Requested output encoding for models that support it.

Доступні опції:
url,
b64_json

Відповідь

200 - application/json

Image generation result.

​
created
integer
обов'язково

Unix timestamp for the completed generation.

​
data
object[]
обов'язково