Playground Images

Images — третья вкладка Playground рядом с Request builder и Model Verification. Выберите доступный ключ, проверенные модель и маршрут, затем Generate или Edit. Для Generate нужен промпт; Edit принимает упорядоченные исходные изображения и поддерживаемую необязательную маску. Показываются только настройки выбранного маршрута. Если ключ или предложение недоступны, следуйте сообщению либо обратитесь в поддержку; не отправляйте запрос через другой домен API.

Перед Send проверьте цену. Известная точная цена в USD может быть установлена как максимум для этого запроса. Цена по токенному тарифу без usage неизвестна: подтверждение не делает работу бесплатной, не устанавливает гарантированный приблизительный предел и не резервирует средства. Сумма для Usage Limit отличается от стоимости для кошелька. Подтверждённая цена связана с маршрутом, контрактом и действующим ценовым контекстом; изменившуюся цену требуется обновить до допуска запроса. Проверки файлов в клиенте не заменяют серверное декодирование и ограничения.

Страница никогда не получает постоянный секрет ключа. Её временное разрешение Images имеет узкое назначение: чтение, одно зафиксированное создание либо один повтор скачивания сохранённой операции. Обычные браузерные ключи по-прежнему не подходят для длительных async/Batch. Принятая работа Images может продолжаться после истечения короткого разрешения, но перед началом обработки сеанс, ключ и права должны оставаться действительными. Отзыв сеанса не отменяет уже отправленную платную работу.

Send создаёт одно намерение. Защита от двойного нажатия, опрос только для чтения и обновление страницы не отправляют новую генерацию. При потере HTTP-ответа проверьте сохранённую отправку с тем же намерением. Явный повтор в ещё открытой странице может отправить только те же сериализованные байты и Idempotency-Key. Перезагрузка сохраняет указатель с областью доступа, а не тело, файлы, промпт или токены, поэтому выполняет только поиск. Страница открывает пустую форму, а не завершённую историю. Выбор записи истории не блокирует форму. Используйте New request над настройками для очистки черновика; кнопка ничего не запускает и не удаляет прежние операции. Известная прежняя операция может оставаться в истории, пока вы намеренно готовите другую работу. Это не повтор платной операции с неизвестным результатом: сначала исследуйте её, не создавая дубликат.

История и файлы используют текущие права того же ключа и исполнителя. Чтение завершённой работы не требует положительного баланса, но требует прав. Preview и Download проверяют размер, тип и контрольную сумму закрытого файла. При сбое получения возможен только повтор скачивания, без новой генерации или учёта. Файлы истекают по 24-часовому правилу; сохранённые метаданные и идемпотентность остаются. accounting_recorded означает готовность к расчёту, а не доказательство списания с кошелька.

См. состояния операций и хранение, бесплатный расчёт цены, генерацию и редактирование. Инструмент Responses image_generation в Request builder — отдельная синхронная возможность, а не новый долговременный процесс Images.

Пустой каталог или недоступная модель

Проверьте, что выбранный ключ активен и ему разрешены запрошенные модель и операция. Обновите доступные предложения или выберите другую поддерживаемую модель. Сам значок поддержки изображений не гарантирует доступность предложения генерации или редактирования. Если каталог остаётся пустым, обратитесь в поддержку с названием модели и операции, не передавая API-ключ. Не меняйте домены API и не используйте чужие ключи для обхода проблемы.

Исходный запрос, cURL и исходный ответ

Используйте три вкладки в Request and response для просмотра своей операции. Raw request показывает полный эндпоинт API, безопасную подстановку Authorization, ключ намерения и JSON генерации. До запуска это черновик. После запуска он описывает подготовленный запрос; копирование никогда не отправляет его повторно.

Для редактирования текстовое представление — сводка полей и файлов multipart, а не JSON-тело. Save exact request body сохраняет исходные байты multipart как images-request-body.bin. Вкладка cURL затем использует этот файл с теми же boundary и Idempotency-Key. В черновых примерах используются локальные пути исходных изображений и маски, которые нужно указать самостоятельно. Эндпоинт использует текущий домен сервиса, в том числе собственный; не заменяйте его хостом другого сервиса.

В своей оболочке задайте MODEL_API_KEY с тем же ключом и исполнителем, что выбраны в Playground. Браузерное разрешение намеренно отсутствует в примере. Для неотправленного черновика также требуется IMAGES_IDEMPOTENCY_KEY, назначенный один раз и сохранённый. Выполнение cURL может тарифицироваться; копирование — нет. Смена ключа, исполнителя или намерения не является повтором старой операции. Не отправляйте запрос автоматически повторно после неопределённого результата.

Raw response позволяет выбрать ответ отправки, последний статус, результат поиска, повтор скачивания либо явно прочитанный сохранённый результат. Он показывает HTTP-метаданные и исходное UTF-8-тело, включая ошибки и пробелы. Чтение сохранённого результата не является генерацией. Текстовый просмотр сокращается после 128КиБ; Copy или Save содержат полный захваченный ответ до 64МиБ. Прерванные, слишком большие или некорректные UTF-8-ответы помечаются незавершёнными, а не предлагаются как полный результат.

Необработанные данные остаются только в открытой вкладке. Смена ключа очищает их; перезагрузка не восстанавливает исходный запрос по истории. Сохранённые файлы и буфер обмена могут содержать частные промпты или результаты: не публикуйте их. Браузер может блокировать буфер обмена; выделите текст вручную или используйте Save.

