MCP & Agenten
Lassen Sie Ihren KI-Assistenten Bilder und Videos erstellen
Der offizielle MCP-Server gibt Claude, Cursor, Codex, VS Code und anderen Assistenten den Live-Modellkatalog, exakte Preisangebote und das Erstellen von Tasks. Sie fragen in normalen Worten, und vor jeder Abbuchung holt er Ihre Bestätigung ein.
Was ist ein MCP-Server?
MCP (Model Context Protocol) ist ein Standard, um einem KI-Assistenten neue Tools zu geben. Fügen Sie den SpicyAPI-Server hinzu, und Ihr Assistent kann Modelle durchsuchen, Preise prüfen und Bilder oder Videos für Sie erstellen.
- Sie und Ihr AssistentClaude, Cursor, Codex, VS Code …
- SpicyAPI-MCP-ServerLäuft über npx auf Ihrem Rechner
- Bild- und VideomodelleLive-Katalog, exakte Preise
Ideal für
- Assets beim ProgrammierenBitten Sie um ein Hero-Bild oder einen Produktclip, ohne den Editor zu verlassen.
- Modelle erkundenFragen Sie, welches Modell zu einer Aufgabe passt und was es kostet.
- Batches auf AutopilotDer Agent erstellt mehrere Tasks, wartet darauf und sammelt die Ergebnisse.
Was bei Ihrer Anfrage passiert
- Schritt 1Sucht im Live-Katalog ein passendes Modell und liest, was es annimmt
- Schritt 2Lädt Ihre lokale Datei hoch, falls es eine gibt
- Schritt 3Holt ein exaktes Angebot in US-Dollar und fragt Sie, bevor etwas abgebucht wird
- Schritt 4Startet den Task, wartet darauf und gibt Ihnen den Link zum Ergebnis
Sie: Aus beach.jpg einen sechssekündigen Clip mit Wellen bei Sonnenuntergang machen.
- spicyapi_models_listspicyapi_model_getAssistent: Videomodell gefunden, das ein Startbild akzeptiert
- spicyapi_upload_filebeach.jpg hochgeladen
- spicyapi_task_quote
Hier ist der exakte Preis in US-Dollar. Task erstellen?
- spicyapi_task_createspicyapi_task_waitFertig. Hier ist Ihr Download-Link.
Zu Ihrem Assistenten hinzufügen
Jeder Client startet denselben lokalen Server über npx. Wählen Sie Ihren für den genauen Befehl oder Konfigurationsblock.
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
}
}
}Ein stdio-Server für jeden MCP-Client. Den Block in die Konfigurationsdatei des jeweiligen Clients einfügen.
claude mcp add spicyapi \
-e SPICY_API_KEY=$SPICY_API_KEY \
-- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skillMCP-Server hinzufügen und den Skill installieren. Claude Code denkt weiter mit Claude; SpicyAPI ist ein Werkzeug, das es aufruft.
codex mcp add spicyapi \
--env SPICY_API_KEY=$SPICY_API_KEY \
-- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skillEin codex mcp add genügt: Desktop-App, CLI und IDE-Erweiterung lesen dieselbe ~/.codex/config.toml.
// ~/.cursor/mcp.json
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
}
}
}Den Server in ~/.cursor/mcp.json eintragen. Die Datei liegt außerhalb Ihres Repositories.
// ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
}
}
}Derselbe Block in der MCP-Konfigurationsdatei von Windsurf.
// ~/.gemini/settings.json
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
}
}
}Derselbe Block in ~/.gemini/settings.json.
// .vscode/mcp.json (committed to the repo, so prompt for the key instead of hard-coding it)
{
"inputs": [
{ "id": "spicyapi-key", "type": "promptString", "description": "SpicyAPI key", "password": true }
],
"servers": {
"spicyapi": {
"type": "stdio",
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "${input:spicyapi-key}" }
}
}
}.vscode/mcp.json wird eingecheckt, deshalb fragt es den Schlüssel ab, statt ihn zu speichern.
// ~/.cline/mcp.json
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" },
"disabled": false,
"autoApprove": []
}
}
}Einen MCP-Server-Block in ~/.cline/mcp.json eintragen — danach erzeugt er Bilder und Videos direkt.
# librechat.yaml — restart LibreChat after editing
mcpServers:
spicyapi:
type: stdio
command: npx
args: ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"]
env:
SPICY_API_KEY: "${SPICY_API_KEY}"Einen Eintrag unter mcpServers in librechat.yaml ergänzen und LibreChat neu starten, sonst verbindet es sich nicht.
grok mcp add spicyapi -- npx --yes --package=@spicyapi/mcp spicyapi-mcp
# or write ~/.grok/config.toml directly
[mcp_servers.spicyapi]
command = "npx"
args = ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"]
env = { SPICY_API_KEY = "${SPICY_API_KEY}" }Ein grok mcp add genügt; MCP-Server, die Sie für Claude Code eingerichtet haben, laufen hier ebenso.
Clients von Drittanbietern ändern ihre Konfigurationsformate von Version zu Version. Passt ein Snippet hier nicht mehr, gilt die Dokumentation des Clients.
Sie nutzen Claude? Bilder und Videos aus Claude erzeugen →
Bereitgestellte Tools
Lesende Tools sind kostenlos. Die beiden Tools, die Geld kosten, und das Tool, das Inhalte löscht, fragen Sie immer zuerst.
KostenlosKostenlos und nur lesend12
spicyapi_service_statusÖffentlicher Health-Check, kein Schlüssel nötigspicyapi_docs_searchDie mitgelieferte Dokumentation durchsuchenspicyapi_models_listAktive Modelle und Ihre Preisespicyapi_model_getEin Modell und sein Eingabeschemaspicyapi_balance_getVerfügbares, reserviertes und Gesamtguthabenspicyapi_usage_getWas der aktuelle Schlüssel ausgegeben hatspicyapi_tasks_listLetzte Tasks des aktuellen Schlüsselsspicyapi_task_getEin Task mit fertigen Ergebnislinksspicyapi_task_waitBis zu 5 Minuten auf das Ende eines Tasks wartenspicyapi_task_quoteEine exakte Anfrage bepreisen, ohne sie zu erstellenspicyapi_upload_fileEine lokale Datei als Eingabe hochladenspicyapi_download_url_createEin frischer Download-Link für ein Ergebnis
Fragt vor der Abbuchung nachFragt vor der Ausführung3
spicyapi_task_createEinen Generierungs-Task startenspicyapi_task_retryEinen fehlgeschlagenen oder abgelaufenen Task erneut ausführenspicyapi_task_purgeDie Inhalte eines abgeschlossenen Tasks endgültig löschen
Agent Skill für die richtige Aufrufreihenfolge hinzufügen
Der MCP-Server gibt dem Agenten Fähigkeiten, der Agent Skill sagt ihm, wie er sie einsetzt: Schema lesen, Angebot bestätigen, pro Versuch einen Idempotency-Key wiederverwenden. Claude Code und Codex unterstützen beides.
npx skills add spicyapi-ai/spicy-skill \
--agent claude-codenpx skills add spicyapi-ai/spicy-skill \
--agent codex -gnpx skills add spicyapi-ai/spicy-skillDateien, die Ihr Agent lesen kann
Diese Dateien führen Assistenten und Integrationswerkzeuge zu Produktbeschreibung, Modellkatalog und kanonischer Dokumentation.
agent.md
Kompakter Agent-Vertrag mit Sicherheitsgrenzen.
/agent.md →
llms.txt
Kuratierter Website- und Modellindex für KI-Abruf.
/llms.txt →
llms-full.txt
Erweiterter Kontext zu Produkt, Ablauf, Endpunkten und Erkennung.
/llms-full.txt →
Agent-Manifest
Strukturierte JSON-Erkennung für Tools und autonome Clients.
/api/agent →
Häufige Fehler beheben
Die meisten Anfangsprobleme sind eines dieser drei. Jede Karte zeigt, was Sie sehen und was Sie ändern müssen.
- Tools
Tools erscheinen nicht
Starten Sie den Assistenten nach dem Bearbeiten der Konfiguration neu und prüfen Sie, ob das JSON gültig ist.
- Schlüssel
API-Schlüssel fehlt
Tragen Sie SPICY_API_KEY in den env-Block der Server-Konfiguration ein. Desktop-Apps sehen keinen Schlüssel, den Sie in Ihrer Shell exportiert haben.
- Frage
Tasks lassen sich nicht erstellen
Ihr Client kann keine Bestätigungsabfragen anzeigen. Die kostenlosen Tools funktionieren weiter; für das Erstellen von Tasks brauchen Sie einen Client mit MCP-Elicitation.