MakeViral
Find the newest viral AI video trend templates and make them from your photos or a prompt.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"makeviral": {
"url": "https://www.makeviral.ai/mcp"
}
}
}远程端点
https://www.makeviral.ai/mcpstreamable-http它能做什么
工具清单
工具（14）
🟢search_templates(query, subject, output, season, limit)
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.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Words for the trend or idea, e.g. 'knight cat', 'halloween couple', 'dance'"
},
"subject": {
"type": "string",
"enum": [
"person",
"pet",
"couple",
"group",
"product"
],
"description": "Who or what is in the photos (product = a brand ad from a product photo and a logo)"
},
"output": {
"type": "string",
"enum": [
"photo",
"video"
]
},
"season": {
"type": "string",
"description": "e.g. 'halloween'"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"default": 8
}
},
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"templates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"summary": {
"type": "string"
},
"alsoKnownAs": {
"type": "array",
"items": {
"type": "string"
}
},
"fromCredits": {
"type": "number"
},
"outputs": {
"type": "array",
"items": {
"type": "string"
}
},
"subjects": {
"type": "array",
"items": {
"type": "string"
}
},
"pageUrl": {
"type": "string"
},
"versions": {
"type": "array",
"items": {
"type": "object"
}
}
},
"required": [
"slug",
"name"
]
}
},
"account": {
"type": "object",
"properties": {
"credits": {
"type": "number"
}
},
"required": [
"credits"
]
}
},
"required": [
"templates"
]
}🟢get_template(slug)
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.
输入模式
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Template slug from search_templates, e.g. 'knight-cat-ai-video'"
}
},
"required": [
"slug"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"template": {
"type": "object"
},
"account": {
"type": "object",
"properties": {
"credits": {
"type": "number"
}
},
"required": [
"credits"
]
}
},
"required": [
"template"
]
}🔴run_template(template, version, quality, photos, photoUrls, ...)
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.
输入模式
{
"type": "object",
"properties": {
"template": {
"type": "string",
"description": "Template slug, e.g. 'knight-cat-ai-video'"
},
"version": {
"type": "string",
"description": "Version id from get_template. Default 'main'."
},
"quality": {
"type": "string",
"description": "Quality option id from get_template. Default: the template's default option (listed first)."
},
"photos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary link to the file"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"additionalProperties": false
},
"maxItems": 4,
"description": "The user's photos attached in the chat, in the version's photo order"
},
"photoUrls": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 4,
"description": "Public https links to the photos (JPEG, PNG or WebP), in the version's photo order"
},
"uploadId": {
"type": "string",
"description": "The id from create_upload_link, after the user added the photos there"
},
"fields": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"id",
"value"
],
"additionalProperties": false
},
"description": "Optional 'make it yours' values: one { id, value } per field id that get_template lists"
},
"object": {
"type": "object",
"properties": {
"pick": {
"type": "string"
},
"text": {
"type": "string",
"maxLength": 60
}
},
"additionalProperties": false,
"description": "Knight sword swap only: the object one knight hands the other"
},
"photosConsent": {
"type": "boolean",
"description": "true only after the user confirmed that everyone in the photos is the user or agreed to it, and that no one is a child"
},
"requestId": {
"type": "string",
"description": "Optional id (8-64 letters, digits, - or _). The same id never charges twice. Without it, the same request within 10 minutes returns the first run; pass a new id to make it again with the same photos."
}
},
"required": [
"template",
"photosConsent"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"run": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"processing",
"completed",
"failed"
]
},
"template": {
"type": "string"
},
"version": {
"type": "string"
},
"name": {
"type": "string"
},
"output": {
"type": "string",
"enum": [
"photo",
"video"
]
},
"resultUrl": {
"type": "string"
},
"saveUrl": {
"type": "string"
},
"previewUrl": {
"type": "string"
},
"silentVideoUrl": {
"type": "string"
},
"creditsCharged": {
"type": "number"
},
"creditsRefunded": {
"type": "number"
},
"error": {
"type": "string"
},
"etaMinutes": {
"type": "number"
},
"appUrl": {
"type": "string"
}
},
"required": [
"id",
"status",
"template",
"name",
"output"
]
}
},
"required": [
"run"
]
}🟢get_run(runId, wait)
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.
输入模式
{
"type": "object",
"properties": {
"runId": {
"type": "string",
"description": "The run id from run_template, e.g. 'tr_ag...'"
},
"wait": {
"type": "boolean",
"description": "Wait up to 40 seconds for the run to finish before answering. Default false."
}
},
"required": [
"runId"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"run": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"processing",
"completed",
"failed"
]
},
"template": {
"type": "string"
},
"version": {
"type": "string"
},
"name": {
"type": "string"
},
"output": {
"type": "string",
"enum": [
"photo",
"video"
]
},
"resultUrl": {
"type": "string"
},
"saveUrl": {
"type": "string"
},
"previewUrl": {
"type": "string"
},
"silentVideoUrl": {
"type": "string"
},
"creditsCharged": {
"type": "number"
},
"creditsRefunded": {
"type": "number"
},
"error": {
"type": "string"
},
"etaMinutes": {
"type": "number"
},
"appUrl": {
"type": "string"
}
},
"required": [
"id",
"status",
"template",
"name",
"output"
]
}
},
"required": [
"run"
]
}🟢list_runs(limit)
List the user's latest MakeViral template runs (newest first) with their status and result links.
输入模式
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10
}
},
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"runs": {
"type": "array",
"items": {
"type": "object"
}
}
},
"required": [
"runs"
]
}🟢list_models(kind)
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.
输入模式
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"image",
"video"
],
"description": "Only image models or only video models"
}
},
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"models": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"image",
"video"
]
},
"name": {
"type": "string"
},
"maker": {
"type": "string"
},
"summary": {
"type": "string"
},
"fromCredits": {
"type": "number"
}
},
"required": [
"id",
"kind",
"name",
"fromCredits"
]
}
},
"account": {
"type": "object",
"properties": {
"credits": {
"type": "number"
}
},
"required": [
"credits"
]
}
},
"required": [
"models"
]
}🟢get_model(model, resolution, durationSec, count, referencePhotos, ...)
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.
输入模式
{
"type": "object",
"properties": {
"model": {
"type": "string",
"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"
],
"description": "Model id from list_models"
},
"resolution": {
"type": "string",
"description": "Optional, to price one choice: e.g. '2K' (image) or '720p' (video)"
},
"durationSec": {
"type": "integer",
"minimum": 1,
"maximum": 60,
"description": "Optional, video length to price"
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 4,
"description": "Optional, how many to price"
},
"referencePhotos": {
"type": "integer",
"minimum": 0,
"maximum": 20,
"description": "Optional, video reference photos (one model charges for more than 5)"
},
"clipSeconds": {
"type": "number",
"minimum": 0,
"maximum": 120,
"description": "Optional, seconds of a reference clip (they add to the price)"
}
},
"required": [
"model"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"model": {
"type": "object"
},
"prices": {
"type": "array",
"items": {
"type": "object"
}
},
"quote": {
"type": "object",
"properties": {
"credits": {
"type": "number"
}
}
},
"account": {
"type": "object",
"properties": {
"credits": {
"type": "number"
}
},
"required": [
"credits"
]
}
},
"required": [
"model",
"prices"
]
}🔴create_image(model, prompt, photos, photoUrls, aspect, ...)
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.
输入模式
{
"type": "object",
"properties": {
"model": {
"type": "string",
"enum": [
"nano-banana-pro",
"nano-banana-2-1",
"nano-banana-2",
"gpt-image-2-5",
"seedream-5-pro",
"flux-2-pro",
"z-image"
],
"description": "Image model id (list_models). nano-banana-2 is a good default."
},
"prompt": {
"type": "string",
"description": "What the image shows, in the user's words, made clear and specific"
},
"photos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary link to the file"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"additionalProperties": false
},
"maxItems": 10,
"description": "The user's photos attached in the chat (references to edit or follow)"
},
"photoUrls": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "Public https links to photos (JPEG, PNG or WebP)"
},
"aspect": {
"type": "string",
"enum": [
"9:16",
"16:9",
"1:1",
"4:3",
"3:4",
"4:5",
"3:2",
"2:3",
"21:9",
"5:4"
],
"description": "Shape. Default 9:16 (vertical, for TikTok and Reels)."
},
"resolution": {
"type": "string",
"enum": [
"1K",
"2K",
"4K"
],
"description": "Size. Default: the model's smallest (1K)."
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 4,
"description": "How many images (each one is charged). Default 1."
},
"transparentBackground": {
"type": "boolean",
"description": "GPT Image only, text only: a transparent background"
},
"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"
},
"requestId": {
"type": "string",
"description": "Optional id (8-64 letters, digits, - or _). The same id never charges twice."
}
},
"required": [
"model",
"prompt"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"creations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"image",
"video"
]
},
"status": {
"type": "string",
"enum": [
"processing",
"completed",
"failed"
]
},
"model": {
"type": "string"
},
"modelName": {
"type": "string"
},
"prompt": {
"type": "string"
},
"url": {
"type": "string"
},
"saveUrl": {
"type": "string"
},
"previewUrl": {
"type": "string"
},
"aspect": {
"type": "string"
},
"resolution": {
"type": "string"
},
"durationSec": {
"type": "number"
},
"sound": {
"type": "boolean"
},
"creditsCharged": {
"type": "number"
},
"creditsRefunded": {
"type": "number"
},
"error": {
"type": "string"
},
"etaMinutes": {
"type": "number"
},
"appUrl": {
"type": "string"
}
},
"required": [
"id",
"kind",
"status",
"model",
"modelName"
]
}
}
},
"required": [
"creations"
]
}🔴create_video(model, prompt, startFrame, startFrameUrl, endFrame, ...)
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.
输入模式
{
"type": "object",
"properties": {
"model": {
"type": "string",
"enum": [
"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"
],
"description": "Video model id (list_models). seedance-2-5 is a good default."
},
"prompt": {
"type": "string",
"description": "What happens in the video. With references, name them as get_model says (e.g. [Image 1])."
},
"startFrame": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary link to the file"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"additionalProperties": false,
"description": "The first frame: a photo the user attached in the chat"
},
"startFrameUrl": {
"type": "string",
"description": "The first frame as a public https photo link"
},
"endFrame": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary link to the file"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"additionalProperties": false,
"description": "The last frame (models with an end frame), with a start frame"
},
"endFrameUrl": {
"type": "string",
"description": "The last frame as a public https photo link"
},
"referencePhotos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary link to the file"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"additionalProperties": false
},
"maxItems": 9,
"description": "Reference photos attached in the chat (people, products, a style). Never with frames."
},
"referencePhotoUrls": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 9,
"description": "Reference photos as public https links"
},
"referenceClips": {
"type": "array",
"items": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary link to the file"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"additionalProperties": false
},
"maxItems": 3,
"description": "Reference clips (MP4 or MOV) as files, where the chat can attach them"
},
"referenceClipUrls": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 3,
"description": "Reference clips as public https links to an MP4 or MOV file"
},
"referenceSounds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary link to the file"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"additionalProperties": false
},
"maxItems": 3,
"description": "Reference sounds (MP3 or WAV) attached in the chat"
},
"referenceSoundUrls": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 3,
"description": "Reference sounds as public https links"
},
"clipMode": {
"type": "string",
"enum": [
"edit",
"reference"
],
"description": "Kling Omni with a clip: 'edit' changes the clip itself (default), 'reference' makes a new video from it"
},
"keepClipSound": {
"type": "boolean",
"description": "With a clip: put the clip's own sound on the result"
},
"shots": {
"type": "array",
"minItems": 2,
"maxItems": 6,
"items": {
"type": "object",
"properties": {
"prompt": {
"type": "string"
},
"durationSec": {
"type": "integer",
"minimum": 1,
"maximum": 15
}
},
"required": [
"prompt",
"durationSec"
],
"additionalProperties": false
},
"description": "Kling multi-shot: each shot's prompt and length; they add up to the video length"
},
"autoShots": {
"type": "boolean",
"description": "Kling Omni: the model plans the shots itself"
},
"elements": {
"type": "array",
"maxItems": 3,
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Lower case, e.g. 'mia'; write @mia in the prompt"
},
"description": {
"type": "string",
"description": "Who or what it is, in a few words"
},
"photoUrls": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 4,
"description": "2-4 public photo links of it"
},
"photoCount": {
"type": "integer",
"minimum": 1,
"maximum": 4,
"description": "How many of elementPhotos belong to it, in order"
}
},
"required": [
"name",
"description"
],
"additionalProperties": false
},
"description": "Kling 3.0 elements: people or things from 2-4 photos each"
},
"elementPhotos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary link to the file"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"additionalProperties": false
},
"maxItems": 12,
"description": "The element photos attached in the chat, element by element in order"
},
"aspect": {
"type": "string",
"enum": [
"9:16",
"3:4",
"1:1",
"4:3",
"16:9",
"21:9",
"2:3",
"3:2"
],
"description": "Shape. Default 9:16 (vertical). With a start frame most models follow the photo's shape."
},
"resolution": {
"type": "string",
"enum": [
"480p",
"720p",
"1080p",
"4k",
"768p",
"2k"
],
"description": "Size. Default: the model's smallest."
},
"durationSec": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"description": "Length in seconds (get_model lists them). Default: the model's default."
},
"sound": {
"type": "boolean",
"description": "Sound on or off where the model has the choice. Default on."
},
"motion": {
"type": "string",
"enum": [
"normal",
"fun"
],
"description": "Grok Imagine only"
},
"webSearch": {
"type": "boolean",
"description": "Seedance, text to video only: look things up online"
},
"seed": {
"type": "integer",
"minimum": 0,
"description": "Wan only: repeat a result"
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 2,
"description": "How many videos (each one is charged). Default 1."
},
"photosConsent": {
"type": "boolean",
"description": "Needed with photos or clips: true only after the user confirmed everyone in them is the user or agreed, and no one is a child"
},
"requestId": {
"type": "string",
"description": "Optional id (8-64 letters, digits, - or _). The same id never charges twice."
}
},
"required": [
"model"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"creations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"image",
"video"
]
},
"status": {
"type": "string",
"enum": [
"processing",
"completed",
"failed"
]
},
"model": {
"type": "string"
},
"modelName": {
"type": "string"
},
"prompt": {
"type": "string"
},
"url": {
"type": "string"
},
"saveUrl": {
"type": "string"
},
"previewUrl": {
"type": "string"
},
"aspect": {
"type": "string"
},
"resolution": {
"type": "string"
},
"durationSec": {
"type": "number"
},
"sound": {
"type": "boolean"
},
"creditsCharged": {
"type": "number"
},
"creditsRefunded": {
"type": "number"
},
"error": {
"type": "string"
},
"etaMinutes": {
"type": "number"
},
"appUrl": {
"type": "string"
}
},
"required": [
"id",
"kind",
"status",
"model",
"modelName"
]
}
}
},
"required": [
"creations"
]
}🟢get_creation(ids, id, wait)
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.
输入模式
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"maxItems": 4,
"description": "Ids from create_image or create_video, e.g. 'vid_...'"
},
"id": {
"type": "string",
"description": "One id (instead of ids)"
},
"wait": {
"type": "boolean",
"description": "Wait up to 40 seconds for them to finish. Default false."
}
},
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"creations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"image",
"video"
]
},
"status": {
"type": "string",
"enum": [
"processing",
"completed",
"failed"
]
},
"model": {
"type": "string"
},
"modelName": {
"type": "string"
},
"prompt": {
"type": "string"
},
"url": {
"type": "string"
},
"saveUrl": {
"type": "string"
},
"previewUrl": {
"type": "string"
},
"aspect": {
"type": "string"
},
"resolution": {
"type": "string"
},
"durationSec": {
"type": "number"
},
"sound": {
"type": "boolean"
},
"creditsCharged": {
"type": "number"
},
"creditsRefunded": {
"type": "number"
},
"error": {
"type": "string"
},
"etaMinutes": {
"type": "number"
},
"appUrl": {
"type": "string"
}
},
"required": [
"id",
"kind",
"status",
"model",
"modelName"
]
}
}
},
"required": [
"creations"
]
}🟢list_creations(limit, kind)
List the user's latest MakeViral Create images and videos (newest first) with their status and links. Template runs are in list_runs.
输入模式
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10
},
"kind": {
"type": "string",
"enum": [
"image",
"video"
]
}
},
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"creations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"image",
"video"
]
},
"status": {
"type": "string",
"enum": [
"processing",
"completed",
"failed"
]
},
"model": {
"type": "string"
},
"modelName": {
"type": "string"
},
"prompt": {
"type": "string"
},
"url": {
"type": "string"
},
"saveUrl": {
"type": "string"
},
"previewUrl": {
"type": "string"
},
"aspect": {
"type": "string"
},
"resolution": {
"type": "string"
},
"durationSec": {
"type": "number"
},
"sound": {
"type": "boolean"
},
"creditsCharged": {
"type": "number"
},
"creditsRefunded": {
"type": "number"
},
"error": {
"type": "string"
},
"etaMinutes": {
"type": "number"
},
"appUrl": {
"type": "string"
}
},
"required": [
"id",
"kind",
"status",
"model",
"modelName"
]
}
}
},
"required": [
"creations"
]
}🟢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.
输入模式
{
"type": "object",
"properties": {},
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"credits": {
"type": "number"
},
"name": {
"type": "string"
},
"infoUrl": {
"type": "string"
}
},
"required": [
"credits"
]
}🟡create_upload_link(template, version)
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.
输入模式
{
"type": "object",
"properties": {
"template": {
"type": "string",
"description": "Template slug"
},
"version": {
"type": "string",
"description": "Version id. Default 'main'."
}
},
"required": [
"template"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"uploadId": {
"type": "string"
},
"url": {
"type": "string"
},
"slots": {
"type": "array",
"items": {
"type": "object"
}
}
},
"required": [
"uploadId",
"url"
]
}🟡suggest_template(idea, link)
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.
输入模式
{
"type": "object",
"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"
}
},
"required": [
"idea"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"received": {
"type": "boolean"
}
},
"required": [
"received"
]
}社区
证据