Створити зображення

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

Використовуйте цей маршрут, щоб створювати зображення з тексту за допомогою сумісних з OpenAI форматів запиту в CometAPI.

Офіційна довідка

Прочитайте посібник OpenAI з генерації зображень, перш ніж покладатися на специфічні для моделі налаштування, такі як background, output_compression, streaming або майбутні параметри GPT image
Використовуйте довідку OpenAI Create image reference для актуального списку параметрів.

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

Використовуйте модель GPT image, наприклад gpt-image-2, для запитів text-to-image з налаштуваннями на кшталт output_format, quality або background
Використовуйте qwen-image, якщо вам потрібен саме цей провайдер, але залишайте n рівним 1
Виберіть актуальний model ID на сторінці Models

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

Почніть із gpt-image-2
Залишайте size рівним 1024x1024
Моделі GPT image повертають дані зображення в кодуванні base64 у b64_json; декодуйте їх, щоб зберегти файл зображення
Додавайте output_format лише тоді, коли вам потрібен певний тип закодованого зображення, наприклад jpeg
Перевірте посібник OpenAI з генерації зображень, перш ніж додавати background, output_compression або streaming
Використовуйте один Prompt і одне вихідне зображення, перш ніж додавати пакетну генерацію або налаштування стилю

Запустити асинхронне завдання зображення

Використовуйте async: true для довготривалих завдань генерації зображень, коли ваш клієнт надає перевагу схемі submit-and-poll замість утримання одного HTTP-з’єднання відкритим. Запит на створення повертає data.task_id. Опитуйте Отримати завдання генерації зображення, доки data.status не стане success або failure. Поле async — це розширення CometAPI для цього маршруту, а не параметр OpenAI. OpenAI документує stream і partial_images для моделей GPT image. Асинхронний режим завдань CometAPI повертає JSON-метадані завдання та використовує polling. Використовуйте асинхронний режим завдань із такими задокументованими model ID: gpt-image-2 і doubao-seedream-4-0-250828. Для інших моделей зображень використовуйте синхронну генерацію або streaming, якщо тільки для цієї моделі не задокументовано підтримку асинхронних завдань. Коли запит містить одночасно async: true і stream: true, пріоритет має асинхронний режим завдань. Запит на створення повертає JSON-метадані завдання замість SSE-потоку.

Специфічна для моделі поведінка запиту

response_format застосовується лише до моделей DALL·E; моделі GPT image повертають дані base64 та ігнорують його
Моделі GPT image використовують лише GPT-специфічні налаштування, такі як output_format, quality, background і output_compression
Дотримуйтесь посібника OpenAI з генерації зображень щодо найновіших специфічних для моделі параметрів
qwen-image не підтримує n > 1

Згенеровані зображення мають відповідати політикам використання провайдера. Не надсилайте незаконні, насильницькі, порнографічні або такі, що порушують авторські права, Prompt.

Авторизації

Authorization

string

header

обов'язково

Bearer token authentication. Use your CometAPI key.

Тіло

application/json

model

string

за замовчуванням:gpt-image-2

обов'язково

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

integer

за замовчуванням:1

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

quality

string

Quality setting for models that support it. See the OpenAI image generation guide for the latest model-specific values.

size

string

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

Приклад:

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

Доступні опції:

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.

Приклад:

"jpeg"

stream

boolean

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

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

Відповідь

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

обов'язково

Unix timestamp for the completed generation.

data

object[]

обов'язково

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

API для генерації та редагування зображень

Попередня

Отримання завдання генерації зображення

Наступна

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

Модерація контенту

API-ключі

Офіційна довідка

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

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

Запустити асинхронне завдання зображення

Специфічна для моделі поведінка запиту

Авторизації

Тіло

Відповідь

​Офіційна довідка

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

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

​Запустити асинхронне завдання зображення

​Специфічна для моделі поведінка запиту

Авторизації

Тіло

Відповідь

Офіційна довідка

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

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

Запустити асинхронне завдання зображення

Специфічна для моделі поведінка запиту