Hoppa till huvudinnehåll

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) är en modellkontextprotokoll som lanserats av Anthropic, vilket tillåter AI-modeller (som Claude, GPT etc.) att anropa externa verktyg via standardiserade gränssnitt. Genom Sora MCP Server som tillhandahålls av XHuoAPI kan du direkt använda OpenAI Sora för att generera AI-videor i AI-klienter som Claude Desktop, VS Code, Cursor etc.

​
Funktionsöversikt

Sora MCP Server erbjuder följande kärnfunktioner:
  • Textgenererad video — Generera högkvalitativa videor genom textpromptar
  • Bildgenererad video — Generera video baserat på bilder
  • Karaktärskonsistensvideo — Bevara karaktärskonsistens med referensbilder
  • Asynkron generering — Stöd för asynkron uppgiftsinlämning och resultatfrågor
  • Flera bildriktningar — Stöd för liggande (landscape) och stående (portrait)
  • Uppgiftsfråga — Övervaka genereringsprocessen och hämta resultat

​
Förberedelser

Innan användning behöver du skaffa en XHuoAPI API-token:
  1. Registrera dig eller logga in på XHuoAPI-plattformen
  2. Gå till sidan Sora Videos API
  3. Klicka på “Acquire” för att få API-token (första ansökan ger gratis kvot)

​
Installationskonfiguration

​
Metod ett: pip-installation (rekommenderas)

pip install mcp-sora

​
Metod två: källkodinstallation

git clone https://github.com/XHuoAPI/SoraMCP.git
cd SoraMCP
pip install -e .
När installationen är klar kan du använda kommandot mcp-sora för att starta tjänsten.

​
Använda i Claude Desktop

Redigera konfigurationsfilen för Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Lägg till följande konfiguration: 
{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}
Om du använder uvx (ingen förinstallation av paket krävs): 
{
  "mcpServers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}
Spara konfigurationen och starta om Claude Desktop för att använda Sora-relaterade verktyg i dialogen.

​
Använda i VS Code / Cursor

Skapa .vscode/mcp.json i projektets rotkatalog: 
{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}
Eller använd uvx: 
{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}

​
Tillgängliga verktyg

VerktygsnamnBeskrivning
sora_generate_videoGenerera video genom textpromptar
sora_generate_video_from_imageGenerera video baserat på bilder
sora_generate_video_with_characterGenerera konsistensvideo med referenskaraktär
sora_generate_video_asyncAsynkront skicka videogenereringsuppgifter
sora_get_taskFråga status för enskild uppgift
sora_get_tasks_batchBatchfråga uppgiftsstatus

​
Användningsexempel

När konfigurationen är klar kan du direkt använda dessa funktioner med naturligt språk i AI-klienten, till exempel:
  • “Hjälp mig att generera en video av en katt som springer på gräset med Sora”
  • “Generera en video med denna personbild, behåll karaktärskonsistensen”
  • “Generera en stående video med innehållet stads soluppgång”
  • “Asynkront generera en video och fråga resultatet senare”

​
Mer information