Frameo

npx add-mcp 'https://mcp.frameo.ai/mcp'

O servidor do Model Context Protocol que permite que assistentes de IA criem conteúdo usando a conta Frameo do usuário. Esta página é gerada a partir da lista de ferramentas ativas do servidor.

Endpoint

URL do servidor	https://mcp.frameo.ai/mcp
Transporte	HTTP Streamable (MCP)
Autenticação	OAuth 2.1 com PKCE (S256), escopo frameo

Conexão

Cliente	Como
Claude	Settings → Connectors → Add custom connector, and paste the server URL.
ChatGPT	Add a custom app in Settings → Apps, and paste the server URL.
Claude Code	claude mcp add --transport http frameo https://mcp.frameo.ai/mcp
Cursor	Add to mcp.json: {"mcpServers": {"frameo": {"url": "https://mcp.frameo.ai/mcp"}}}

Na primeira chamada, o cliente abre a página de login da Frameo. O usuário entra com sua conta Frameo, escolhe o workspace em que a conexão será iniciada e aprova. switch_workspace posteriormente move a conexão para qualquer outro workspace do qual o usuário faça parte. Desconectar o conector no cliente, ou revogá-lo, encerra o acesso.

Diretórios

O servidor MCP da Frameo está listado em:

• Smithery

Autorização

Os clientes descobrem tudo a partir dos metadados do recurso protegido; nenhum segredo de cliente é emitido, e todo cliente é público e usa PKCE.

Metadados do recurso protegido	https://mcp.frameo.ai/.well-known/oauth-protected-resource/mcp
Metadados do servidor de autorização	https://mcp.frameo.ai/.well-known/oauth-authorization-server
Autorizar	https://mcp.frameo.ai/authorize
Token	https://mcp.frameo.ai/token
Registro dinâmico de cliente	https://mcp.frameo.ai/register
Revogação	https://mcp.frameo.ai/revoke

Documentos de metadados com ID de cliente são aceitos no lugar do registro.

Visão geral

A Frameo é uma plataforma de produção de vídeo com IA para curtas-metragens, micro-dramas, anúncios e vídeo para redes sociais: imagens, clipes de vídeo, narrações, música e efeitos sonoros são gerados no canvas de um projeto, mantidos consistentes de cena a cena e montados no corte final. A Frameo tem uma skill para quase todo tipo de trabalho, desde um roteiro até um vídeo, passando por anúncio UGC ou ensaio fotográfico, e as skills dão os melhores resultados. Para trabalhos de várias etapas, list_skills encontra a skill certa e get_skill retorna os passos a seguir desde o início. O trabalho é organizado como workspace → projeto → módulo, e cada módulo tem seu próprio canvas, chat e Biblioteca. Esta conexão funciona em um workspace por vez. O que esta conexão cria é registrado no chat e na Biblioteca do módulo, e colocado no canvas assim que o projeto é aberto no aplicativo. Como um trabalho funciona: 1. whoami: o workspace em que esta conexão atua, seus créditos e os outros workspaces do usuário. 2. list_projects ou create_project (create_module adiciona um módulo ao projeto): o project_id e o module_id que toda ferramenta de criação exige. 3. list_skills e depois get_skill: os passos para o trabalho. 4. estimate_cost e depois uma ferramenta de geração (generate_image, generate_video, generate_speech, generate_music, generate_sound_effect, generate_lipsync, upscale_video): o quote_id é de uso único, válido por 15 minutos e vinculado àquelas configurações; a chamada de geração o resgata com confirmed_by_user assim que o usuário concorda, e uma chamada diferente é recusada sem cobrança. 5. show_generations e wait_task: em aplicativos de chat que mostram cards, o usuário vê o trabalho apenas em um card de show_generations e, sem um, não vê nada por algo que pode levar dezenas de minutos. Um card por leva: cada id iniciado antes do próximo wait_task, mostrado antes dele; final true para o resultado concluído. wait_task coleta os resultados. Escolhendo a ferramenta: - Arquivos no dispositivo do usuário: show_upload. Um link da web: import_media_url. - Títulos, legendas e texto em um vídeo: render_motion_graphics ou run_ffmpeg, não um modelo de vídeo. - Brilho, cor, corte, velocidade ou duração de mídia existente: run_ffmpeg. Uma mudança no que está contido nela: uma nova geração. - Uma narração: generate_speech. Uma pessoa falando na tela: generate_speech e depois generate_lipsync quando a boca dela precisar combinar com as palavras. - Clipes do próprio usuário: analyze_media informa o que há neles antes de serem editados. - Um vídeo mais nítido: upscale_video (somente vídeos). - Um problema com a Frameo, ou algo que ela ainda não consegue fazer: report_problem. Consistência: um personagem ou produto recorrente permanece o mesmo quando suas imagens anteriores são passadas como referências (image_urls, reference_image_urls) ou salvas com save_character. Verificando resultados: wait_task retorna pequenas prévias, então um resultado pode ser conferido em relação à solicitação antes de ser usado. A skill review-shots verifica um conjunto inteiro de cenas e o corte final, e refaz uma cena reprovada uma vez; uma refação é orçada como qualquer outra geração. Formatos: 9:16 para Reels, TikTok e Shorts; 16:9 para YouTube; 1:1 ou 3:4 para posts de feed, onde o modelo os aceita (list_models). Miniaturas e capas: uma nova imagem (a skill thumbnail-set); um vídeo não tem configuração de capa. Sem créditos: uploads, importações, run_ffmpeg, render_motion_graphics, search_sound_effects e todas as leituras continuam funcionando.

Erros

Uma ferramenta que falha retorna um resultado em vez de um erro de protocolo. error é um código estável, hint diz o que mudar e retryable diz se a mesma chamada pode ter sucesso mais tarde. Uma chamada paga que falha informa se o trabalho começou e o que foi cobrado.

