Генерация изображений
Синхронный JSON-ответ содержит результаты изображений в данных.
На этой странице
https://api.shareai.now/api/v1/imagesГенерация изображений
- Базовый URL
https://api.shareai.now- Аутентификация
- Bearer API-ключ или утвержденный токен доступа OAuth
- Требуемая область
inferenceormonetization_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
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_IMAGES_MODEL',
'prompt': 'A quiet forest painted in watercolor.',
'n': 1}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/images', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/images", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Поля запроса#
| Поле | Тип | Значение и ограничения |
|---|---|---|
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