OpenAI: DALL·E 3
DALL·E 3 генерирует изображения по текстовому заданию сцены. Используйте точный ID модели openai/dall-e-3 или её псевдоним dall-e-3 с методом генерации изображений, затем сохраняйте каждый возвращённый URL изображения и сопутствующий результат. Документированный начальный запрос создаёт одно изображение 1024x1024 по тексту.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
DALL·E 3 — модель OpenAI для создания изображений по тексту. Используйте текстовое задание для создания иллюстрации, концепции сцены или визуального направления дизайна. Опишите в запросе объект, окружение, композицию, освещение и визуальное решение. Например, концептуальное задание может предусматривать велосипед доставки возле маленького магазина в сумерках, вид с улицы, ясный главный объект на переднем плане и сдержанную цветовую палитру.
Отправьте POST /v1/images/generations с телом application/json. Точный публичный ID модели — openai/dall-e-3; допущенный псевдоним dall-e-3 выбирает ту же карточку модели. Документированная начальная структура передаёт model, prompt, n:1 и size:"1024x1024". n — необязательное целое число, по умолчанию 1. Отправьте stream:false или опустите stream для полного результата JSON. Используйте непустой текстовый запрос и сосредоточьте его на одном полном задании изображения. Предлагаемый метод — генерация изображения по тексту.
Явно задавайте требования, важные для размещения. Редакционная иллюстрация может называть центральную идею и объекты, её выражающие. Концепция сцены может определять положение камеры, время суток и части композиции, которым нужно пространство вокруг. Отделяйте точные слова, которые должны появиться на изображении, от описаний сцены, затем проверяйте отрисованные надписи и визуальное расположение перед использованием выбранного результата.
Ответ генерации — JSON с временной меткой created и массивом data. Документированный элемент результата включает url и может включать revised_prompt, prompt_filter_results и content_filter_results. Сохраняйте эти поля с полным ответом и загружайте изображение по каждому возвращённому подписанному URL Ailoot. Подписанные ссылки Ailoot на файлы действуют 24 часа с момента выдачи. Сохраняйте точный возвращённый URL, включая строку запроса, пока файл не сохранён; определяйте формат сохранённого изображения по фактическому ответу или байтам файла.
Считайте возвращённый файл изображения пригодным дизайнерским ресурсом, а JSON — сопровождающей записью генерации. Проверьте изображение по предоставленному заданию перед размещением на странице, в презентации или приложении. Если ответ неполон или исход отправки неопределён, сохраняйте идентификатор исходного запроса и возвращённые сведения при проверке существующей попытки вместо создания ещё одного изображения только ради восстановления недостающего результата. Для получения сохранённых результатов используйте тот же API-ключ для GET /v1/media/assets?family=image и пройдите по всем next_cursor. ID ресурса находится в каждом возвращённом URL /v1/media/assets/{asset_id}/content и в его записи медиатеки. Прочитайте GET /v1/media/assets/{asset_id} для каждой выбранной записи и загрузите точный content_url. Если запрос файла возвращает 404 с кодом link_expired, повторно прочитайте тот же ресурс для обновлённой ссылки. Обновление ссылки на ресурс не требует ещё одного запроса генерации изображения.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Начало
DALL·E 3 генерирует изображения по текстовому заданию сцены. Используйте точный ID модели openai/dall-e-3 или её псевдоним dall-e-3 с методом генерации изображений, затем сохраняйте каждый возвращённый URL изображения и сопутствующий результат. Документированный начальный запрос создаёт одно изображение 1024x1024 по тексту.
- Допустимые входные данные
- Текст
- Результаты
- Картинки
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Images POST /v1/images/generations
- Входные данные
text- Результат
image- Выходной формат
- Файл изображения
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения openai/dall-e-3 | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеstream | Типboolean | ТребованиеНеобязательно | Значения и ограничения false | По умолчаниюfalse |
Полеn | Типinteger | ТребованиеНеобязательно | Значения и ограничения 1 | По умолчанию— |
Полеsize | Типstring | ТребованиеНеобязательно | Значения и ограничения 1024x1024 | По умолчанию— |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt |
Параметрoptional | Контрактstream, n, size |
Параметрmaterial_types | Контрактtext |
Параметрconditions | КонтрактUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Жизненный цикл: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Тарифы
Как рассчитывается итоговая плата
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Оценочные ставки для сравнения
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Плата |
|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияEstimated generation cost | Шкала ставок— | Прогноз количестваОценка для одной генерации | Плата Вход · Оценочная стоимость генерации · Оценка только для сравнения $0.32768 оценка до генерации This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Получить и сохранить результаты
Ailoot Ultra · Images
Загрузите каждое полученное изображение или сохраните его содержимое Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Сохраняйте все готовые результаты
Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Если нужно проверить исходный ответ
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Псевдонимы
Псевдонимы моделей
Ailoot Ultra openai/dall-e-3, dall-e-3
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Начало
DALL·E 3 генерирует изображения по текстовому заданию сцены. Используйте точный ID модели openai/dall-e-3 или её псевдоним dall-e-3 с методом генерации изображений, затем сохраняйте каждый возвращённый URL изображения и сопутствующий результат. Документированный начальный запрос создаёт одно изображение 1024x1024 по тексту.
- Допустимые входные данные
- Текст
- Результаты
- Картинки
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Images POST /v1/images/generations
- Входные данные
text- Результат
image- Выходной формат
- Файл изображения
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения dall-e-3 | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеstream | Типboolean | ТребованиеНеобязательно | Значения и ограничения false | По умолчаниюfalse |
Полеn | Типinteger | ТребованиеНеобязательно | Значения и ограничения 1 | По умолчанию— |
Полеsize | Типstring | ТребованиеНеобязательно | Значения и ограничения 1024x1024 | По умолчанию— |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt |
Параметрoptional | Контрактstream, n, size |
Параметрmaterial_types | Контрактtext |
Параметрconditions | КонтрактUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Жизненный цикл: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Тарифы
Как рассчитывается итоговая плата
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Оценочные ставки для сравнения
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Плата |
|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияEstimated generation cost | Шкала ставок— | Прогноз количестваОценка для одной генерации | Плата Вход · Оценочная стоимость генерации · Оценка только для сравнения $0.32768 оценка до генерации This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Получить и сохранить результаты
Ailoot Ultra · Images
Загрузите каждое полученное изображение или сохраните его содержимое Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Сохраняйте все готовые результаты
Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Если нужно проверить исходный ответ
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Псевдонимы
Псевдонимы моделей
Ailoot Ultra openai/dall-e-3, dall-e-3
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · OpenAI: DALL·E 3
- Какие входные данные и результаты доступны?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Какие поля использует запрос?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size