Расчёт цены и суммы для Usage Limit — предварительные значения. Вычисленная стоимость также отличается от завершённого изменения баланса. Доступность сохранённых файлов требует существующего файла и неистёкшего окна скачивания. Общие количества токенов могут появляться в reported_tokens с token_usage_status=aggregate_only_not_priced; они не заменяют отсутствующую разбивку по модальностям для токенной тарификации. См. поля ответа генерации.

Автоматический предпросмотр и прогресс операции

Готовые изображения загружаются автоматически из сохранённого закрытого результата с проверкой, не более двух файлов одновременно. Дополнительное нажатие Preview не требуется. При ошибке загрузки Preview остаётся способом ручного повтора. Обновление статуса не скачивает то же изображение многократно; недоступный, повреждённый или просроченный результат не заменяется и не генерируется заново.

Launch открывает окно прогресса с наблюдаемыми этапами подготовки, отправки, очереди, работы поставщика и сохранённого результата, а также прошедшим временем. Процент выполнения у поставщика ему неизвестен. Close/Escape только скрывает окно, Show progress открывает его снова без отправки. После загрузки результата окно закрывается автоматически. Просмотр истории сам по себе не прерывается модальным окном.

Учёт различает зафиксированные входные данные расчёта и наблюдаемое завершённое списание с его временной отметкой. Awaiting settlement, временная недоступность и отсутствие сохранённых данных не означают нулевую стоимость. Рассчитанная стоимость может показываться после учёта как для фиксированного тарифа за изображение, так и для тарифа по измеряемому объёму. Статус расчёта обновляется без повторной загрузки предпросмотра или новой генерации; Refresh остаётся после завершения ограниченного фонового опроса.

HTTP-статус поставщика, если он есть, описывает сохранённый ответ поставщика. HTTP202 в Raw response на создание лишь подтверждает приём операции, а не успех или сбой поставщика. Исследуйте outcome_unknown, вместо смены намерения для принудительного нового платного запроса.

Когда запуск недоступен

Пояснение рядом с Launch указывает неполные настройки, проверку файлов, ожидание расчёта цены или подтверждения неизвестной стоимости. После изменения допустимых параметров цена рассчитывается автоматически; только отдельное явное нажатие Launch создаёт операцию с изображением.

История по вашим ключам

История показывает ваши операции по ключам, которые доступны вам сейчас. Используйте Filter history by key для фильтрации и Older operations для следующей страницы. Выбор прежнего результата не меняет ключ или черновик нового запроса. Просроченные результаты могут оставаться в истории, но скачать их повторно из хранилища с истёкшим сроком нельзя. Отозванный или недоступный ключ не получает новых прав через историю.

Для промпта может действовать ограничение числа символов конкретного маршрута. Если дополнительный предел не задан, ограничения размера запроса всё равно действуют; длинный текст никогда не обрезается незаметно. Поставщик может устанавливать собственные ограничения. Изменение входных данных требует новой проверки цены перед явным запуском.

Промпт и краткие сведения об операции

Счётчик промпта показывает prompt_max_chars и текущее число символов Unicode. Числовой предел ограничивает ввод, вставку и завершённый ввод через редактор композиции, не разрывая emoji; null убирает только дополнительное ограничение символов. Готовый черновик при переходе на более строгий маршрут сохраняется, а точная причина блокировки показывается. Audio prompt_max_chars0 отключает необязательный контекст. Рядом с недоступным запуском всегда есть причина. Сведения об учёте читает полное разрешённое представление учёта; краткие ответы о состоянии не содержат этих полей и не заявляют нулевую стоимость или завершённый расчёт. Сгенерированные запросы сохраняют привязку quote/route/idempotency, но не отправляют max_cost_usd.

Получить результат · Raw / cURL

После запуска или выбора операции в истории откройте Получить результат · Raw / cURL сразу после Запрос и ответ в колонке результата. История операций — последний блок на всю ширину рабочей области под формой и результатами. Выберите Статус операции, Сохранённый результат (JSON) либо доступный Файл изображения. Каждая команда изображения использует собственный индекс файла, начиная с нуля, и имя с расширением по MIME-типу. Записи изображений появляются только после получения дескрипторов файлов.

Показанный Operation key ID относится к выбранной записи истории, а не обязательно к ключу новой формы. Используйте разрешённый ключ этой операции и исходную учётную запись исполнителя. Копирование не передаёт доступ другому ключу или аккаунту. Для этого профиля источник API — https://api.model-gate.com либо настроенный API текущего домена. Резервного переключения на другой профиль нет.

Блок Raw содержит GET-эндпоинт без тела и безопасный заполнитель Authorization. Блок cURL использует локально заданный MODEL_API_KEY и сохраняет ответ в файл. Токены браузера и секреты ключей не копируются. В командах нет тела создания, Content-Type, Idempotency-Key, quote или ограничения стоимости. Копировать Raw и Копировать cURL только копируют текст; выбор команды не начинает скачивание или новую работу.

Это сгенерированные примеры нового чтения, не исходный журнал запроса. Команда может показываться для ожидающего задания и не доказывает наличие результата. Сначала проверьте статус; ответы о недоступности, истечении срока или запрете доступа обрабатывайте как ошибки, а не медиа. --fail-with-body может записать HTTP-ошибку в выходной файл; проверьте код завершения перед его открытием. Ошибка чтения не разрешает повторное платное создание. Полные примеры приведены в API результата.