{
  "ok": false,
  "error": "quote_mismatch",
  "hint": "These settings differ from the quoted ones (differs lists each). Nothing was charged, and the quote_id is still valid for its original settings; estimate_cost with the new settings returns a quote for them.",
  "differs": {"resolution": {"quoted": "480p", "requested": "720p"}},
  "retryable": false
}

Ferramentas (43)

Gravações · gratuitas

Salvar um som da biblioteca em um projeto

Salva um som de search_sound_effects na Biblioteca de um projeto. Gratuito: nada é gerado. O som é salvo na Biblioteca do projeto.

Argumento	Tipo	Padrão
sound_id	string	obrigatório
project_id	string	opcional
module_id	string	opcional
request_text	string	opcional

Gravações · gratuitas

Adicionar um upload à Biblioteca do projeto

Coloca um arquivo enviado por create_upload_url na Biblioteca de um projeto. Gratuito. O arquivo armazenado é verificado primeiro: deve existir, estar dentro do limite de tamanho para seu tipo (imagens 20 MB, vídeo 200 MB, áudio 50 MB) e ser armazenado com um tipo de conteúdo desse tipo. Adicionar o mesmo arquivo ao mesmo módulo novamente não muda nada, inclusive o nome, e informa ok. Retorna ok, frameo_url, kind e open_in_frameo, um link para o projeto.

Argumento	Tipo	Padrão
frameo_url	string	obrigatório
project_id	string	opcional
module_id	string	opcional
name	string	opcional

Usa créditos

Analisar um clipe de vídeo ou áudio

Descreve ou transcreve um clipe de vídeo ou áudio que está na Frameo. Usa créditos, cobrados pela duração do clipe depois de executado — a única ferramenta paga sem orçamento. A resposta vem como texto e também é registrada no chat Frameo do projeto. O preço não é conhecível antes da execução: são alguns créditos por minuto de mídia. confirmed_by_user registra que o usuário foi informado disso e concordou; sem isso, a chamada é recusada. O resultado da execução concluída (wait_task / get_task) traz credits_charged_estimate, a mudança na carteira durante a execução (null em uma consulta feita antes da cobrança ser aplicada). Retorna um id de execução para wait_task. Geralmente concluído em um minuto. Em um módulo, essas execuções (ffmpeg, motion graphics, análise de mídia) acontecem uma por vez: enquanto uma está em andamento, outra iniciada no mesmo módulo é recusada com chat_busy, que é repetível. Outros módulos não são afetados, e as ferramentas de geração no módulo ainda funcionam.

Argumento	Tipo	Padrão
media_url	string	obrigatório
question	string	obrigatório
project_id	string	opcional
module_id	string	opcional
confirmed_by_user	boolean	False

Gravações · gratuitas

Abrir a Frameo conectada

Cria um link de uso único que abre uma página do aplicativo web da Frameo conectado como o usuário desta conexão e em seu workspace, para o botão Abrir na Frameo em um card de resultado. Gratuito. Retorna url, um link da Frameo que conecta uma vez e dentro de 60 segundos; depois disso, ainda abre o destino, sem conectar. Cada conexão faz até 10 por minuto.

Argumento	Tipo	Padrão
destination	string	obrigatório

Gravações · gratuitas

Adicionar um módulo a um projeto

Adiciona um módulo, com seu próprio canvas, chat e Biblioteca, a um projeto existente. Gratuito. Um projeto de create_project já tem seu primeiro módulo. Retorna o module_id do novo módulo, que toda ferramenta de geração exige, seu module_number (um a mais que o maior do projeto, a ordem em que o aplicativo lista os módulos) e um link open_in_frameo para ele. Várias chamadas para um projeto enviadas juntas são numeradas na ordem em que chegam, que não precisa ser a ordem em que foram enviadas; create_modules adiciona uma lista na ordem declarada. O mesmo project_id e nome enviados novamente em 5 minutos, para esta ferramenta ou para create_modules com apenas esse nome, retorna esse módulo, marcado como replayed, então um projeto recebe um módulo por nome distinto.

Argumento	Tipo	Padrão
project_id	string	obrigatório
name	string	obrigatório

Gravações · gratuitas

Adicionar vários módulos a um projeto

Adiciona vários módulos a um projeto existente em uma única chamada, numerados na ordem fornecida. Gratuito. Retorna modules, uma entrada por módulo criado com seu module_id, nome, module_number e link open_in_frameo, na ordem fornecida. A chamada retorna em cerca de 45 segundos: quando a Frameo está lenta, ou recusa um nome no meio (então error diz o motivo), os módulos criados até então são retornados e not_created lista os nomes ainda a adicionar, em ordem; um create_modules com apenas esses nomes continua a numeração. O mesmo project_id e nomes enviados novamente em 5 minutos retorna o mesmo resultado, marcado como replayed, e não adiciona nada.

Argumento	Tipo	Padrão
project_id	string	obrigatório
names	string[]	obrigatório

Gravações · gratuitas

Criar um projeto Frameo

Cria um novo projeto Frameo, com seu primeiro módulo, para gerar conteúdo. Gratuito. Retorna o project_id e o module_id do módulo que toda ferramenta de geração exige, e um link open_in_frameo para o novo projeto. O mesmo nome e aspect_ratio enviados novamente em 5 minutos retorna esse projeto, marcado como replayed. module_not_created significa que o projeto em project_id existe sem um módulo.

Argumento	Tipo	Padrão
name	string	obrigatório
aspect_ratio	string	'9:16'

Gravações · gratuitas

Criar um link de compartilhamento

Cria uma página pública de compartilhamento da Frameo para um arquivo de imagem, vídeo ou áudio finalizado, para o botão Compartilhar em um card de resultado. Gratuito. Retorna share_url, uma página content.frameo.ai que reproduz o arquivo e linka para frameo.ai. Um arquivo fora do armazenamento de produção da Frameo não tem página de compartilhamento: share_page é false e share_url é o link do próprio arquivo.

