> ## 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`. Поскольку редактирование изображений OpenAI является синхронным ответом и занимает много времени, рекомендуется использовать шлюз **[https://api.ttapi.org](https://api.ttapi.org)**. ## OpenAPI ````yaml openapi/ru/openai.json POST /v1/images/edits 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/edits: post: description: >- Документация переведена из официальной документации . Если вы интегрировали официальную документацию, вы можете использовать ее напрямую. Все входные/выходные параметры и поддержка согласованы. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/EditsRequest' responses: '200': description: >- Запрос успешен, возвращает результаты генерации изображения в формате Base64. content: application/json: schema: type: object properties: created: type: integer description: Временная метка генерации (секунды) example: 1713833628 data: type: array items: type: object properties: b64_json: type: string description: >- Закодированная Base64 строка сгенерированного изображения example: >- iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABhWlDQ1BJQ0MgcHJvZmlsZQAAKJF9kT1Iw0AcxV9TpSItDnaQIpKhOlkQVFIwU8CR1NZBLi4iFg8B4R33PTK77Z22p22e+628923923f/jH53eV73923/... required: - b64_json description: Список результатов создания изображений usage: type: object description: >- Использование токена (должен возвращаться для формата Base64) properties: input_tokens: type: integer description: Входное количество токенов example: 50 input_tokens_details: type: object properties: image_tokens: type: integer description: Количество токенов изображения example: 40 text_tokens: type: integer description: Количество текстовых токенов example: 10 required: - image_tokens - text_tokens example: image_tokens: 40 text_tokens: 10 output_tokens: type: integer description: Количество выходных токенов example: 50 total_tokens: type: integer description: Общее количество токенов example: 100 required: - input_tokens - input_tokens_details - output_tokens - total_tokens example: input_tokens: 50 input_tokens_details: image_tokens: 40 text_tokens: 10 output_tokens: 50 total_tokens: 100 required: - created - data - usage example: created: 1713833628 data: - b64_json: >- iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABhWlDQ1BJQ0MgcHJvZmlsZQAAKJF9kT1Iw0AcxV9TpSItDnaQIpKhOlkQVFIwU8CR1NZBLi4iFg8B4R33PTK77Z22p22e+628923923f/jH53eV73923/... usage: total_tokens: 100 input_tokens: 50 output_tokens: 50 input_tokens_details: text_tokens: 10 image_tokens: 40 '400': $ref: '#/components/responses/400Response' '401': $ref: '#/components/responses/401Response' security: - CustomApiKey: [] components: schemas: EditsRequest: type: object properties: prompt: type: string description: "Текстовое описание изображения. Максимальная длина: `gpt-image-1` поддерживает до 32\_000 символов, `dall-e-2` поддерживает до 1\_000 символов, `dall-e-3` поддерживает до 4\_000 символов." image: type: array description: >- **Изображение для редактирования**. Должен быть поддерживаемым файлом изображения или массивом изображений.
`gpt-image-1`: каждое изображение должно быть в формате PNG, WebP или jpg размером менее 25 МБ.
`dall-e-2`: вы можете предоставить только одно изображение, и это должен быть квадратный файл PNG размером менее 4 МБ. mask: type: file description: >- **Дополнительное изображение, где полностью прозрачные области (например, нулевое значение альфа) указывают, где изображение следует редактировать**. Если предоставлено несколько изображений, маска применяется к первому изображению. Должен быть действительный файл PNG размером менее 4 МБ и того же размера, что и изображение. mode: type: string description: Поддерживаемые модели enum: - gpt-image-1 - dall-e-2 default: dall-e-2 'n': type: integer description: >- Количество генерируемых изображений, по умолчанию 1.
Доступный диапазон `1-10` output_compression: type: integer description: >- **Уровень сжатия создаваемых изображений** (0-100%). Этот параметр применим только к gpt-image-1 с выходным форматом webp или jpeg, значение по умолчанию — 100. default: '100' 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 required: - prompt - image 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. ````