Recraft V3 — модель генерации изображений для графического дизайна, фотографических и иллюстрированных сцен. Текстовое задание описывает объект, обстановку и композицию; результат — изображение. V3 развивает отображение текста и фотореализм Recraft, сохраняя стилевую согласованность по примерам без переобучения.
V3 работает с текстом внутри изображения, включая длинные надписи и буквы среднего размера. Recraft описывает этап макета, задающий слова и позиции до генерации. Макет создаётся автоматически из задания или вручную в дизайнерской среде Recraft. Это связывает заголовок, иллюстрацию и вспомогательный текст в одной композиции. Разработчик также документирует явные координаты текстового макета относительно изображения, а не фиксированной пиксельной сетки. Каждый элемент содержит одно слово и четыре угловые точки в нормированных координатах: (0, 0) — левый верхний угол, (1, 1) — правый нижний. Координаты могут выходить за диапазон, тогда форма обрезается. Слова, явно заданные в текстовом макете, должны соответствовать документированным ограничениям на символы.
Для постера или обложки дайте точные слова и иерархию: ведущая строка, её место и поддержка картинкой. При выборе результата проверьте написание и интервалы.
V3 включает готовые фотографические, иллюстративные и эмблемные стили, а также отдельную библиотеку векторных. Recraft V3 Raw — стиль по умолчанию растровой модели, Vector art — векторной. Photorealism стремится к фотографическому виду, Illustration допускает стилизованные текстуры, затенение и сложные цветовые переходы. Векторные стили предпочитают формы, ограниченные палитры, плоские заливки или простые градиенты.
Пользовательские стили создаются из референсов, существующих совместимых стилей или сочетания. Они дают повторно используемое направление серии. Документированные настройки смешивания назначают референсам и исходным стилям отдельные веса; число весов соответствует числу источников. Две перечисленные политики смешивания — PaletteMatch и MaxWeight. Разработчик допускает до 10 стилевых референсов и использует обычный режим соответствия стилю V3. Сохранённый пользовательский стиль и прямые референсы — альтернативные входы; пользовательский стиль должен соответствовать модели генерации.
Предпочтительные цвета и фон направляют палитру. Документированы до 10 RGB-цветов с компонентами от 0 до 255. Необязательные относительные веса — от 0 до 1; их задают всем цветам или ни одному, сумма не превышает 1. Художественный уровень — от 0 для статичной чистой обработки до 5 для динамичных эксцентричных композиций. Негативный промпт описывает нежелательные элементы; отдельное отключение текста убирает встроенные текстовые макеты. Для воспроизводимости доступен случайный seed. Эти настройки дают разные рычаги для сцены, стиля и макета.
Recraft документирует два варианта V3. Растровая модель выдаёт WebP без потерь или PNG для фотографических деталей, затенения и текстурной иллюстрации. Recraft V3 Vector выдаёт SVG: контуры и формы, масштабируемые без фиксированного разрешения. Этот вариант подходит для пиктограмм, концепций логотипов, значков и детальной векторной графики. Преобразование растра в вектор — отдельная операция, отличная от прямой генерации вектора.
Оба варианта имеют свою идентичность. Картинка с векторным видом и настоящий SVG — разные варианты результата. При подготовке дизайн-процесса задавайте результат, не считая общее имя V3 доказательством одинакового типа файла каждой операции.
Документация V3 перечисляет image-to-image, перерисовку области, расширение за границы и замену либо генерацию фона. Image-to-image объединяет существующую картинку и новое задание. Перерисовка обновляет выбранную область по изображению и совпадающей маске; расширение добавляет содержание за исходным кадром. Операции фона работают с окружением объекта.
Сопутствующие инструменты включают стирание, удаление фона, векторизацию и два подхода повышения разрешения. Creative upscaling может вносить новые детали; crisp upscaling создаёт более резкую увеличенную версию существующего содержания. Это отдельные операции с собственными входами и результатами, а не дополнительные значения имени растровой или векторной модели.
Спецификация генерации V3 принимает промпт до 1000 символов и 1–6 изображений на запрос. Поддерживает 14 пропорций: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 и 9:16. Растровые примеры включают 1024x1024, 1820x1024 и 1024x1820. Точные растровые размеры выбираются из списка; SVG использует пропорции без фиксированного пиксельного размера. Без размера система разработчика выбирает его по промпту.
Для операций с изображениями перечислены PNG, JPG и WebP, а SVG — где его допускает конкретная операция. Файлы меньше 20 МБ, не более 16 МП, длинная сторона не более 4096 пикселей. Короткая — не менее 256 пикселей, с исключением 32 пикселя для crisp upscaling. Маски совпадают с размером изображения и используют чистые чёрный и белый; общий предел стилевых референсов — 64 МБ.
Для проекта с Ailoot API превратите задачу в целевое задание изображения: точный текст, расположение предметов, стиль и композиция. Постер, товарная сцена и серия иконок требуют разных заданий; сохраняйте различия варианта V3 и операции при решении, как использовать каждый результат.
", "aboutText": "Recraft V3 — модель генерации изображений для графического дизайна, фотографических и иллюстрированных сцен. Текстовое задание описывает объект, обстановку и композицию; результат — изображение. V3 развивает отображение текста и фотореализм Recraft, сохраняя стилевую согласованность по примерам без переобучения.\n\n### Текст как часть композиции\n\nV3 работает с текстом внутри изображения, включая длинные надписи и буквы среднего размера. Recraft описывает этап макета, задающий слова и позиции до генерации. Макет создаётся автоматически из задания или вручную в дизайнерской среде Recraft. Это связывает заголовок, иллюстрацию и вспомогательный текст в одной композиции. Разработчик также документирует явные координаты текстового макета относительно изображения, а не фиксированной пиксельной сетки. Каждый элемент содержит одно слово и четыре угловые точки в нормированных координатах: (0, 0) — левый верхний угол, (1, 1) — правый нижний. Координаты могут выходить за диапазон, тогда форма обрезается. Слова, явно заданные в текстовом макете, должны соответствовать документированным ограничениям на символы.\n\nДля постера или обложки дайте точные слова и иерархию: ведущая строка, её место и поддержка картинкой. При выборе результата проверьте написание и интервалы.\n\n### Стиль, палитра и художественное направление\n\nV3 включает готовые фотографические, иллюстративные и эмблемные стили, а также отдельную библиотеку векторных. Recraft V3 Raw — стиль по умолчанию растровой модели, Vector art — векторной. Photorealism стремится к фотографическому виду, Illustration допускает стилизованные текстуры, затенение и сложные цветовые переходы. Векторные стили предпочитают формы, ограниченные палитры, плоские заливки или простые градиенты.\n\nПользовательские стили создаются из референсов, существующих совместимых стилей или сочетания. Они дают повторно используемое направление серии. Документированные настройки смешивания назначают референсам и исходным стилям отдельные веса; число весов соответствует числу источников. Две перечисленные политики смешивания — PaletteMatch и MaxWeight. Разработчик допускает до 10 стилевых референсов и использует обычный режим соответствия стилю V3. Сохранённый пользовательский стиль и прямые референсы — альтернативные входы; пользовательский стиль должен соответствовать модели генерации.\n\nПредпочтительные цвета и фон направляют палитру. Документированы до 10 RGB-цветов с компонентами от 0 до 255. Необязательные относительные веса — от 0 до 1; их задают всем цветам или ни одному, сумма не превышает 1. Художественный уровень — от 0 для статичной чистой обработки до 5 для динамичных эксцентричных композиций. Негативный промпт описывает нежелательные элементы; отдельное отключение текста убирает встроенные текстовые макеты. Для воспроизводимости доступен случайный seed. Эти настройки дают разные рычаги для сцены, стиля и макета.\n\n### Растровые изображения и отдельный SVG-вариант\n\nRecraft документирует два варианта V3. Растровая модель выдаёт WebP без потерь или PNG для фотографических деталей, затенения и текстурной иллюстрации. Recraft V3 Vector выдаёт SVG: контуры и формы, масштабируемые без фиксированного разрешения. Этот вариант подходит для пиктограмм, концепций логотипов, значков и детальной векторной графики. Преобразование растра в вектор — отдельная операция, отличная от прямой генерации вектора.\n\nОба варианта имеют свою идентичность. Картинка с векторным видом и настоящий SVG — разные варианты результата. При подготовке дизайн-процесса задавайте результат, не считая общее имя V3 доказательством одинакового типа файла каждой операции.\n\n### Редактирование и завершение существующей графики\n\nДокументация V3 перечисляет image-to-image, перерисовку области, расширение за границы и замену либо генерацию фона. Image-to-image объединяет существующую картинку и новое задание. Перерисовка обновляет выбранную область по изображению и совпадающей маске; расширение добавляет содержание за исходным кадром. Операции фона работают с окружением объекта.\n\nСопутствующие инструменты включают стирание, удаление фона, векторизацию и два подхода повышения разрешения. Creative upscaling может вносить новые детали; crisp upscaling создаёт более резкую увеличенную версию существующего содержания. Это отдельные операции с собственными входами и результатами, а не дополнительные значения имени растровой или векторной модели.\n\n### Ограничения промпта, размера и исходного изображения\n\nСпецификация генерации V3 принимает промпт до 1000 символов и 1–6 изображений на запрос. Поддерживает 14 пропорций: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 и 9:16. Растровые примеры включают 1024x1024, 1820x1024 и 1024x1820. Точные растровые размеры выбираются из списка; SVG использует пропорции без фиксированного пиксельного размера. Без размера система разработчика выбирает его по промпту.\n\nДля операций с изображениями перечислены PNG, JPG и WebP, а SVG — где его допускает конкретная операция. Файлы меньше 20 МБ, не более 16 МП, длинная сторона не более 4096 пикселей. Короткая — не менее 256 пикселей, с исключением 32 пикселя для crisp upscaling. Маски совпадают с размером изображения и используют чистые чёрный и белый; общий предел стилевых референсов — 64 МБ.\n\nДля проекта с Ailoot API превратите задачу в целевое задание изображения: точный текст, расположение предметов, стиль и композиция. Постер, товарная сцена и серия иконок требуют разных заданий; сохраняйте различия варианта V3 и операции при решении, как использовать каждый результат.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "da810e8097be45388056233b749bfae332545cabe979355d9f38a643bb8f3533", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "recraft/recraft-v3Recraft V3 создаёт фотографии, иллюстрации и графические макеты с композицией, учитывающей текст, и стилевыми настройками. Отдельные растровый и SVG-варианты подходят для постеров, брендовых наборов, иконок и дизайнов, где слова и визуальная структура должны работать вместе.
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Recraft V3 — модель генерации изображений для графического дизайна, фотографических и иллюстрированных сцен. Текстовое задание описывает объект, обстановку и композицию; результат — изображение. V3 развивает отображение текста и фотореализм Recraft, сохраняя стилевую согласованность по примерам без переобучения.
V3 работает с текстом внутри изображения, включая длинные надписи и буквы среднего размера. Recraft описывает этап макета, задающий слова и позиции до генерации. Макет создаётся автоматически из задания или вручную в дизайнерской среде Recraft. Это связывает заголовок, иллюстрацию и вспомогательный текст в одной композиции. Разработчик также документирует явные координаты текстового макета относительно изображения, а не фиксированной пиксельной сетки. Каждый элемент содержит одно слово и четыре угловые точки в нормированных координатах: (0, 0) — левый верхний угол, (1, 1) — правый нижний. Координаты могут выходить за диапазон, тогда форма обрезается. Слова, явно заданные в текстовом макете, должны соответствовать документированным ограничениям на символы.
Для постера или обложки дайте точные слова и иерархию: ведущая строка, её место и поддержка картинкой. При выборе результата проверьте написание и интервалы.
V3 включает готовые фотографические, иллюстративные и эмблемные стили, а также отдельную библиотеку векторных. Recraft V3 Raw — стиль по умолчанию растровой модели, Vector art — векторной. Photorealism стремится к фотографическому виду, Illustration допускает стилизованные текстуры, затенение и сложные цветовые переходы. Векторные стили предпочитают формы, ограниченные палитры, плоские заливки или простые градиенты.
Пользовательские стили создаются из референсов, существующих совместимых стилей или сочетания. Они дают повторно используемое направление серии. Документированные настройки смешивания назначают референсам и исходным стилям отдельные веса; число весов соответствует числу источников. Две перечисленные политики смешивания — PaletteMatch и MaxWeight. Разработчик допускает до 10 стилевых референсов и использует обычный режим соответствия стилю V3. Сохранённый пользовательский стиль и прямые референсы — альтернативные входы; пользовательский стиль должен соответствовать модели генерации.
Предпочтительные цвета и фон направляют палитру. Документированы до 10 RGB-цветов с компонентами от 0 до 255. Необязательные относительные веса — от 0 до 1; их задают всем цветам или ни одному, сумма не превышает 1. Художественный уровень — от 0 для статичной чистой обработки до 5 для динамичных эксцентричных композиций. Негативный промпт описывает нежелательные элементы; отдельное отключение текста убирает встроенные текстовые макеты. Для воспроизводимости доступен случайный seed. Эти настройки дают разные рычаги для сцены, стиля и макета.
Recraft документирует два варианта V3. Растровая модель выдаёт WebP без потерь или PNG для фотографических деталей, затенения и текстурной иллюстрации. Recraft V3 Vector выдаёт SVG: контуры и формы, масштабируемые без фиксированного разрешения. Этот вариант подходит для пиктограмм, концепций логотипов, значков и детальной векторной графики. Преобразование растра в вектор — отдельная операция, отличная от прямой генерации вектора.
Оба варианта имеют свою идентичность. Картинка с векторным видом и настоящий SVG — разные варианты результата. При подготовке дизайн-процесса задавайте результат, не считая общее имя V3 доказательством одинакового типа файла каждой операции.
Документация V3 перечисляет image-to-image, перерисовку области, расширение за границы и замену либо генерацию фона. Image-to-image объединяет существующую картинку и новое задание. Перерисовка обновляет выбранную область по изображению и совпадающей маске; расширение добавляет содержание за исходным кадром. Операции фона работают с окружением объекта.
Сопутствующие инструменты включают стирание, удаление фона, векторизацию и два подхода повышения разрешения. Creative upscaling может вносить новые детали; crisp upscaling создаёт более резкую увеличенную версию существующего содержания. Это отдельные операции с собственными входами и результатами, а не дополнительные значения имени растровой или векторной модели.
Спецификация генерации V3 принимает промпт до 1000 символов и 1–6 изображений на запрос. Поддерживает 14 пропорций: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 и 9:16. Растровые примеры включают 1024x1024, 1820x1024 и 1024x1820. Точные растровые размеры выбираются из списка; SVG использует пропорции без фиксированного пиксельного размера. Без размера система разработчика выбирает его по промпту.
Для операций с изображениями перечислены PNG, JPG и WebP, а SVG — где его допускает конкретная операция. Файлы меньше 20 МБ, не более 16 МП, длинная сторона не более 4096 пикселей. Короткая — не менее 256 пикселей, с исключением 32 пикселя для crisp upscaling. Маски совпадают с размером изображения и используют чистые чёрный и белый; общий предел стилевых референсов — 64 МБ.
Для проекта с Ailoot API превратите задачу в целевое задание изображения: точный текст, расположение предметов, стиль и композиция. Постер, товарная сцена и серия иконок требуют разных заданий; сохраняйте различия варианта V3 и операции при решении, как использовать каждый результат.
POST /v1/images/generationstext, imageimage| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения recraft/recraft-v3 | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения Минимальная длина: 1 | По умолчанию— |
Полеn | Типinteger | ТребованиеНеобязательно | Значения и ограничения Минимум: 1 Максимум: 6 | По умолчанию— |
Полеaspect_ratio | Типstring | ТребованиеНеобязательно | Значения и ограничения 1:1, 4:3, 3:4, 16:9, 9:16, auto | По умолчанию— |
Полеinput_references | Типarray | ТребованиеНеобязательно | Значения и ограничения Минимум элементов: 0 Максимум элементов: 1 | По умолчанию— |
Из текста в изображение · Обязательно: prompt
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt |
Параметрmaterial_types | Контрактtext, image |
Параметрoptional_controls | Контрактaspect_ratio, n, input_references |
Параметрexact_supported_parameters | Контракт{"aspect_ratio":{"type":"enum","values":["1:1","4:3","3:4","16:9","9:16","auto"]},"n":{"type":"range","min":1,"max":6},"input_references":{"type":"range","min":0,"max":1}} |
Параметрreference_material_rule | КонтрактТолько фактические референсные изображения клиента; к ним применяются условия конечной точки поставщика. |
Псевдонимы метода: /v1/images
Жизненный цикл: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или запись в медиатеке
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Используйте точную модель и документированные поля ввода.
Сохраните полный ответ, каждый фактический результат и исходные возвращённые ID.
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Расчётная единица | Плата |
|---|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Расчётная единица— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияUltra | Шкала ставок— | Прогноз количества— | Расчётная единицаза выходное изображение | Плата Выход · вывод изображения · Оценка только для сравнения $0.08 за выходное изображение |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Расчётная единица— | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.08 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Справочные шкалы модели не меняют выбор метода, расчёт стоимости или списания. Действующая плата определяется ставками выбранного метода Ailoot.
| Конфигурация | Условия расчёта | Плата |
|---|---|---|
| КонфигурацияВыходное изображение | Условия расчётаВариант тарификации не заявлен. | Плата Выход · Выходное изображение $0.08 за изображение Эквивалентные записи описывают одно начисление; они не добавляют вторую плату. |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'recraft/recraft-v3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nrequest={'model': 'recraft/recraft-v3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "recraft/recraft-v3", "prompt": "a red panda astronaut floating in space, studio lighting"};\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nЗагрузите каждое полученное изображение или сохраните его содержимое Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.
Сохраните каждый элемент data и полные данные об использовании; обеспечьте принадлежность Ailoot и сохранение всех фактически возвращённых изображений. Не выдумывайте URL или ID.
Если результат генерации или редактирования изображения требует проверки, сохраните исходный operation_id/X-Client-Request-ID и возвращённые сведения о результате. Восстановите существующие собственные результаты через медиатеку, используя фактические значения task_id или asset_id. Не отправляйте запрос генерации или редактирования повторно и не составляйте URL опроса из operation_id.
| Поле | Тип |
|---|---|
Полеcreated | Типinteger |
Полеdata[].url | Типstring |
Полеdata[].b64_json | Типbase64 string |
Полеusage | Типobject |
Ailoot Ultra recraft/recraft-v3
/v1/images