image tools

Generates images with an image model and stores them as files.

Generates images with an image model and stores them as files. The call’s input takes prompt, images (refs to edit or reference), aspect_ratio, size, count and path; the result lists the images under images, each with a ref. Shipped as builtin__generate_image.

These fields go alongside the common fields, with kind: image.

Fields

model · string · default: "image"

An image model role. A chat or decision role fails the call.

caller_model · boolean · default: "false"

Let the call’s model input pick the role.

Example

version: 3
name: hero_art
description: Draws a hero image for a landing page from a short brief.
kind: image
model: image
input_schema:
  type: object
  required:
  - prompt
  properties:
    prompt:
      type: string
      description: What to draw