API zur Videoerstellung

Generieren Sie Immobilien-Anzeigenvideos aus Fotos. Fügen Sie Untertitel, Musik, Immobilienmerkmale und individuelles Branding hinzu — alles aus einem einzigen synchronen JSON-Aufruf.

Erstellt ein MP4-Video aus einer Liste von Bildern mit Bewegungseffekten, optionalen Untertiteln, Hintergrundmusik, Immobilienmerkmal-Overlays und Endkarten. Der Endpunkt ist synchron: Er blockiert, bis das Video gerendert ist, und gibt dann HTTP 200 mit der finalen videoUrl zurück.

Synchron, mit langem Timeout

Der Endpunkt blockiert bis zu 10 Minuten während des Video-Renderings und gibt dann die abspielbare URL zurück. Setzen Sie das Timeout Ihres HTTP-Clients auf mindestens 11 Minuten — die Standard-30–60 Sekunden der meisten HTTP-Bibliotheken werden vor Pedras Antwort abbrechen.

Wenn das Rendering 10 Minuten überschreitet, gibt der Endpunkt 500 mit {"error": "Video processing timeout after 10 minutes..."} zurück. Das Video kann im Hintergrund noch fertig werden — kontaktieren Sie den Support mit dem Request-Body, falls das passiert.

Parameter auf oberster Ebene

Image-Objekt

Jeder Eintrag in images beschreibt einen Frame:

Wasserzeichen-Optionen

Musiktitel

Branding

Beispiel: minimales Video

curl -X POST https://app.pedra.ai/api/create_video \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "images": [
      { "imageUrl": "https://example.com/img1.jpg", "effect": "zoom-in" },
      { "imageUrl": "https://example.com/img2.jpg", "effect": "zoom-out" }
    ],
    "isVertical": false,
    "endingTitle": "Contact us!",
    "endingSubtitle": "Visit our website"
  }'

Beispiel: vollständiges Produktions-Anzeigenvideo

7-Frame-Walkthrough mit gemischten Effekten (zoom-in / zoom-out / transition / static), individuelles Wasserzeichen + Agentenfoto + Markenfarbe, Musik, Voiceover, Untertitel pro Frame, Overlay mit Immobilienmerkmalen und Endkarte. Entspricht dem typischen realen Payload-Muster, das Pedras eigene App verwendet.

curl -X POST https://app.pedra.ai/api/create_video \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "images": [
      {
        "imageUrl": "https://example.com/exterior.jpg",
        "effect": "zoom-in",
        "subtitle": "Renovated 2-bedroom in Barcelona",
        "watermark": {"enabled": true, "position": "bottom-right", "opacity": 0.75},
        "characteristics": {"enabled": true}
      },
      {
        "imageUrl": "https://example.com/living-room.jpg",
        "effect": "zoom-out",
        "subtitle": "Bright, open-plan living space",
        "watermark": {"enabled": true, "position": "bottom-right", "opacity": 0.75}
      },
      {
        "imageUrl": "https://example.com/before.jpg",
        "secondImageUrl": "https://example.com/after.jpg",
        "effect": "transition",
        "title": "Before & After"
      }
    ],
    "isVertical": false,
    "propertyCharacteristics": [
      {"label": "Price", "value": "€450,000"},
      {"label": "Bedrooms", "value": "2"},
      {"label": "Bathrooms", "value": "1"},
      {"label": "Surface", "value": "85 m²"}
    ],
    "music": {"enabled": true, "track": "uplifting"},
    "voice": {"enabled": true, "audioUrl": "https://example.com/voiceover.mp3"},
    "branding": {
      "showWatermark": true,
      "watermarkUrl": "https://example.com/agency-logo.png",
      "showProfessionalPicture": true,
      "professionalPictureUrl": "https://example.com/agent-photo.jpg",
      "primaryColor": "#000000"
    },
    "endingTitle": "Felix Ingla",
    "endingSubtitle": "felix@pedra.ai"
  }'

Antwort

{
  "message": "Video created successfully",
  "videoId": "<uuid>",
  "videoUrl": "https://pedraimages.s3.eu-west-3.amazonaws.com/<uuid>"
}

Credits

Jeder Frame kostet 5 Credits — außer Frames mit effect: "static", die kostenlos sind. Ein Video mit 5 Bildern und allen zoom-in/zoom-out-Effekten zieht 25 Credits ab. Siehe Preise.

Validierungsfehler

HTTP 400 wird zurückgegeben bei:

• Fehlendes oder leeres images-Array.
• Jedes Bild ohne imageUrl (der Fehler nennt den fehlerhaften Index).
• effect nicht in [zoom-in, zoom-out, transition, static].
• effect: "transition" ohne secondImageUrl.

Verfügbare Merkmalsbezeichnungen

Bei Verwendung von propertyCharacteristics werden die folgenden Etikett-Schlüssel mit passenden Symbolen im Overlay gerendert: Bedrooms, Bathrooms, Surface, Price, Location, Parking, Heating, Outdoor. Benutzerdefinierte Etiketten sind erlaubt, werden aber ohne Symbol gerendert.

Weiter

Siehe Fehler und Limits für Fehlermodi und Timeout-Verhalten bei Video-Jobs.