Reference Group Tools

Tools for saving and reusing sets of reference images.

Overview

Reference groups let you bundle multiple existing Go Bananas images into a named set. You can then reuse that set in generate_image via reference_group_id(s) or reference_group_name, optionally choosing a reference_mode:

• style: match colors/aesthetic from the group.
• add: include elements from the group in the new composition.

---

create_reference_group

Create a new reference group.

Parameters

Parameter	Type	Required	Description
group_name	string	Yes	Unique group name (1–100 chars)
description	string	No	Optional notes (max 500 chars)
reference_image_ids	number[]	Yes	Image IDs to include (1–20)

Example

{
  "tool": "create_reference_group",
  "params": {
    "group_name": "Brand Style",
    "description": "Primary product shots + color palette",
    "reference_image_ids": [101, 102, 110]
  }
}

---

list_reference_groups

List saved groups for the tenant.

Parameters

Parameter	Type	Required	Description
search	string	No	Filter by name/description
limit	number	No	Max results (default 50, max 100)
offset	number	No	Pagination offset
sort_by	string	No	name, created, used, or recent

Example

{ "tool": "list_reference_groups", "params": { "search": "brand" } }

---

get_reference_group

Fetch full details for a single group.

Parameters

Provide either group_id or group_name.

Parameter	Type	Required	Description
group_id	number	No	Group ID to retrieve
group_name	string	No	Group name to retrieve

---

update_reference_group

Update a group’s name, description, or images.

Parameters

Provide group_id or group_name, plus at least one field to change.

Parameter	Type	Required	Description
group_id	number	No	Group ID to update
group_name	string	No	Group name to update
new_group_name	string	No	Rename the group
description	string | null	No	New description (null clears)
reference_image_ids	number[]	No	Replace images (1–20)

---

delete_reference_group

Delete a reference group (images remain in your library).

Parameters

Provide either group_id or group_name.

Parameter	Type	Required	Description
group_id	number	No	Group ID to delete
group_name	string	No	Group name to delete