Skip to main content
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.