ShareAI Platform Docs

Генерация изображений

Синхронный JSON-ответ содержит результаты изображений в данных.

Просмотреть как Markdown
На этой странице
POST https://api.shareai.now/api/v1/images

Генерация изображений

Базовый URL
https://api.shareai.now
Аутентификация
Bearer API-ключ или утвержденный токен доступа OAuth
Требуемая область
inference or monetization_gateway

Синхронный JSON-ответ содержит результаты изображений в data. Псевдоним /api/v1/images/generations также поддерживается. Опции, такие как размер, разрешение, соотношение сторон, качество и формат вывода, зависят от выбранной модели. Ответы ограничены 2 MiB; уменьшите количество или размер изображений при необходимости. Возвращаемые изображения ограничены 8192 пикселями на сторону.

Перед началом#

Установите SHAREAI_API_KEY на вашем сервере и замените заполнитель модели на текущую включенную модель. Никогда не раскрывайте API-ключ в коде браузера. Модель, учетная запись, учетные данные и провайдер должны разрешать эту операцию. Дополнительные настройки ниже требуют поддержки модели; границы безопасности API не гарантируют, что каждая модель поддерживает каждое значение.

Отправить запрос#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/images" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_IMAGES_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1
}'

Поля запроса#

ПолеТипЗначение и ограничения
model обязательнострокаТочный идентификатор включенной публичной модели. Должен объявлять эту операцию и быть разрешен вашими учетными данными.
prompt обязательнострокаНепустой запрос генерации, не более 256 KiB текста в кодировке UTF-8.
nцелое числоНеобязательное количество изображений, от 1 до 10; по умолчанию 1. Ваша модель может разрешать меньшее количество.
sizeстрокаРазмер вывода, поддерживаемый моделью, не более 100 символов, например 1024×1024. Не каждая модель поддерживает эту опцию.
resolutionстрокаСелектор разрешения, поддерживаемый моделью, не более 100 символов; должен соответствовать опубликованному тарифному варианту.
aspect_ratioстрокаСелектор соотношения сторон, поддерживаемый моделью, не более 100 символов.
qualityстрокаСелектор качества, поддерживаемый моделью, не более 100 символов; может выбирать другой тариф.
response_formatстрокаФормат ответа, поддерживаемый моделью, не более 100 символов. Операция определяет, будет ли результат в формате JSON или бинарным.
output_formatстрокаСелектор кодировки вывода, поддерживаемый моделью, не более 100 символов.
backgroundстрокаНеобязательная настройка фона изображения, если поддерживается моделью.
seedцелое числоНеобязательное начальное значение, поддерживаемое моделью. Для видео требуется неотрицательное целое число; воспроизводимость зависит от исполнителя.
input_referencesмассивНе более 16 частей image_url с установленным image_url.url в HTTPS URL или поддерживаемый URL данных изображения. Требуется поддержка модели.
providerобъектНеобязательные предпочтения маршрутизации провайдера. Используйте provider.only для принятых тегов провайдера, а не префикс в ID модели. Ограничения учетной записи и учетных данных все равно применяются.

Прочитать результат#

Успешный ответ возвращает HTTP 200 с JSON. Синхронный JSON-ответ содержит результаты изображений в data. Псевдоним /api/v1/images/generations также поддерживается. Опции, такие как размер, разрешение, соотношение сторон, качество и формат вывода, зависят от выбранной модели. Ответы ограничены 2 MiB; уменьшите количество или размер изображений при необходимости. Возвращаемые изображения ограничены 8192 пикселями на сторону.

Единицы выставления счетов#

Тарифы на изображения могут использовать сгенерированные изображения, измеренные мегапиксели, входные ссылки, запросы или токены, указанные провайдером. URL изображения не является измерением размера изображения. Тарифы на мегапиксели требуют размеров возвращаемого изображения; используйте вывод base64 для этих маршрутов.

Выберите точный идентификатор включенной модели из Console. Ее объявленная операция и возможности ввода/вывода должны соответствовать этой конечной точке; текстовая модель чата не может быть заменена для другой операции. Ваши учетные данные, провайдер и ограничения учетной записи все равно применяются.

Цены и использование#

Тарифы публикуются в AI-кредитах в евро для выбранной модели, провайдера, единиц и вариантов. Оплачиваются только измерения в активном тарифе. Оценка резервирует кредиты перед выполнением; окончательные списания основаны на измеренном использовании. Цены могут зависеть от разрешения, формата вывода или диапазона использования. Проверьте Console Usage для окончательного списания ShareAI. Поля затрат на вышестоящем уровне и байты медиа не преобразуются в вымышленные токены.

Доступ и ошибки#

Используйте inference для утвержденного вывода инференса с сетевыми затратами или monetization_gateway для утвержденной наценки Builder и принятых условий выставления счетов. Доступ только по идентификации не авторизует расходы. Проверка, авторизация модели, недостаток кредитов, ограничения тарифов и ошибки выполнения возвращают структурированный error. После тайм-аута или неопределенной отправки проверьте Usage или видео-задачу перед созданием другого потенциально оплачиваемого запроса.

Последнее обновление 3 ноября 2026

Документация платформы ShareAI
Вся документация

Искать по названию или содержанию.

Спросить об этой странице

Выберите помощника для изучения этой страницы. Вы также можете скопировать страницу и вставить её в ваш диалог.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI