Zhipu: CogView 4
CogView 4 — модель Zhipu для создания изображений по тексту, доступная в Ailoot Ultra под точным ID cogview-4. Передайте описание сцены, чтобы создать иллюстрацию, сцену с продуктом или визуальную концепцию. Документированные параметры включают размер изображения, качество standard или hd и watermark_enabled; ответ содержит URL изображений, которые следует сохранить все.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
CogView 4 превращает текстовое задание в изображения. Выберите cogview-4 в POST /v1/images/generations и передайте prompt как текстовую строку. Обязательные входные поля — model и prompt. Опишите в задании главный объект, его расположение, окружающую сцену и визуальное решение, которое хотите оценить.
Для сцены с продуктом опишите объект, поверхность под ним, фон и направление света. Для иллюстрации укажите персонажей или объекты, желаемое настроение и композицию. Если изображение будет располагаться рядом с заголовком или описанием продукта, укажите, где в композиции следует оставить свободное место. Сверьте результат с этими конкретными требованиями перед использованием в макете.
Рекомендации по размерам для CogView перечисляют 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 и 720x1440. Для произвольного размера каждая сторона должна быть от 512 до 2048 пикселей и делиться на 16, а общее число пикселей не должно превышать 2^21. Подбирайте кадрирование под размещение: вертикальная иллюстрация, квадратная сцена с продуктом и широкое изображение требуют разных композиций, а не только разных размеров.
quality принимает standard или hd; документированное значение CogView по умолчанию — standard. watermark_enabled — логический параметр с документированным значением по умолчанию true. Необязательная строка user_id обозначает конечного пользователя и должна содержать от 6 до 128 символов. Держите этот идентификатор отдельно от творческого запроса. Изменения качества или размера должны соответствовать понятному назначению изображения, дополняя описание того, что должно быть на нём.
Генерация возвращает синхронный ответ JSON с created и data. Каждый элемент data[] содержит url. Загрузите каждое возвращённое изображение и сохраните ответ вместе с заданием и выбранными настройками; не сохраняйте только первый элемент лишь потому, что в предпросмотре показано одно изображение. Документированный контракт не вводит для этого запроса изображений отдельный этап опроса задания по образцу видео. Если ответ прерван или неполон, сохраните сведения об исходном запросе и полученный результат, прежде чем решать, уместен ли ещё один запрос на создание. Ailoot сохраняет эти изображения как принадлежащие вам медиаресурсы и возвращает подписанные ссылки Ailoot. Найдите записи ресурсов через GET /v1/media/assets?family=image, проходя по всем next_cursor. Прочитайте GET /v1/media/assets/{asset_id} с каждым фактическим asset_id, чтобы получить его content_url; повторно прочитайте тот же ресурс, если срок подписанной ссылки истёк.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Начало
CogView 4 — модель Zhipu для создания изображений по тексту, доступная в Ailoot Ultra под точным ID cogview-4. Передайте описание сцены, чтобы создать иллюстрацию, сцену с продуктом или визуальную концепцию. Документированные параметры включают размер изображения, качество standard или hd и watermark_enabled; ответ содержит URL изображений, которые следует сохранить все.
- Допустимые входные данные
- Текст
- Результаты
- Картинки
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Images POST /v1/images/generations
- Входные данные
text- Результат
image- Выходной формат
- Файл изображения
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения cogview-4 | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеsize | Типstring | ТребованиеНеобязательно | Значения и ограничения 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | По умолчанию1280x1280 |
Полеuser_id | Типstring | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеquality | Типstring | ТребованиеНеобязательно | Значения и ограничения hd, standard | По умолчанию— |
Полеwatermark_enabled | Типboolean | ТребованиеНеобязательно | Значения и ограничения | По умолчаниюtrue |
Полеstream | Типboolean | ТребованиеНеобязательно | Значения и ограничения false | По умолчанию— |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt |
Параметрoptional | Контрактsize, user_id, quality, watermark_enabled, stream |
Параметр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.09 оценка до генерации 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": "cogview-4", "prompt": "A calm studio product photograph with a plain background."}')
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 cogview-4
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · Zhipu: CogView 4
- Какие входные данные и результаты доступны?
POST /v1/images/generations·cogview-4:text→image- Какие поля использует запрос?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream