create_image

Make AI images from the user's prompt with a chosen MakeViral Create model, from text or from the user's photos (edit a photo, put a person in a new scene, combine photos). It spends credits from the user's MakeViral account (a failed image gives them back) and usually returns the finished image link in this call. Before calling: 1) pick the model (get_model gives its sizes and prices), 2) tell the user the price in credits, 3) when photos are used, ask the user to confirm the people in them are them or agreed, and that no one is a child. Photos: pass the files the user attached in this chat as `photos`, or public image links as `photoUrls`. Never use photos of a public figure or of someone who did not agree. Calling again with the same input within 10 minutes returns the first result; pass a new requestId to make more.

destructive

Argument	Type	Description
count	integer	How many images (each one is charged). Default 1.
model*	string	Image model id (list_models). nano-banana-2 is a good default.
aspect	string	Shape. Default 9:16 (vertical, for TikTok and Reels).
photos	array	The user's photos attached in the chat (references to edit or follow)
prompt*	string	What the image shows, in the user's words, made clear and specific
photoUrls	array	Public https links to photos (JPEG, PNG or WebP)
requestId	string	Optional id (8-64 letters, digits, - or _). The same id never charges twice.
resolution	string	Size. Default: the model's smallest (1K).
photosConsent	boolean	Needed with photos: true only after the user confirmed everyone in them is the user or agreed, and no one is a child
transparentBackground	boolean	GPT Image only, text only: a transparent background

Input schema (JSON)

{
  "type": "object",
  "required": [
    "model",
    "prompt"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "maximum": 4,
      "minimum": 1,
      "description": "How many images (each one is charged). Default 1."
    },
    "model": {
      "enum": [
        "nano-banana-pro",
        "nano-banana-2-1",
        "nano-banana-2",
        "gpt-image-2-5",
        "seedream-5-pro",
        "flux-2-pro",
        "z-image"
      ],
      "type": "string",
      "description": "Image model id (list_models). nano-banana-2 is a good default."
    },
    "aspect": {
      "enum": [
        "9:16",
        "16:9",
        "1:1",
        "4:3",
        "3:4",
        "4:5",
        "3:2",
        "2:3",
        "21:9",
        "5:4"
      ],
      "type": "string",
      "description": "Shape. Default 9:16 (vertical, for TikTok and Reels)."
    },
    "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",
            "description": "Temporary link to the file"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 10,
      "description": "The user's photos attached in the chat (references to edit or follow)"
    },
    "prompt": {
      "type": "string",
      "description": "What the image shows, in the user's words, made clear and specific"
    },
    "photoUrls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "description": "Public https links to photos (JPEG, PNG or WebP)"
    },
    "requestId": {
      "type": "string",
      "description": "Optional id (8-64 letters, digits, - or _). The same id never charges twice."
    },
    "resolution": {
      "enum": [
        "1K",
        "2K",
        "4K"
      ],
      "type": "string",
      "description": "Size. Default: the model's smallest (1K)."
    },
    "photosConsent": {
      "type": "boolean",
      "description": "Needed with photos: true only after the user confirmed everyone in them is the user or agreed, and no one is a child"
    },
    "transparentBackground": {
      "type": "boolean",
      "description": "GPT Image only, text only: a transparent background"
    }
  },
  "additionalProperties": false
}

create_upload_link

Make a one-hour link where the user adds the photos for a template on makeviral.ai (on any device). Use it when the user cannot attach photos in this chat. Give the user the link, wait until they say they are done, then call run_template with the returned uploadId.

Argument	Type	Description
version	string	Version id. Default 'main'.
template*	string	Template slug

Input schema (JSON)

{
  "type": "object",
  "required": [
    "template"
  ],
  "properties": {
    "version": {
      "type": "string",
      "description": "Version id. Default 'main'."
    },
    "template": {
      "type": "string",
      "description": "Template slug"
    }
  },
  "additionalProperties": false
}

create_video

Make an AI video from the user's prompt with a chosen MakeViral Create model (Seedance, Kling, Veo, Wan, Grok Imagine, MiniMax...): from text, from a start frame photo (and an end frame on some models), or from references (photos, clips and sounds), with Kling multi-shot and elements. It spends credits from the user's MakeViral account (a failed video gives them back). A video takes a few minutes: this call returns at once, then call get_creation with wait true until it is ready and give the user the link. Before calling: 1) pick the model and check what it takes with get_model, 2) tell the user the price in credits, 3) with photos or clips, ask the user to confirm the people in them are them or agreed, and that no one is a child. Files: pass files the user attached in this chat (startFrame, endFrame, referencePhotos, referenceSounds), or public https links in the *Url fields. Clips must be links (MP4 or MOV). Never use photos of a public figure or of someone who did not agree. Calling again with the same input within 10 minutes returns the first video; pass a new requestId to make another.

destructive

Argument	Type	Description
seed	integer	Wan only: repeat a result
count	integer	How many videos (each one is charged). Default 1.
model*	string	Video model id (list_models). seedance-2-5 is a good default.
shots	array	Kling multi-shot: each shot's prompt and length; they add up to the video length
sound	boolean

get_account

Show the signed-in MakeViral account: its first name and credit balance. Every run uses credits, so use it before a run when the price might be more than the balance.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_creation

Check images or videos started with create_image or create_video: status, minutes left, and the finished link when ready. With wait true the call waits up to 40 seconds for them to finish, so you can wait for the result in the same answer and then give the user the link.

read-only

Argument	Type	Description
id	string	One id (instead of ids)
ids	array	Ids from create_image or create_video, e.g. 'vid_...'
wait	boolean	Wait up to 40 seconds for them to finish. Default false.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "One id (instead of ids)"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 4,
      "minItems": 1,
      "description": "Ids from create_image or create_video, e.g. 'vid_...'"
    },
    "wait": {
      "type": "boolean",
      "description": "Wait up to 40 seconds for them to finish. Default false."
    }
  },
  "additionalProperties": false
}

get_model

Show one MakeViral Create model: the shapes, sizes and lengths it makes, the photos, clips and sounds it takes, special inputs (end frame, multi-shot, elements, motion style), and the price in credits for every size and length. With resolution, durationSec and count it also gives the exact price of that choice, so you can tell the user before create_image or create_video.

read-only

Argument	Type	Description
count	integer	Optional, how many to price
model*	string	Model id from list_models
resolution	string	Optional, to price one choice: e.g. '2K' (image) or '720p' (video)
clipSeconds	number	Optional, seconds of a reference clip (they add to the price)
durationSec	integer	Optional, video length to price
referencePhotos	integer	Optional, video reference photos (one model charges for more than 5)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "model"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "maximum": 4,
      "minimum": 1,
      "description": "Optional, how many to price"
    },
    "model": {
      "enum": [
        "nano-banana-pro",
        "nano-banana-2-1",
        "nano-banana-2",
        "gpt-image-2-5",
        "seedream-5-pro",
        "flux-2-pro",
        "z-image",
        "seedance-2-5",
        "kling-3-pro",
        "kling-3-omni",
        "veo-3-1-fast",
        "wan-3",
        "minimax-h3",
        "seedance-2",
        "veo-3-1-quality",
        "veo-3-1-lite",
        "seedance-2-fast",
        "grok-imagine",
        "seedance-2-mini"
      ],
      "type": "string",
      "description": "Model id from list_models"
    },
    "resolution": {
      "type": "string",
      "description": "Optional, to price one choice: e.g. '2K' (image) or '720p' (video)"
    },
    "clipSeconds": {
      "type": "number",
      "maximum": 120,
      "minimum": 0,
      "description": "Optional, seconds of a reference clip (they add to the price)"
    },
    "durationSec": {
      "type": "integer",
      "maximum": 60,
      "minimum": 1,
      "description": "Optional, video length to price"
    },
    "referencePhotos": {
      "type": "integer",
      "maximum": 20,
      "minimum": 0,
      "description": "Optional, video reference photos (one model charges for more than 5)"
    }
  },
  "additionalProperties": false
}

get_run

Check a MakeViral run started with run_template: its status, minutes left, and the finished video or photo link when it is ready. With wait true the call waits up to 40 seconds for the run to finish, so you can wait for the result in the same answer and then give the user the link.

read-only

Argument	Type	Description
wait	boolean	Wait up to 40 seconds for the run to finish before answering. Default false.
runId*	string	The run id from run_template, e.g. 'tr_ag...'

Input schema (JSON)

{
  "type": "object",
  "required": [
    "runId"
  ],
  "properties": {
    "wait": {
      "type": "boolean",
      "description": "Wait up to 40 seconds for the run to finish before answering. Default false."
    },
    "runId": {
      "type": "string",
      "description": "The run id from run_template, e.g. 'tr_ag...'"
    }
  },
  "additionalProperties": false
}

get_template

Show one MakeViral template: what it makes, its versions (for example solo, with a friend, with a pet), the photos each version needs in order, quality options, optional 'make it yours' fields, the price in credits, the user's credit balance when signed in, and an example clip. Use it when the user names or picks one template. Call it before run_template so you pass the right version and photos, and tell the user the price in credits.

read-only

Argument	Type	Description
slug*	string	Template slug from search_templates, e.g. 'knight-cat-ai-video'

Input schema (JSON)

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Template slug from search_templates, e.g. 'knight-cat-ai-video'"
    }
  },
  "additionalProperties": false
}

list_creations

List the user's latest MakeViral Create images and videos (newest first) with their status and links. Template runs are in list_runs.

read-only

Argument	Type	Description
kind	string
limit	integer

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "kind": {
      "enum": [
        "image",
        "video"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

list_models

List the AI models of MakeViral Create (makeviral.ai/create): image models (Nano Banana, GPT Image, Seedream, Flux...) and video models (Seedance, Kling, Veo, Wan, Grok Imagine, MiniMax...) with what each takes and its lowest price in MakeViral credits. Use it when the user asks MakeViral for an image or a video from their own idea (not a trend template), wants a specific model such as Kling, Veo or Seedance, or asks which MakeViral model to use. Then use get_model for one model's full rules and prices, and create_image or create_video to make it.

read-only

Argument	Type	Description
kind	string	Only image models or only video models

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "kind": {
      "enum": [
        "image",
        "video"
      ],
      "type": "string",
      "description": "Only image models or only video models"
    }
  },
  "additionalProperties": false
}

list_runs

List the user's latest MakeViral template runs (newest first) with their status and result links.

read-only

Argument	Type	Description
limit	integer

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

run_template

Make a MakeViral trend video or photo from the user's photos. It spends the version's credits from the user's MakeViral account (a failed run gives them all back). A photo is usually ready in this call and the result has the link. A video takes a few minutes: then call get_run with wait true until it is ready, and give the user the link. Before calling: 1) pick the template and version with get_template, 2) tell the user the price in credits, 3) ask for exactly the photos that version needs, in its order, 4) ask the user to confirm the people in the photos are them or people who agreed, and that no one in them is a child. Photos: pass the files the user attached in this chat as `photos`, OR public image links as `photoUrls`, OR an `uploadId` from create_upload_link when the user cannot attach files here. Never use photos of a public figure or of someone who did not agree.

destructive

Argument	Type	Description
fields	object	Optional 'make it yours' values by field id (get_template lists them)
object	object	Knight sword swap only: the object one knight hands the other
photos	array	The user's photos attached in the chat, in the version's photo order
quality	string	Quality option id from get_template. Default: the template's default option (listed first).
version	string	Version id from get_template. Default 'main'.
template

search_templates

Find MakeViral trend templates: viral AI video and photo trends (knight cat, hotel lobby walk, Halloween costumes, dance reels...) that turn the user's own photos of themselves, their partner, friends or pets into a short video or photo. Use it when the user wants a trend video, asks what they can make from a photo, or names a TikTok or Instagram trend. Results are sorted by popularity and show an example clip, the photos needed and the price in MakeViral credits. With no query it returns the most popular templates. Suggest a few that fit and say that each one costs credits from the user's MakeViral account, then use get_template when the user picks one.

read-only

Argument	Type	Description
limit	integer
query	string	Words for the trend or idea, e.g. 'knight cat', 'halloween couple', 'dance'
output	string
season	string	e.g. 'halloween'
subject	string	Who or what is in the photos (product = a brand ad from a product photo and a logo)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 8,
      "maximum": 30,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Words for the trend or idea, e.g. 'knight cat', 'halloween couple', 'dance'"
    },
    "output": {
      "enum": [
        "photo",
        "video"
      ],
      "type": "string"
    },
    "season": {
      "type": "string",
      "description": "e.g. 'halloween'"
    },
    "subject": {
      "enum": [
        "person",
        "pet",
        "couple",
        "group",
        "product"
      ],
      "type": "string",
      "description": "Who or what is in the photos (product = a brand ad from a product photo and a logo)"
    }
  },
  "additionalProperties": false
}

suggest_template

Send MakeViral a trend or idea that has no template yet, so the team can add it. Use it when search_templates finds nothing that fits what the user wants, and only after the user agrees. Include the TikTok or Instagram link of the trend when the user has one.

Argument	Type	Description
idea*	string	The trend or idea in one or two sentences
link	string	Optional https link to an example of the trend

Input schema (JSON)

{
  "type": "object",
  "required": [
    "idea"
  ],
  "properties": {
    "idea": {
      "type": "string",
      "description": "The trend or idea in one or two sentences"
    },
    "link": {
      "type": "string",
      "description": "Optional https link to an example of the trend"
    }
  },
  "additionalProperties": false
}

MakeViral

Try it

create_image Destructive

MakeViral

Try it

create_image Destructive

Tools (14)