API für KI-Videogenerierung
Schick einen Prompt, bekomm ein fertiges Video zurück: Yoh schreibt das Drehbuch, besetzt einheitliche Figuren, fügt Stimmen, Musik und Untertitel hinzu und rendert die MP4. Oder steuere jeden Schritt selbst: Storys, Serien, Clips, Figuren, Timeline und Renderings.
Dein erstes Video in drei Aufrufen
Schlüssel erstellen
Melde dich an, öffne Settings → API keys und erstelle einen Schlüssel mit stories:generate und stories:read. Er wird nur einmal angezeigt; bewahre ihn als serverseitiges Secret auf. So prüfst du ihn:
curl https://www.yoh.app/api/v1/credits \ -H "Authorization: Bearer $YOH_API_KEY"Erzeugen
X-Max-Generation-Credits ist deine Zustimmung: die meisten Credits, die du für diese Anfrage akzeptierst. Ist der Preis höher, kommt HTTP 409 mit dem Preisangebot zurück und nichts wird berechnet. Mit demselben Idempotency-Key kannst du gefahrlos wiederholen.
curl -X POST https://www.yoh.app/api/v1/stories/generate \ -H "Authorization: Bearer $YOH_API_KEY" \ -H "X-Max-Generation-Credits: 500" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: my-first-video-1" \ -d '{ "prompt": "A dragon teaches a young knight how to fly", "contentType": "cinematic_story", "aspectRatio": "16:9", "scope": "full", "renderVideo": true }'Job abfragen
Frag alle 20 Sekunden ab, bis der Status completed ist; die Antwort enthält die storyId und die videoUrl der MP4.
curl https://www.yoh.app/api/v1/stories/jobs/JOB_ID \ -H "Authorization: Bearer $YOH_API_KEY"
Warum es gut funktioniert
Volle Kontrolle, wenn du sie willst
Erstelle eine Serie und ihre Besetzung einmal und mach dann Folgen darin; bearbeite Clips, erzeuge Bild oder Video eines einzelnen Clips neu, starte mit deinem eigenen hochgeladenen Video und rendere die Timeline deiner Wahl.
Kosten, die du planen kannst
Jede bezahlte Anfrage braucht ein Credit-Limit oder ein angenommenes Preisangebot. Kostenlose Vorschauen (estimate, quoteOnly, dryRun) nennen dir den Preis, bevor etwas startet.
Für Wiederholungen gebaut
Idempotency-Keys bei der Erzeugung, dauerhafte Jobs, die du abfragen und abbrechen kannst, und klare Endzustände.
Lieber ein Agent?
Dasselbe Konto und dieselben Scopes funktionieren über MCP, damit Claude oder Codex Yoh für dich aufrufen kann.
Fragen
Gibt es eine API, um KI-Videos aus Text zu erzeugen?
Ja. POST /api/v1/stories/generate nimmt einen Prompt entgegen und gibt einen Job zurück; ist er fertig, bekommst du eine gerenderte MP4 mit Drehbuch, Figuren, Stimmen, Musik und Untertiteln.
Wie wird die API abgerechnet?
Sie nutzt dieselben Yoh-Credits wie die App. Jede bezahlte Anfrage nennt die maximale Zahl an Credits, die du akzeptierst, und den genauen Preis bekommst du vorab über die kostenlosen Estimate-Endpunkte.
Kann ich dieselben Figuren in mehreren Videos behalten?
Ja. Erstelle einmal eine Serie mit ihren Figuren und erzeuge dann Folgen darin; jede Folge nutzt dieselbe Besetzung.
Wo finde ich die vollständige Referenz?
Die Dokumentation listet jeden Endpunkt, jeden Scope und jeden Fehler auf, mit einem Live-Playground.
Vollständige Referenz: Yoh Dokumentation · Preise · OpenAPI 3.1
Weitere Verbindungswege
- KI-Videos mit Claude erstellenVerbinde Claude mit deinem Yoh-Konto und erstelle Videostorys, indem du einfach fragst. Claude schreibt das Drehbuch, hält die Figuren einheitlich, erzeugt die Clips, bearbeitet die Timeline und rendert das fertige Video. Bevor etwas Credits kostet, fragt Claude dich.
- KI-Videos mit Codex erstellenVerbinde Codex mit Yoh und lass es Videostorys direkt aus deinem Terminal oder Editor produzieren: Drehbuch, Besetzung, Clips, Stimmen, Untertitel und das fertige Rendering. Vor jedem bezahlten Schritt siehst du den Preis und gibst ihn frei.
- Der Yoh MCP-Server für KI-VideosEin einziger Remote-MCP-Endpunkt gibt jedem Agenten das ganze Yoh-Studio: Story schreiben, Figuren besetzen und zeichnen, Clip-Videos mit Stimmen und Musik erzeugen, Timeline und Untertitel bearbeiten, rendern und veröffentlichen. Jedes Tool folgt denselben Regeln wie der Editor auf yoh.app.
- Der Yoh Skill für KI-AgentenDer MCP-Server gibt deinem Agenten die Tools, der Skill bringt ihm das Handwerk bei. Eine SKILL.md im offenen Agent Skills-Format erklärt dem Agenten, wie eine gute Yoh-Story entsteht und bei welchen Regeln man leicht danebenliegt.