> ## Documentation Index > Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt > Use this file to discover all available pages before exploring further. # GPT-Генерация изображений > Создавайте изображения на основе текстовых и графических подсказок. Получено из официального интерфейса OpenAI, поддерживает модели `gpt-image-1`, `dall-e-2`, `dall-e-3`. Документация переведена из официальной документации . Если вы интегрировали официальную документацию, вы можете использовать ее напрямую. Все входные/выходные параметры и поддержка согласованы. ### Модели изображений OpenAI TTAPI предоставляет доступ к моделям генерации изображений OpenAI через более простой и экономичный шлюз. Поскольку генерация изображений OpenAI является синхронным ответом и занимает много времени, рекомендуется использовать шлюз **[https://api.ttapi.org](https://api.ttapi.org)**. ## OpenAPI ````yaml openapi/ru/openai.json POST /v1/images/generations openapi: 3.1.0 info: title: Документация OpenAI API version: 1.0.0 description: TTAPI OpenAI API сервис servers: - url: https://api.ttapi.io security: [] paths: /v1/images/generations: post: description: >- Создавайте изображения на основе текстовых и графических подсказок. Получено из официального интерфейса OpenAI, поддерживает модели `gpt-image-1`, `dall-e-2`, `dall-e-3`. Документация переведена из официальной документации . Если вы интегрировали официальную документацию, вы можете использовать ее напрямую. Все входные/выходные параметры и поддержка согласованы. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GenerationsRequest' responses: '200': description: >- Запрос успешен, возвращает результаты создания изображения (поддерживает форматы url/base64) content: application/json: schema: type: object properties: created: type: integer description: Временная метка генерации (секунды) example: 1745818538 data: type: array items: oneOf: - title: Формат URL type: object properties: url: type: string description: >- CDN URL сгенерированного изображения. Срок действия: см. [Хранение и устойчивость](/grids/ru/faq/storage) example: >- https://filesystem.site/cdn/20250428/5LsFMT0Def02RVVUkwJ4v7IslleMzo.webp revised_prompt: type: string description: Оптимизированная подсказка example: >- A cute fluffy cat with big, bright eyes, soft fur, and a playful expression. It has a light gray coat with hints of white on its paws and tail. The cat is sitting in a cozy setting, surrounded by soft cushions, with its tail wrapped around its paws. Its ears are perked up, and it's looking directly at the viewer, exuding a sense of curiosity and warmth. required: - url - title: Формат Base64 type: object properties: b64_json: type: string description: >- Закодированная Base64 строка сгенерированного изображения example: iVBORw0KGgoAAAANSUhE... required: - b64_json description: Список результатов создания изображений usage: type: object properties: input_tokens: type: integer description: Входное количество токенов example: 9 input_tokens_details: type: object properties: image_tokens: type: integer description: Количество токенов изображения example: 0 text_tokens: type: integer description: Количество текстовых токенов example: 9 required: - image_tokens - text_tokens output_tokens: type: integer description: Количество выходных токенов example: 4160 total_tokens: type: integer description: Общее количество токенов example: 4169 required: - input_tokens - input_tokens_details - output_tokens - total_tokens required: - created - data examples: URL Format: summary: Вернуть изображение в формате URL value: data: - url: >- https://filesystem.site/cdn/20250428/5LsFMT0Def02RVVUkwJ4v7IslleMzo.webp revised_prompt: >- A cute fluffy cat with big, bright eyes, soft fur, and a playful expression. It has a light gray coat with hints of white on its paws and tail. The cat is sitting in a cozy setting, surrounded by soft cushions, with its tail wrapped around its paws. Its ears are perked up, and it's looking directly at the viewer, exuding a sense of curiosity and warmth. created: 1745818538 Base64 Format: summary: Вернуть изображение в формате Base64 value: created: 1745818890 data: - b64_json: iVBORw0KGgoAAAANSUhE... usage: input_tokens: 9 input_tokens_details: image_tokens: 0 text_tokens: 9 output_tokens: 4160 total_tokens: 4169 '400': $ref: '#/components/responses/400Response' '401': $ref: '#/components/responses/401Response' security: - CustomApiKey: [] components: schemas: GenerationsRequest: type: object properties: prompt: type: string description: "Текстовое описание изображения. Максимальная длина: `gpt-image-1` поддерживает до 32\_000 символов, `dall-e-2` поддерживает до 1\_000 символов, `dall-e-3` поддерживает до 4\_000 символов." background: type: string description: >- Управляет **прозрачностью создаваемого фона изображения**.
Этот параметр применим только к `gpt-image-1`. Выберите один из: `transparent`, `opaque` или `auto` (по умолчанию). Если установлено значение «авто», модель автоматически определяет оптимальный фон.
Если установлено значение «прозрачный», выходной формат должен поддерживать прозрачность, поэтому используйте png или webp. enum: - transparent - opaque - auto default: auto mode: type: string description: Поддерживаемые модели enum: - gpt-image-1 - dall-e-2 - dall-e-3 default: dall-e-2 moderation: type: string description: >- Управляет уровнем модерации контента для изображений, созданных gpt-image-1.. Выберите `low` (для менее строгой фильтрации) или `auto` (по умолчанию). enum: - low - auto default: auto 'n': type: integer description: >- Количество генерируемых изображений, по умолчанию 1.
Доступный диапазон `1-10`, `dall-e-3` фиксирован на 1. output_compression: type: integer description: >- **Уровень сжатия создаваемых изображений** (0-100%). Этот параметр применим только к gpt-image-1 с выходным форматом webp или jpeg, значение по умолчанию — 100. default: '100' output_format: type: string description: >- **Формат возвращаемого изображения**. Эта опция применима только к gpt-image-1... Опции: png (по умолчанию), jpeg, webp. enum: - png - png - jpeg default: png quality: type: string description: >- Качество изображения.
auto (по умолчанию) автоматически выбирает лучшее качество для данной модели.
gpt-image-1 поддерживает три качества: `high`, `medium`, `low`.
dall-e-3 поддерживает `hd` и `standard`.
dall-e-2 поддерживает только `standard`. default: auto response_format: type: string description: >- Формат возвращаемых данных.
dall-e-3 и dall-e-2 поддерживают `url` или `b64_json`. URL действительны в течение 60 минут, поэтому кэшируйте сразу после получения.
gpt-image-1 поддерживает только `b64_json`. size: type: string description: >- Размер изображения. Опции
gpt-image-1: `1024x1024`, `1536x1024`, `1024x1536`, `auto` (по умолчанию). Варианты
dall-e-2: `256x256`, `512x512`, `1024x1024`. Варианты
dall-e-3: `1024x1024`, `1792x1024`, `1024x1792`.
Примечание. Разные размеры используют разные квоты TTAPI. default: auto style: type: string description: >- Стиль создаваемого изображения. Этот параметр применим только к dall-e-3.. enum: - vivid (vivid) - natural (natural) required: - prompt responses: 400Response: description: Ошибка параметров content: application/json: schema: type: object properties: status: type: string example: FAILED message: type: string example: '"prompt" cannot be empty.' data: type: object required: - status - message 401Response: description: Ошибка авторизации content: application/json: schema: type: object properties: status: type: string example: FAILED message: type: string example: Wrong TT-API-KEY or email is not activated. required: - status - message securitySchemes: CustomApiKey: type: apiKey in: header name: TT-API-KEY description: >- Вы можете получить API-ключ в панель управления TTAPI. ````