Создать изображение

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 для получения актуального списка параметров.

Сначала выберите модель

Используйте модель 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 для длительных задач генерации изображений, если ваш клиент предпочитает схему отправки и опроса вместо удержания одного HTTP-соединения открытым. Запрос на создание возвращает data.task_id. Выполняйте опрос Retrieve an image generation task, пока 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-ключи

Официальная справка

Сначала выберите модель

Безопасный первый запрос

Запуск асинхронной задачи изображения

Поведение запросов, зависящее от модели

Авторизации

Тело

Ответ

​Официальная справка

​Сначала выберите модель

​Безопасный первый запрос

​Запуск асинхронной задачи изображения

​Поведение запросов, зависящее от модели

Авторизации

Тело

Ответ

Официальная справка

Сначала выберите модель

Безопасный первый запрос

Запуск асинхронной задачи изображения

Поведение запросов, зависящее от модели