Сгенерировать изображение

Используйте модель изображений, которая в данный момент включена в ShareAI и разрешена вашими учетными данными. Модель определяет, какие размеры, уровни качества и параметры вывода она поддерживает.

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

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/images/generations" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "provider": {
    "sort": {
      "by": "price",
      "direction": "asc"
    }
  },
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
}'

import json
import os
import urllib.request

headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'provider': {'sort': {'by': 'price', 'direction': 'asc'}}, 'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
    print(json.load(response))

const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
  Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
  "provider": {
    "sort": {
      "by": "price",
      "direction": "asc"
    }
  },
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

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

Прочитать изображение#

Проверьте возвращенные data записи. В зависимости от модели и запрошенного формата запись содержит HTTPS URL изображения или данные изображения в формате base64. Используйте фактический возвращенный формат; не предполагайте, что каждый провайдер возвращает URL. API не загружает возвращенные URL изображений за вас.

Ограничения размера и времени#

Запросы выполняются синхронно. Общий текст ограничен 256 KiB, вызов провайдера — 120 секундами, а ответ — 2 MiB. Большие изображения в формате base64 могут превышать этот лимит ответа. Выберите подходящий размер вывода или модель, поддерживающую вывод URL.

Повторите осторожно#

Генерация изображения может повлечь за собой использование. После тайм-аута или неоднозначного сбоя сети проверьте активность перед повторной попыткой; повторение запроса может создать и начислить плату за другое изображение. API не выполняет автоматическую повторную попытку запроса изображения после отправки провайдеру.

Поддерживаемые операции#

Этот маршрут генерирует изображения из текста. Редактирование изображений, вариации, многокомпонентные загрузки и потоковая генерация изображений не поддерживаются. Текущая система оплаты требует совместимого контракта на использование токенов модели/провайдера; провайдеры, работающие только по принципу оплаты за изображение, могут быть недоступны.

Использовать авторизацию клиента#

Для утвержденного OAuth процесса отправьте токен доступа как Bearer. Генерация изображений, финансируемая аккаунтом, требует surcharge и утвержденного плана использования. Все ограничения модели, провайдера и аккаунта остаются в силе.

Идентификация модели и провайдеры выполнения#

Скопируйте точный идентификатор модели, основанный на создателе, из Модели. Выберите инфраструктуру отдельно с необязательным provider объектом. По умолчанию ранжирование подходящих провайдеров осуществляется по цене, начиная с самой низкой. Выберите провайдеров или ознакомьтесь с полным справочником политики.