Argumento	Tipo	Padrão
url	string	obrigatório
kind	string	obrigatório
share_title	string	opcional
share_description	string	opcional

Gravações · gratuitas

Criar um link de upload Obtenha um link para enviar um arquivo cujos bytes o chamador envia ele mesmo (um HTTP PUT). Grátis. Para clientes que podem fazer requisições HTTP; show_upload é o cartão para arquivos no dispositivo do usuário. Os bytes não passam por este servidor. O chamador os envia: um HTTP PUT para upload_url com o arquivo como corpo bruto e exatamente os cabeçalhos fornecidos em headers, ou, para um arquivo grande, chamadas Azure Put Block e Put Block List em upload_url, que o enviam em partes. upload_url é válido por 60 minutos e para este único arquivo; uma nova chamada emite outro. Assim que esse PUT for bem-sucedido, frameo_url é um link Frameo aceito em qualquer lugar onde um seja aceito -- image_urls, first_frame_url, reference_image_urls, ou uma fonte lipsync -- sem nenhuma etapa adicional. Até que add_upload_to_library seja chamado com frameo_url, o arquivo é armazenado na conta do usuário apenas e não aparece na Biblioteca de nenhum projeto. Onde nenhuma requisição HTTP for possível, o mesmo arquivo pode ser adicionado no aplicativo Frameo e seu link usado em vez disso.

Argumento	Tipo	Padrão
file_name	string	obrigatório

Gravações · grátis

Citar o custo de uma geração

Citar os créditos Frameo que uma geração custará. Grátis. Obrigatório antes de qualquer ferramenta generate. Passe as mesmas configurações e projeto que a chamada generate usará; uma solicitação alterada precisa de uma nova cotação. Várias gerações podem ser precificadas de uma vez com items. Retorna os créditos que a geração custará e um quote_id que a ferramenta generate correspondente resgata. credits_available é o saldo do espaço de trabalho no momento da cotação (o limite do próprio membro onde o espaço de trabalho define um), quando o Frameo o reporta. Quando a cotação custa mais, short_by é a diferença e plans_url vincula à página de planos do Frameo; a cotação ainda é emitida, e uma chamada generate que o saldo não pode cobrir é recusada com out_of_credits, sem cobrança, e sua cotação é usada; uma nova tentativa leva uma nova cotação. show_credits, dados esses créditos como credits_needed, mostra a deficiência em um cartão que vincula à página de planos e avisa quando os créditos chegam. Uma cotação é de uso único, válida por 15 minutos e vinculada às configurações que precificou. A ferramenta generate a resgata junto com confirmed_by_user, que registra que o usuário viu esses créditos e concordou com eles. settings lista o que foi precificado. Uma chamada generate cujas configurações diferem da cotação, ou com confirmed_by_user falso, é recusada sem cobrança e deixa a cotação válida. A mesma chamada generate enviada novamente retorna o trabalho que iniciou, marcado como replayed, sem custo; a cotação enviada com outros argumentos é recusada com quote_used, que nomeia esse trabalho. Com items, o resultado tem uma entrada por item em quotes, em ordem, cada uma com seu índice e ou seu próprio quote_id e credits ou seu próprio erro. total_credits soma os itens que foram cotados, e credits_available, short_by e plans_url comparam o saldo com esse total. Cada quote_id é resgatado por conta própria, então qualquer um dos itens pode ser gerado e o restante deixado para expirar.

Argumento	Tipo	Padrão
kind	string	opcional
count	integer	1
aspect_ratio	string	'9:16'
project_id	string	opcional
module_id	string	opcional
duration	number	5
resolution	string	opcional
generate_audio	boolean	False
model	string	'seedance_2_5'
text	string	opcional
voice_id	string	opcional
image_model	string	'nano-banana-pro'
image_resolution	string	opcional
reference_count	integer	0
first_frame	boolean	False
items	QuoteItem[]	opcional

Gravações · grátis

Extrair quadros de um vídeo

Extrair imagens estáticas de um vídeo. Retorna links de imagem Frameo. O uso comum é o ÚLTIMO quadro de um clipe, que se torna first_frame_url para generate_video para que a próxima cena continue exatamente de onde esta terminou. Leva até um minuto. Grátis: nenhum crédito é cobrado. O resultado também carrega pequenos previews JPEG de até 4 dos quadros (no máximo 384 px) como conteúdo de imagem ao lado do mesmo JSON; previews lista os links de quadro que eles mostram, na mesma ordem das imagens.

Argumento	Tipo	Padrão
video_url	string	obrigatório
duration	number	obrigatório
at_seconds	number[]	opcional
project_id	string	opcional
module_id	string	opcional

Usa créditos

Gerar imagens

Iniciar uma geração de imagem em um projeto Frameo. Usa os créditos Frameo do usuário. Texto para imagem, ou de image_urls: imagens de origem que ou EDITAM uma imagem ou mantêm um personagem, produto ou estilo estável em uma nova cena. O prompt diz o que manter e o que mudar ("mesma mulher, agora em uma praia ao pôr do sol"). Resoluções suportadas e contagens de imagens de origem variam por modelo; list_models relata cada um. Retorna ids de geração assim que o trabalho é enfileirado; wait_task retorna as imagens quando estão prontas. Um timeout de wait_task deixa o trabalho em execução e os ids válidos. O resultado é salvo no projeto Frameo; o link open_in_frameo do resultado finalizado o abre lá.

Argumento	Tipo	Padrão
prompt	string	obrigatório
aspect_ratio	string	'9:16'
count	integer	1
image_urls	string[]	opcional
image_model	string	'nano-banana-pro'
image_resolution	string	opcional
project_id	string	opcional
module_id	string	opcional
request_text	string	opcional
shot_number	integer	opcional
placement_kind	string	opcional
placement_group	string	opcional
board_name	string	opcional
quote_id	string	opcional
confirmed_by_user	boolean	False

Usa créditos

Sincronizar lábios de um vídeo com uma narração

Fazer a pessoa em um vídeo falar um clipe de áudio (lipsync). Usa os créditos Frameo do usuário. Lipsync é precificado por segundo de vídeo e está entre as ferramentas mais caras aqui. Retorna ids de geração assim que o trabalho é enfileirado; wait_task retorna o resultado quando está pronto. Um timeout de wait_task deixa o trabalho em execução e os ids válidos. O resultado é salvo no projeto Frameo; o link open_in_frameo do resultado finalizado o abre lá.

Argumento	Tipo	Padrão
video_url	string	obrigatório
audio_url	string	obrigatório
duration	number	obrigatório
audio_duration	number	opcional
aspect_ratio	string	'9:16'
resolution	string	'480p'
project_id	string	opcional
module_id	string	opcional
request_text	string	opcional
quote_id	string	opcional
confirmed_by_user	boolean	False

Usa créditos

Gerar uma faixa de música

Iniciar uma faixa de música de fundo em um projeto Frameo. Usa os créditos Frameo do usuário. Retorna ids de geração assim que o trabalho é enfileirado; wait_task retorna a faixa quando está pronta. Um timeout de wait_task deixa o trabalho em execução e os ids válidos. A faixa é salva no projeto Frameo.

Argumento	Tipo	Padrão
prompt	string	obrigatório
duration	integer	30
project_id	string	opcional
module_id	string	opcional
request_text	string	opcional
quote_id	string	opcional
confirmed_by_user	boolean	False

Usa créditos

Gerar um efeito sonoro

Gerar um novo efeito sonoro de disparo único em um projeto Frameo. Usa os créditos Frameo do usuário. Isso cria um novo som. search_sound_effects pesquisa uma biblioteca de sons prontos, que são gratuitos e instantâneos. Retorna ids de geração assim que o trabalho é enfileirado; wait_task retorna o som quando está pronto. Um timeout de wait_task deixa o trabalho em execução e os ids válidos. O som é salvo no projeto Frameo.

Argumento	Tipo	Padrão
prompt	string	obrigatório
duration	integer	5
project_id	string	opcional
module_id	string	opcional
request_text	string	opcional
quote_id	string	opcional
confirmed_by_user	boolean	False

Usa créditos

Gerar uma narração

Iniciar uma narração (texto para fala) em um projeto Frameo. Usa os créditos Frameo do usuário. Retorna ids de geração assim que o trabalho é enfileirado; wait_task retorna o áudio e seu duration_seconds quando está pronto. Um timeout de wait_task deixa o trabalho em execução e os ids válidos. A narração é salva no projeto Frameo.

Argumento	Tipo	Padrão
text	string	obrigatório
voice_id	string	obrigatório
language_code	string	opcional
project_id	string	opcional
module_id	string	opcional
request_text	string	opcional
quote_id	string	opcional
confirmed_by_user	boolean	False

Usa créditos

Gerar um vídeo

Iniciar uma geração de vídeo em um projeto Frameo. Usa os créditos Frameo do usuário. Texto para vídeo por padrão. first_frame_url faz o clipe abrir nessa imagem; reference_image_urls em vez disso carregam um personagem, produto ou visual para uma nova cena. Em modelos Seedance (o padrão entre eles), um primeiro quadro é executado como a imagem de referência principal: o clipe abre nele, mas renderiza na aspect_ratio solicitada, o quadro e as referências podem ser passados juntos, e o quadro conta como uma das imagens de referência do modelo. Em todos os outros modelos, o clipe assume a forma do próprio primeiro quadro, e uma chamada que carrega tanto um quadro quanto referências é recusada. Uma solicitação que quebra as regras de um modelo é recusada antes que qualquer coisa seja cobrada. Retorna ids de geração assim que o trabalho é enfileirado. O vídeo leva de um a alguns minutos, e wait_task o retorna quando está pronto. Em modelos Seedance, imagens de referência (e um primeiro quadro) são preparadas antes do vídeo começar, e o primeiro uso de uma imagem pode adicionar uma pequena espera. references_registering significa que essa preparação durou mais que esta chamada: nada foi cobrado, a cotação não foi usada, e a mesma chamada a continua. reference_image_rejected nomeia uma imagem que foi recusada, e reference_registration_incomplete uma que não pôde ser preparada; nada foi cobrado por nenhuma delas. O resultado é salvo no projeto Frameo; o link open_in_frameo do resultado finalizado o abre lá.

Argumento	Tipo	Padrão
prompt	string	obrigatório
first_frame_url	string	opcional
reference_image_urls	string[]	opcional
duration	integer	5
aspect_ratio	string	'9:16'
resolution	string	opcional
generate_audio	boolean	False
model	string	'seedance_2_5'
project_id	string	opcional
module_id	string	opcional
request_text	string	opcional
shot_number	integer	opcional
placement_kind	string	opcional
placement_group	string	opcional
board_name	string	opcional
quote_id	string	opcional
confirmed_by_user	boolean	False

Somente leitura · gratuito

Obter as instruções de uma habilidade

Instruções passo a passo para uma habilidade do Frameo, como um vídeo a partir de um roteiro. Gratuito. Retorna o texto da habilidade: quando ela se aplica, o que perguntar ao usuário primeiro, as chamadas de ferramentas em ordem (cada etapa paga é citada com estimate_cost antes de ser executada), o que o usuário recebe e os nomes de seus arquivos de referência, legíveis com get_skill_file.

Argumento	Tipo	Padrão
skill_id	string	obrigatório

Somente leitura · gratuito

Obter o arquivo de referência de uma habilidade

Um arquivo de referência de uma habilidade (um padrão de prompt, um modelo de lista de planos, um estilo de legenda), nomeado no files\ de get_skill. Gratuito.

Argumento	Tipo	Padrão
skill_id	string	obrigatório
file_name	string	obrigatório

Gravação · gratuito

Verificar o status da geração

Relata o estado atual das gerações e execuções, por seus IDs. Gratuito. Retorna imediatamente. Este é um instantâneo único, então uma geração ainda em andamento retorna como 'running', com seconds_left, a estimativa do Frameo do tempo restante, quando o Frameo forneceu uma. Trabalhos que o Frameo não pôde alcançar para verificar retornam como 'unchecked', com uma dica: não é afetado, e os mesmos IDs podem ser verificados novamente. wait_task cobre os mesmos IDs, mas bloqueia até que terminem. IDs iniciados por qualquer uma das conexões do usuário com este espaço de trabalho são reconhecidos. IDs de várias chamadas, IDs de geração e de execução, podem ser verificados juntos: o resultado então tem uma entrada por chamada em tasks\, cada uma com seu tipo ('run' para uma execução), generation_ids e status, na ordem em que os IDs foram passados, e o status de nível superior é 'finished' quando cada entrada está. Um ID de uma chamada com múltiplos resultados relata essa chamada inteira. Um resultado concluído de vídeo, lipsync, upscale, fala, música ou efeito sonoro tem duration_seconds, mapeando cada link de mídia para seu comprimento em segundos, para os links cujo comprimento o Frameo registrou. Para fala, é onde a última palavra termina; o arquivo pode durar alguns décimos de segundo a mais. Um resultado concluído de imagem ou vídeo também carrega pequenos previews JPEG de até 4 de suas imagens e vídeos (no máximo 384 px; um vídeo pelo seu quadro um segundo depois) como conteúdo de imagem ao lado do mesmo JSON; previews lista os links que eles mostram, na mesma ordem das imagens, e image_urls e video_urls vinculam os arquivos completos.

Argumento	Tipo	Padrão
generation_ids	string[]	obrigatório
kind	string	opcional

Gravação · gratuito

Importar mídia de um link

Copia um arquivo de imagem, vídeo ou áudio de um link web público para o Frameo e para a Biblioteca de um projeto. Gratuito. O Frameo busca o arquivo do site em si, então isso funciona onde o cliente não pode enviar arquivos. Retorna frameo_url (aceito em qualquer lugar onde um link do Frameo é), kind, bytes, name e open_in_frameo. Cada conta pode importar 10 links por minuto, e uma importação leva no máximo cerca de 50 segundos. Uma recusa carrega error e uma dica. Dois casos: source_refused significa que o site serve o arquivo apenas para um usuário conectado ou um navegador, e o arquivo pode ser adicionado no aplicativo Frameo, ou enviado através de create_upload_url por um cliente que pode enviar arquivos; uma recusa que ainda carrega frameo_url significa que o arquivo está armazenado, ou ainda está sendo copiado para lá, e add_upload_to_library pode arquivá-lo mais tarde.

Argumento	Tipo	Padrão
url	string	obrigatório
project_id	string	opcional
module_id	string	opcional
name	string	opcional

Somente leitura · gratuito

Listar os personagens de um projeto

Lista o elenco recorrente de um projeto Frameo: o nome, as imagens e a voz de cada personagem. Gratuito. O elenco são os personagens salvos do projeto: aqueles em sua Biblioteca de Referência (feitos no aplicativo Frameo, pelo agente do aplicativo, ou com save_character) e aqueles que o agente do aplicativo mantém para o módulo. Cada personagem tem name, images (até 6 links de imagem do Frameo, que image_urls e reference_image_urls aceitam), voice_id (uma voz que generate_speech aceita, ou null quando nenhuma está definida) e in_library: false para um personagem que o agente do aplicativo apenas dublou, que não tem imagens até que save_character o adicione à Biblioteca. No máximo 30 personagens.

Argumento	Tipo	Padrão
project_id	string	opcional
module_id	string	opcional

Somente leitura · gratuito

Listar a Biblioteca de um projeto

Lista a mídia na Biblioteca de um projeto Frameo, do mais recente ao mais antigo. Gratuito. A Biblioteca contém tudo capturado para um módulo, esteja ou não colocado na tela: cada geração (do agente do aplicativo Frameo e ações rápidas, deste servidor, de execuções ffmpeg) e cada arquivo enviado ou importado. read_project difere: relata apenas o que está na última tela salva, por plano. Cada item tem kind e url (um link do Frameo que as outras ferramentas aceitam), e onde registrado, seu name, origin, tool, model, prompt (cortado para 500 caracteres) e created_at. counts dá o número de itens correspondentes de cada tipo. No máximo 60 itens são retornados por chamada; quando mais correspondem, truncated é true e next_cursor, passado como cursor, retorna a próxima página. Itens adicionados após a primeira página não deslocam páginas posteriores. open_in_frameo vincula ao projeto.

Argumento	Tipo	Padrão
project_id	string	opcional
module_id	string	opcional
kind	string	opcional
origin	string	opcional
cursor	string	opcional

Somente leitura · gratuito

Listar modelos de imagem e vídeo

Os modelos de imagem ou vídeo que o Frameo oferece, com os limites e o preço de cada um. Gratuito. A resposta define qual modelo uma solicitação nomeada precisa, quanto custa uma opção de qualidade superior e qual regra uma solicitação recusada quebrou. Para vídeo: os comprimentos de clipe, proporções de aspecto, se o modelo começa de uma imagem, quantas imagens de referência aceita e o preço em créditos por segundo em cada resolução (silencioso e com som). Para imagem: max_source_images e o preço em créditos por imagem em cada resolução que o modelo suporta (texto para imagem, 9:16), além das aspect_ratios compartilhadas. Alguns modelos de imagem adicionam créditos por imagem de origem. O modelo de vídeo padrão é Seedance 2.5; o modelo de imagem padrão é a escolha mais barata e sensata.

