Zum Inhalt springen

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

  1. 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"
  2. 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 }'
  3. 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