Zhipu: CogView 4 250304

CogView 4 250304 — отдельно названный вариант CogView 4 с селектором cogview-4-250304 для создания изображений по тексту. Используйте его, когда процессу нужна именно эта модель: с текстовым заданием сцены, размерами CogView, настройками качества и водяного знака. Он возвращает URL изображений в синхронном ответе генерации изображений.

Ailoot Ultra · Images POST /v1/images/generations cogview-4-250304

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

CogView 4 250304 — именованная модель Zhipu cogview-4-250304 из семейства генерации изображений CogView. Используйте полный селектор, если в творческом процессе нужно сохранить именно эту редакцию. Её метод Ailoot Ultra — POST /v1/images/generations, где обязательные строковые поля — 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 символов для идентификатора конечного пользователя. Сохраняйте выбранные настройки качества и водяного знака вместе с результатом, особенно при сборе нескольких кандидатов для одной дизайнерской задачи.

Запрос изображения завершается синхронно с created и массивом data, элементы которого содержат url. Сохраняйте каждое фактически возвращённое изображение и полный ответ. Набор возвращённых 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-250304

cogview-4-250304

ZHIPU /cogview-4-250304

Начало

Допустимые входные данные: Текст
Результаты: Картинки

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Images POST /v1/images/generations

Входные данные: text
Результат: image
Выходной формат: Файл изображения

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения cogview-4-250304	По умолчанию—
Поле`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

curl · создать один раз и сохранить полный результат

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-250304", "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/assets
GET /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-250304

Псевдонимы путей метода

Используйте пути методов, указанные выше.

Связанные ID для вызова

cogview-4-250304

FAQ · Zhipu: CogView 4 250304

Какие входные данные и результаты доступны?: POST /v1/images/generations · cogview-4-250304: text → image
Какие поля использует запрос?: POST /v1/images/generations · cogview-4-250304: model, prompt, size, user_id, quality, watermark_enabled, stream

Zhipu: CogView 4 250304