Argumento	Tipo	Padrão
kind	string	'video'

Somente leitura · gratuito

Listar projetos Frameo

Encontra os projetos Frameo do usuário, do mais recente ao mais antigo, opcionalmente por nome. Gratuito. Um project_id e module_id daqui são onde as ferramentas de geração colocam resultados; module_id é opcional quando o projeto tem um único módulo. As primeiras cinco correspondências listam seus módulos, cada um com um link open_in_frameo para a tela desse módulo no aplicativo web Frameo. Correspondências posteriores carregam apenas project_id e name.

Argumento	Tipo	Padrão
query	string	opcional
limit	integer	10

Somente leitura · gratuito

Listar habilidades Frameo

Habilidades Frameo passo a passo para vídeos, anúncios UGC, ensaios fotográficos e mais. Gratuito. Dois tipos: workflow\ (várias ferramentas, minutos a uma hora: um roteiro em um vídeo, uma resenha UGC, um ensaio fotográfico de produto) e recipe\ (uma geração com um padrão de prompt comprovado: uma foto hero, um giro de produto). kind filtra para um deles. Cada entrada tem um id, um resumo de uma frase, o que o usuário deve trazer (needs\), uma faixa aproximada de créditos e tempo. get_skill retorna as instruções completas de uma habilidade.

Argumento	Tipo	Padrão
kind	string	opcional

Somente leitura · gratuito

Atualizar o saldo de créditos

A verificação do cartão de saldo do Frameo. Gratuito. Retorna imediatamente. Aplicativos de chat que mostram cartões Frameo o escondem do modelo; em outros lugares, é o mesmo que show_credits, lendo além do cache curto de saldo do Frameo para que uma compra apareça imediatamente.

Argumento	Tipo	Padrão
credits_needed	integer	opcional

Somente leitura · gratuito

Atualizar a galeria de gerações

A verificação de progresso do cartão de galeria do Frameo. Gratuito. Retorna imediatamente. Aplicativos de chat que mostram cartões Frameo o escondem do modelo; em outros lugares, é o mesmo que get_task sem previews de imagem. Aceita os mesmos generation_ids e kind que get_task.

Argumento	Tipo	Padrão
generation_ids	string[]	obrigatório
kind	string	opcional

Gravação · gratuito

Ler a tela de um projeto

Lista o que já está na tela de um projeto Frameo: imagens, vídeos e áudio, por plano. Gratuito. Isto é como o trabalho existente se parece antes de algo ser construído sobre ele, como em "anime o segundo plano" ou "adicione uma narração a esse clipe". Cada item carrega um url: o link direto para seu arquivo de imagem, vídeo ou áudio, que abre ou reproduz em um navegador e que as outras ferramentas aceitam como entrada. O link open_in_frameo do resultado abre a tela inteira no aplicativo web Frameo. No máximo 60 itens são listados; truncated é true quando há mais, e counts cobre todos eles. Relata a última tela SALVA. O aplicativo salva enquanto o usuário trabalha, então um resultado produzido momentos atrás está ausente até que o usuário tenha aberto o projeto e ele tenha sido colocado. recorded_just_now lista até três dos resultados anteriores do usuário para este projeto que ainda não foram adicionados (por exemplo, de outra conexão), com seus links de mídia; eles aparecem na tela na próxima vez que o projeto for aberto.

Argumento	Tipo	Padrão
project_id	string	opcional
module_id	string	opcional

Gravação · gratuito

Renderizar um clipe de gráficos em movimento de um modelo

Renderiza um clipe curto de gráficos em movimento de um dos modelos do Frameo: um cartão de título, um terço inferior, linhas de legenda, um cartão final, uma contagem regressiva ou texto cinético. Gratuito. O texto é renderizado por um navegador, então é exato; o Frameo escreve a página inteira a partir do modelo — nenhum HTML é aceito. Retorna um ID de execução para wait_task. O clipe é registrado no chat Frameo do projeto e colocado na tela: ao vivo quando o projeto está aberto, caso contrário, na próxima vez que for aberto. Em um módulo, essas execuções (ffmpeg, gráficos em movimento, análise de mídia) vão uma de cada vez: enquanto uma está em andamento, outra iniciada no mesmo módulo é recusada com chat_busy, que é repetível. Outros módulos não são afetados, e as ferramentas de geração no módulo ainda são executadas.

Argumento	Tipo	Padrão
template	string	obrigatório
reason	string	obrigatório
title	string	opcional
subtitle	string	opcional
lines	string[]	opcional
size	string	'9:16'
duration	number	5
font	string	'Inter'
accent	string	opcional
background	string	opcional
text_color	string	opcional
count_from	integer	opcional
count_to	integer	opcional
project_id	string	opcional
module_id	string	opcional

Gravações · gratuito

Relatar um problema ao Frameo

Envie um relatório à equipe do Frameo sobre o Frameo: algo que deu errado, funciona mal ou está faltando. Gratuito. Problemas com essas ferramentas são um caso comum: um erro de ferramenta, um resultado errado, uma tarefa travada ou uma descrição de ferramenta enganosa. Um relatório pode vir do usuário, que o solicitou, ou do assistente por conta própria quando encontra um problema; o gatilho registra qual. Uma recusa cuja dica a explica, como uma carteira vazia, uma cotação expirada ou um argumento que a ferramenta rejeitou, é o Frameo funcionando como pretendido, e não um problema. A equipe recebe o título, a descrição e o tipo com a conta, o espaço de trabalho, o aplicativo assistente, o projeto e o módulo, e os erros de ferramenta desta conexão da última hora. Nada mais da conversa é enviado. Retorna report_id, pelo qual a equipe do Frameo pode consultar o relatório.

Argumento	Tipo	Padrão
title	string	obrigatório
description	string	obrigatório
problem_type	string	obrigatório
trigger	string	obrigatório
project_id	string	opcional
module_id	string	opcional
tool_name	string	opcional

