Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

MCP (Model Context Protocol) é um protocolo de contexto de modelo lançado pela Anthropic, que permite que modelos de IA (como Claude, GPT, etc.) chamem ferramentas externas através de interfaces padronizadas. Através do Sora MCP Server fornecido pela XHuoAPI, você pode usar diretamente o OpenAI Sora para gerar vídeos de IA em clientes de IA como Claude Desktop, VS Code, Cursor, entre outros.

​
Visão Geral das Funcionalidades

O Sora MCP Server oferece as seguintes funcionalidades principais:
  • Geração de vídeo a partir de texto — Gera vídeos de alta qualidade a partir de prompts de texto
  • Geração de vídeo a partir de imagem — Gera vídeos com base em imagens
  • Vídeo com consistência de personagem — Mantém a consistência do personagem usando imagens de referência
  • Geração assíncrona — Suporta envio de tarefas assíncronas e consulta de resultados
  • Vários formatos de tela — Suporta paisagem (landscape) e retrato (portrait)
  • Consulta de tarefas — Monitora o progresso da geração e obtém resultados

​
Preparativos

Antes de usar, você precisa obter o Token da API da XHuoAPI:
  1. Registre-se ou faça login na plataforma XHuoAPI
  2. Vá para a página Sora Videos API
  3. Clique em “Acquire” para obter o Token da API (o primeiro pedido oferece um crédito gratuito)

​
Instalação e Configuração

​
Método 1: Instalação via pip (recomendado)

pip install mcp-sora

​
Método 2: Instalação a partir do código-fonte

git clone https://github.com/XHuoAPI/SoraMCP.git
cd SoraMCP
pip install -e .
Após a instalação, você pode usar o comando mcp-sora para iniciar o serviço.

​
Usando no Claude Desktop

Edite o arquivo de configuração do Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Adicione a seguinte configuração: 
{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}
Se usar uvx (sem necessidade de instalar pacotes previamente): 
{
  "mcpServers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}
Salve a configuração e reinicie o Claude Desktop para usar as ferramentas relacionadas ao Sora nas conversas.

​
Usando no VS Code / Cursor

Crie um arquivo .vscode/mcp.json no diretório raiz do projeto: 
{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}
Ou use uvx: 
{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}

​
Lista de Ferramentas Disponíveis

Nome da FerramentaDescrição
sora_generate_videoGera vídeo a partir de prompts de texto
sora_generate_video_from_imageGera vídeo com base em imagens
sora_generate_video_with_characterGera vídeo consistente usando imagens de referência
sora_generate_video_asyncEnvia tarefas de geração de vídeo de forma assíncrona
sora_get_taskConsulta o status de uma única tarefa
sora_get_tasks_batchConsulta o status de várias tarefas

​
Exemplos de Uso

Após a configuração, você pode chamar essas funcionalidades diretamente em linguagem natural nos clientes de IA, por exemplo:
  • “Ajude-me a gerar um vídeo de um gato correndo na grama com o Sora”
  • “Gere um vídeo a partir desta foto de uma pessoa, mantendo a consistência do personagem”
  • “Gere um vídeo em formato retrato, com o conteúdo sendo o nascer do sol na cidade”
  • “Gere um vídeo de forma assíncrona e consulte os resultados mais tarde”

​
Mais Informações