Перейти к основному содержанию
POST
Text-to-image: generate an image from a text prompt
Интерактивный Playground справа позволяет протестировать работу онлайн. Введите ваш API-ключ в поле Authorization (формат: Bearer sk-xxx), выберите model, укажите prompt, при необходимости задайте width / height и отправьте запрос.
Сценарий использования: эта страница предназначена только для генерации изображений по тексту. Чтобы изменить существующее изображение, используйте API редактирования изображений.
⚠️ Три параметра возвращают 400Эта серия не принимает response_format, seed или negative_prompt; передача любого из них приводит к ошибке 400 Invalid parameters: xxx. Если вы переходите с gpt-image / DALL·E, сначала удалите response_format. В ответе всегда возвращается data[0].b64_json.
⚠️ Используйте width + height, а не sizeЭтот эндпоинт без уведомления игнорирует size и всегда генерирует 1024×1024. Используйте целочисленные параметры width + height (обязательно вместе): каждая сторона ≥ 768, width × height ≤ 2 359 296 (площадь 1536×1536).
Все API генерации изображений работают синхронно: асинхронный task ID не поддерживается. Если клиент разрывает соединение, результат теряется, но запрос все равно тарифицируется. Генерация изображения 1024×1024 занимает около 17 с на Flash и около 30 с на 2.6. Установите таймаут клиента не менее 120 с для Flash и 180 с для 2.6. См. Основы и лучшие практики Image API.

Примеры кода

Python (OpenAI SDK)

Python (requests)

cURL

Node.js (fetch)

Нужно несколько изображений: отправляйте параллельные запросы

Эндпоинт генерации изображений по тексту возвращает 1 изображение за вызов (n не имеет эффекта), поэтому выполняйте запросы параллельно:

Справочник параметров

quality, output_format, background, style и другие поля в стиле OpenAI молча игнорируются. Результат всегда в формате PNG.

Формат ответа

Поля ответа
  • b64_json — это обычный base64 без префикса data:image/png;base64,. Декодируйте его напрямую, чтобы получить PNG.
  • Поле url отсутствует, как и revised_prompt.
  • PNG размером 1024×1024 занимает около 1,5–1,7 МБ (2,1–2,3 МБ в виде base64); 1536×1536 — около 4–5 МБ. Проверьте ограничения вашего клиента на размер ответа.
Не сверяйте тарификацию с usage: prompt_tokens всегда равен 1000 × количество изображений, а output_tokens всегда равен 0; это плейсхолдеры. Данная серия тарифицируется за изображение, а данные в консоли APIYI являются определяющими.

Авторизации

Authorization
string
header
обязательно

API key from the APIYI console

Тело

application/json
model
enum<string>
по умолчанию:MAI-Image-2.6-Flash
обязательно

Model ID (case-sensitive). 2.6 favors quality, Flash favors speed

Доступные опции:
MAI-Image-2.6-Flash,
MAI-Image-2.6
prompt
string
обязательно

Prompt in any language. Put text that should appear in the image in quotes

Пример:

"A traditional teahouse storefront with a wooden sign that reads \"Welcome\", red lanterns, warm dusk light, photorealistic"

width
integer
по умолчанию:1024

Output width in pixels. Each side ≥ 768, width × height ≤ 2,359,296 (a 1536×1536 area); must be sent together with height; rounded down to a multiple of 16.

Требуемый диапазон: x >= 768
Пример:

1024

height
integer
по умолчанию:1024

Output height in pixels, same rules as width

Требуемый диапазон: x >= 768
Пример:

1024

Ответ

Image generated

created
integer

Creation timestamp

Пример:

1790999642

data
object[]

Image results; always 1 item for text-to-image

usage
object

Placeholder values, not for billing reconciliation. prompt_tokens is always 1000 × images and output_tokens is always 0. The console bill is authoritative.