Gravações · gratuito

Executar um comando ffmpeg

Execute um comando ffmpeg na mídia do Frameo em um projeto: cortar, unir, redimensionar, recortar ou adicionar preenchimento, alterar velocidade, ajustar brilho, contraste ou cor (eq), sobrepor, mixar uma narração ou música, queimar legendas, extrair áudio. Gratuito. A linha de comando é do próprio chamador (argv), executada em um espaço de trabalho privado contendo as entradas e os arquivos auxiliares; as saídas declaradas retornam como links do Frameo. O trabalho é executado em uma sandbox: sem rede, apenas arquivos do espaço de trabalho, com limite de tempo. Retorna run_ids imediatamente; wait_task e get_task leem o resultado, que também chega ao chat do Frameo do projeto e, na sua tela, assim que o projeto é aberto. Um arquivo auxiliar .ass com o filtro ass\ renderiza legendas de texto de forma mais confiável que drawtext. Em um módulo, essas execuções (ffmpeg, gráficos em movimento, análise de mídia) ocorrem uma de cada vez: enquanto uma está em andamento, outra iniciada no mesmo módulo é recusada com chat_busy, que pode ser repetida. Outros módulos não são afetados, e as ferramentas de geração no módulo ainda são executadas. Uma execução aceita no máximo 10 entradas e 4 saídas. Cada usuário tem 30 execuções por hora entre run_ffmpeg, render_motion_graphics e analyze_media.

Argumento	Tipo	Padrão
inputs	object[]	obrigatório
argv	string[]	obrigatório
outputs	object[]	obrigatório
reason	string	obrigatório
sidecars	object[]	opcional
project_id	string	opcional
module_id	string	opcional
request_text	string	opcional
timeout_seconds	integer	300

Pode sobrescrever · gratuito

Salvar um personagem em um projeto

Salve um personagem no elenco de um projeto do Frameo, para que trabalhos posteriores reutilizem sua aparência e voz. Gratuito. O personagem é adicionado à Biblioteca de Referência do projeto como o aplicativo Frameo adiciona um, e aparece no painel de personagens do aplicativo. Um nome já presente no elenco não é adicionado novamente: sua voz é definida quando fornecida, suas imagens são deixadas como estão, e o resultado informa isso (saved false).

Argumento	Tipo	Padrão
name	string	obrigatório
image_urls	string[]	obrigatório
project_id	string	opcional
module_id	string	opcional
description	string	opcional
voice_id	string	opcional

Somente leitura · gratuito

Pesquisar a biblioteca de efeitos sonoros

Pesquise na biblioteca do Frameo efeitos sonoros prontos. Gratuito. Um som da biblioteca é instantâneo e gratuito, enquanto generate_sound_effect custa créditos e leva tempo. Cada resultado tem um id\ para passar como sound_id para add_sound_to_library, e um audio\_url\, o próprio arquivo de som, que toca em um navegador. Um resultado vazio significa que a biblioteca não tem nada correspondente.

Argumento	Tipo	Padrão
query	string	obrigatório
category	string	opcional
max_duration	integer	opcional
limit	integer	8

Somente leitura · gratuito

Pesquisar vozes

Encontre vozes para generate_speech na biblioteca de vozes do Frameo do usuário. Gratuito. Os filtros (gênero, idade, idioma, sotaque) são correspondências exatas, então um valor adivinhado retorna nada em vez de uma aproximação. Retorna até limit\ vozes (máximo 20), melhores primeiro, cada uma com um voice_id para generate_speech e, quando o Frameo possui uma gravação da voz, um sample_url que a toca em um navegador. Vozes clonadas no espaço de trabalho são incluídas, marcadas como cloned: true, com yours: true nos clones do próprio usuário e false nos de outros membros. Os clones do próprio usuário ficam à frente de outras vozes quando não há consulta ou quando a consulta os corresponde.

Argumento	Tipo	Padrão
query	string	''
gender	string	''
age	string	''
language	string	''
accent	string	''
limit	integer	8

Somente leitura · gratuito

Oferecer gerações para escolher

Mostre gerações como opções para o usuário escolher uma, pelos seus ids. Gratuito. Retorna imediatamente. Em aplicativos de chat que exibem cartões do Frameo, o cartão mostra cada geração como em show_generations, com question como título e um botão "Usar este" em cada uma concluída. Pressioná-lo publica a escolha do usuário na conversa como mensagem própria, nomeando o link escolhido. O cartão não usa créditos. Onde cartões não são exibidos, apenas o resultado abaixo retorna. O resultado é o instantâneo de get_task desses ids, sem prévias de imagem.

Argumento	Tipo	Padrão
generation_ids	string[]	obrigatório
question	string	opcional
kind	string	opcional

Somente leitura · gratuito

Mostrar créditos

Mostre os créditos do Frameo do espaço de trabalho em relação ao custo de uma solicitação, com um link para a página de planos, em um cartão. Gratuito. Em aplicativos de chat que exibem cartões do Frameo, o cartão mostra o saldo em relação a credits_needed e um botão Planos e créditos que abre a página de planos do Frameo conectada como o usuário desta conexão. Uma vez que esse botão é pressionado, o cartão reverifica o saldo a cada poucos segundos por até 15 minutos, e quando o saldo cobre credits_needed, um botão Continuar publica "Adicionei créditos do Frameo" no chat. O cartão não usa créditos. Onde cartões não são exibidos, apenas o resultado abaixo retorna. Retorna credits (o saldo do espaço de trabalho, o limite próprio do membro quando o espaço de trabalho define um, ou null quando o Frameo não o informa), has_active_plan (true para uma assinatura ou teste ativo; sem nenhum, o Frameo se recusa a cobrar qualquer saldo), credits_needed, short_by quando ambos são conhecidos, e plans_url, que linka a página de planos do Frameo; é informação, e nada é comprado por meio dela.

