Content und Video

Alle vier Werkzeuge laufen als Aufträge: Antwort 202, das Ergebnis per Abfrage oder Webhook (Aufträge und Ergebnisse). Stimme, Musik, Schlusssatz und Avatar wählen Sie aus den Referenzlisten (Referenzdaten).

Content-Paket

POST /content/generate - Bereich tools:contentgen. Aus Objektdaten und Fotos erstellt GREM Beschreibungen, Social-Media-Posts, ein vertontes Video, eine Landingpage und ein PDF - in einem Auftrag. Für das Paket wird ein Objektentwurf angelegt.

Mindestens 4 Fotos sind nötig - als öffentliche Adressen in form.media.photos. Eigene Dateien laden Sie zuerst mit POST /uploads hoch und übergeben die zurückgegebenen url (Dateien).

Ein Feld user ist nicht nötig: Das Paket wird im Namen des Kontos des Schlüssels erstellt.

curl -X POST https://developers.grem.capital/api/v1/content/generate \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 0c0e3a5b-7d1e-4b8a-9b2f-1e6d4c3a2b10" \
  -d '{
    "form": {
      "language": "deu",
      "propertyCategory": "apartment", "dealType": "sale",
      "title": "Helle 2-Zimmer-Wohnung am Park",
      "totalArea": 64, "rooms": 2, "price": 320000, "priceCurrency": "EUR",
      "addressCountry": "Germany", "addressCity": "Berlin",
      "media": { "photos": ["https://example.com/1.jpg", "https://example.com/2.jpg",
                             "https://example.com/3.jpg", "https://example.com/4.jpg"] }
    }
  }'

Antwort 202: jobId (Auftrags-ID) und propertyId (der Objektentwurf). Der fertige Auftrag (GET /content/generate/jobs/{id}) enthält:

Datei: GET /artifacts/v1/ai/assistant/announcement/jobs/{jobId}/artifacts/{artifactId}/download. Ereignisse - content.completed, content.partial (einige Dateien fehlgeschlagen), content.failed. Weniger als 4 Fotos - 400.

Inseratstexte

POST /text/generate - Bereich tools:text. Eine Beschreibung, eine Präsentation und ein Social-Media-Post. Nötig ist entweder objectId oder mindestens eines von description, city, totalArea - sonst 422 mit code: not_enough_input.

curl -X POST https://developers.grem.capital/api/v1/text/generate \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"city":"Berlin","totalArea":64,"rooms":2,"propertyCategory":"apartment","language":"de","description":"Saniert, ruhiger Hof, 5 Minuten zur U-Bahn."}'

202 mit jobId. Die Texte liegen in den Dateien des Auftrags, wie beim Content-Paket; der Auftrag enthält auch progress, masterProfile und error. Ereignisse - text.completed / text.failed.

Video aus Fotos

POST /video/create - Bereich tools:video. Ein kurzes vertontes Video aus Ihren Fotos oder den Fotos eines Objekts.

Body - multipart/form-data, jede Option als eigenes Formularfeld (nicht JSON in einem Feld data):

curl -X POST https://developers.grem.capital/api/v1/video/create \
  -H "Authorization: Bearer gsk_live_xxx" \
  -F "[email protected]" -F "[email protected]" -F "[email protected]" \
  -F "prompt=Sonnige 2-Zimmer-Wohnung in Berlin Mitte, ruhiger Hof" \
  -F "length=short" -F "aspect=9:16" -F "language=de"

202 mit jobId; das Video liegt in den Dateien des Auftrags. Der Auftrag enthält auch progress, masterProfile und error, wie beim Content-Paket. Der Preis hängt von length ab. Ereignisse - video.completed / video.failed.

Avatar-Video

POST /avatar/video - Bereich tools:avatar. Ein Moderator stellt Ihr Objekt vor.

curl -X POST https://developers.grem.capital/api/v1/avatar/video \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"avatarId":"AVATAR_ID","objectId":"OBJECT_ID","voiceId":"VOICE_ID","scriptText":"..."}'

202 mit jobId. Video: GET /artifacts/v1/ai/assistant/avatar/jobs/{jobId}/artifacts/{artifactId}/download, artifactId aus artifacts des fertigen Jobs. Ereignisse - avatar.completed / avatar.failed. Fehlen avatarId oder objectId oder ist der Text zu kurz - 400 mit den Feldern in errors.

Verwandte Artikel

• Referenzdaten - Stimmen, Avatare, Musik, Schlusssätze.
• Aufträge und Ergebnisse - Zustände und Dateien.
• Dateien - Fotos hochladen.