make_shape_collage
Builds a photo collage in the shape of a heart, a number (age, anniversary, year), a word, a star, a flower and more from the user's photos, and returns a watermarked preview within seconds. Use when the user asks for a heart collage, a birthday/anniversary number collage, a 'photo collage in the shape of ...', or a collage from several photos. Pass the photos as public links in photo urls, or as files the user attached (photos). 1 to 300 photos; if there are fewer photos than cells, photos repeat. The result id (clg ...) is a private handle valid for 30 days; photos and results are deleted af
Показать схему аргументов
{
"type": "object",
"required": [
"shape"
],
"properties": {
"shape": {
"type": "object",
"required": [
"type"
],
"properties": {
"n": {
"type": "integer",
"maximum": 12,
"minimum": 2,
"description": "grid: n x n."
},
"url": {
"type": "string",
"description": "mask_url: link to a black-and-white picture; each black pixel is one photo cell."
},
"size": {
"enum": [
"small",
"medium",
"large"
],
"type": "string",
"description": "number/text/circle/star/flower: how many cells (bigger = more photos)."
},
"text": {
"type": "string",
"maxLength": 14,
"description": "number/text: the digits or word (Latin letters and digits)."
},
"type": {
"enum": [
"heart",
"number",
"text",
"love",
"circle",
"star",
"flower",
"daisy",
"yinyang",
"grid",
"mask_url"
],
"type": "string"
},
"cells": {
"enum": [
27,
34,
70,
79,
91,
164
],
"type": "integer",
"description": "Heart only: number of photo cells."
}
},
"description": "The figure. Examples: {\"type\":\"heart\"} (size picked from the photo count), {\"type\":\"heart\",\"cells\":70}, {\"type\":\"number\",\"text\":\"30\"}, {\"type\":\"text\",\"text\":\"LOVE\"}, {\"type\":\"love\"} (\"I love you\"), {\"type\":\"star\",\"size\":\"large\"}, {\"type\":\"grid\",\"n\":4}. Call list_collage_shapes for all options."
},
"photos": {
"type": "array",
"items": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"download_url": {
"type": "string"
}
}
},
"maxItems": 300,
"description": "Photos the user attached in the chat."
},
"gap_pct": {
"type": "number",
"maximum": 40,
"minimum": 0,
"description": "White gap between photos, % of a cell (default 6)."
},
"background": {
"type": "string",
"description": "Background colour: white (default), cream, pink, black or #rrggbb."
},
"photo_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 300,
"description": "Public http(s) links to the photos (JPEG/PNG/WEBP)."
}
},
"additionalProperties": false
}