Argumento	Tipo	Padrão
credits_needed	integer	opcional

Somente leitura · gratuito

Mostrar gerações

Mostre gerações ao usuário como um cartão interativo no chat, onde o aplicativo de chat suporta MCP Apps, pelos seus ids. Gratuito. Retorna imediatamente. Uma geração leva de segundos a alguns minutos, e um trabalho inteiro dezenas de minutos. O cartão é mostrado assim que o trabalho começa: o usuário assiste ao progresso de cada geração ao vivo e a cada resultado conforme chega. É apenas para o usuário; wait_task é como o assistente obtém atualizações e resultados. Chamado antes de wait_task, o cartão mostra o progresso enquanto wait_task espera. Um cartão cobre uma onda de trabalho: cada geração ou execução iniciada antes do próximo wait_task, mostrada uma vez com todos os seus ids antes dessa espera. Os mesmos ids aparecem novamente apenas como o resultado final (final true). Uma única chamada rápida não precisa de cartão. Um cartão cobre as gerações em execução ao mesmo tempo, até 24 ids de qualquer chamada de geração ou execução, em uma chamada. Um único id faz um cartão completo quando é a única geração em execução. Cada chamada adiciona um novo cartão, então gerações em execução juntas, mas mostradas uma chamada por vez, empilham cartões separados no chat. Sem suporte a MCP Apps, apenas o resultado abaixo retorna. O resultado é o instantâneo de get_task desses ids, sem prévias de imagem. Com final, o cartão oferece Baixar e Compartilhar em cada item concluído.

Argumento	Tipo	Padrão
generation_ids	string[]	obrigatório
kind	string	opcional
final	boolean	False
share_title	string	opcional
share_description	string	opcional

Somente leitura · gratuito

Enviar arquivos para o Frameo

Abra um cartão onde o usuário escolhe arquivos do seu dispositivo para enviar ao Frameo. Gratuito. Em aplicativos de chat que exibem cartões do Frameo, o cartão envia cada arquivo escolhido diretamente para o armazenamento do Frameo através de create_upload_url, arquiva-o na Biblioteca do projeto através de add_upload_to_library quando um projeto é fornecido, e então publica os links frameo_url dos arquivos na conversa como uma mensagem do usuário. Esses links são aceitos em qualquer lugar onde um link do Frameo é aceito. Onde cartões não são exibidos, nada é enviado e apenas o resultado abaixo retorna. Retorna accepts, as extensões de arquivo aceitas com o tipo e limite de tamanho de cada uma em MB, e o project_id e module_id para onde os arquivos vão, se houver.

Argumento	Tipo	Padrão
project_id	string	opcional
module_id	string	opcional

Gravações · gratuito

Alternar o espaço de trabalho do Frameo

Mova esta conexão para outro espaço de trabalho ao qual o usuário pertence, pelo seu id de whoami's workspaces. Gratuito. A partir da próxima chamada, toda ferramenta funciona nesse espaço de trabalho: seus projetos, Biblioteca, vozes e personagens, e seus créditos são os gastos. Cotações de estimate_cost que ainda não foram resgatadas são descartadas, pois precificaram o trabalho contra o espaço de trabalho anterior. Execuções iniciadas antes da alternância pertencem ao espaço de trabalho que as iniciou: get_task e wait_task relatam run_not_found para elas, e seus resultados são registrados no chat desse projeto apenas quando a conexão é alternada de volta, dentro de 7 dias do início da execução. Retorna o espaço de trabalho agora ativo e seus créditos.

Argumento	Tipo	Padrão
workspace_id	string	obrigatório

Usa créditos

Ampliar um vídeo Torne um vídeo mais nítido e com maior resolução. Usa os créditos Frameo do usuário. O upscaling é precificado por segundo de vídeo e normalmente é a última etapa, aplicada a clipes finalizados. Retorna IDs de geração assim que o trabalho é enfileirado; wait_task retorna o resultado quando estiver pronto. Um timeout de wait_task deixa o trabalho em execução e os IDs válidos. O resultado é salvo no projeto Frameo; o link open_in_frameo do resultado finalizado o abre lá.

Argumento	Tipo	Padrão
video_url	string	obrigatório
duration	number	obrigatório
factor	number	2.0
aspect_ratio	string	'9:16'
resolution	string	'480p'
project_id	string	opcional
module_id	string	opcional
request_text	string	opcional
quote_id	string	opcional
confirmed_by_user	boolean	False

Gravações · gratuito

Aguardar a conclusão das gerações

Aguarda a conclusão das gerações e execuções e, em seguida, retorna o resultado. Gratuito. Bloqueia por até timeout_seconds (máx. 50), fazendo polling internamente, e retorna o mesmo formato de get_task. Trabalhos que excedem essa janela retornam com status 'running': eles não são afetados, e os mesmos IDs podem ser aguardados novamente até que o status seja 'finished'. Em aplicativos de chat que exibem cartões, o usuário vê esse trabalho apenas em um cartão show_generations: sem um cartão nesses IDs, ele não vê nada enquanto o trabalho é executado, e um trabalho inteiro (um lote de clipes, um corte) leva dezenas de minutos em várias chamadas wait_task.

Argumento	Tipo	Padrão
generation_ids	string[]	obrigatório
timeout_seconds	integer	50
kind	string	opcional

Somente leitura · gratuito

Verificar a conexão Frameo

Confirma a conexão Frameo: quem está conectado, qual workspace está ativo e seus créditos. Gratuito. workspaces lista todos os workspaces aos quais o usuário pertence; switch_workspace move a conexão para outro deles. credits é o saldo do workspace ativo (o limite do próprio membro quando o workspace define um), ou null quando o Frameo não o informa. spent_by_this_connection é o que esta conexão gastou. plans_url vincula a página de planos do Frameo, que descreve os planos e créditos; é informativo, e nada é comprado por meio dela.

Sem argumentos.