Higgsfield: DOP Preview

DOP Preview wandelt bereitgestelltes Bildmaterial mit dem dokumentierten Arbeitsablauf für Bewegungsvorlagen in Video um. Die konkrete Modellauswahl dop-preview unterstützt einen oder zwei Effekte; die Steuerungen für Stärke, prompt und seed bleiben beim abgeschlossenen Ergebnis erhalten.

Ailoot Ultra · Videoerzeugung POST /v1/videos dop-preview

Über das Modell

Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.

DOP Preview animiert bereitgestelltes Bildmaterial über den von Higgsfield dokumentierten Bild-zu-Video-Arbeitsablauf. Die konkrete Modellkennung ist dop-preview. Verwenden Sie dop-preview als Auswahl im Feld model auf oberster Ebene und als model-Wert innerhalb des dokumentierten params-Objekts. Das Bild liefert das visuelle Material, während Bewegungsvorlagen und schriftliche Vorgaben die angeforderte Bewegung und den Effekt steuern.

Bereiten Sie ein Referenzbild vor, in dem das gewünschte Motiv, wichtige Details und der umgebende Raum gut erkennbar sind. Der Leitfaden empfiehlt ein hochauflösendes Bild für deutlichere Details. Wählen Sie bei einer Produktszene eine Ansicht, die die Form des Objekts und die Oberflächen zeigt, die während der Bewegung erkennbar bleiben sollen. Benennen Sie bei einer Person oder Umgebung das visuelle Merkmal, das durch die Bewegung betont werden soll. Geben Sie die tatsächliche URL des Referenzbilds über die im Methodenbeispiel verwendete Bildeingabe an.

Für den Vorgang sind eine oder zwei Bewegungsvorlagen dokumentiert. Werden zwei angegeben, beschreibt der Leitfaden ihre Effekte als kombiniert. Die Beschreibungen der Voreinstellungen umfassen Kamerabewegung, Motivrotation und visuelle Veränderungen. So bezeichnet Dolly In eine Annäherung der Kamera, während 3D Rotation ein Motiv oder Produkt beschreibt, das sich auf der Stelle dreht. Wählen Sie die dokumentierten Vorlagenkennungen, die zur vorgesehenen Abfolge passen, und bewahren Sie jede Kennung zusammen mit ihrem Stärkewert auf.

Die Bewegungsstärke ist eine Zahl von 0 bis 1; der dokumentierte Standardwert ist 0.8. Der Leitfaden beschreibt 0.3 als dezenten Effekt und 1 als starke Bewegung. Wählen Sie die Intensität anhand des Details, das erkennbar bleiben muss, und prüfen Sie die gesamte erzeugte Bewegung. Bewegungsbeschreibung und Stärke erfüllen unterschiedliche Zwecke: Die Vorlage wählt den Effekt, während die Stärke seine Intensität steuert.

Das Feld prompt muss laut seiner Beschreibung vorhanden sein; eine leere Zeichenfolge ist jedoch erlaubt. Für Effekte auf Basis von Vorlagen empfiehlt der Leitfaden, prompt leer zu lassen. Wird Text angegeben, empfiehlt er, die Beschreibung der Vorlage aufzunehmen, da prompt das Ergebnis stark verändern kann. Die Steuerung enhance_prompt aktiviert die Prompt-Optimierung; als Standardwert ist true dokumentiert. Bewahren Sie beim Vergleich von Versionen den Text und diese Steuerung zusammen mit dem Referenzbild und den ausgewählten Vorlagen auf.

Die Steuerung seed akzeptiert eine ganze Zahl von 1 bis 1000000. Erfassen Sie den gewählten seed zusammen mit den Erzeugungseinstellungen. Die Anfrage bietet ausserdem das ganzzahlige Feld seconds; bewahren Sie den verwendeten Wert zusammen mit dem entstandenen Clip auf und prüfen Sie seinen tatsächlichen zeitlichen Ablauf und Bildausschnitt. Der boolesche Wert check_nsfw aktiviert den dokumentierten Inhaltsfilter und ist standardmässig true. Diese Steuerungen gehören zur Bild-zu-Video-Anfrage und sollten mit dem genau ausgewählten Modell verbunden bleiben.

Die Erzeugung erfolgt asynchron. Bewahren Sie die zurückgegebene Aufgabenkennung, während Sie die konfigurierten Status- und Ergebnisabfragen verfolgen. Die Ergebniszuordnung bei Abschluss liest abgeschlossene Jobeinträge und deren unveränderte Ergebnis-URLs. Speichern Sie jedes abgeschlossene Videoergebnis und bewahren Sie seine Jobkennung zusammen mit der zurückgegebenen URL auf. Halten Sie alle abgeschlossenen Einträge als Ergebnis des Vorgangs zusammen.

Prüfen Sie das gesamte Video anhand des bereitgestellten Bilds, des gewählten Effekts und der schriftlichen Vorgaben: das Erscheinungsbild des Motivs, die Bewegung, den Bildausschnitt und die Ansicht am Ende. Benennen Sie für eine Überarbeitung das konkrete visuelle Detail, das geändert werden soll, und bewahren Sie die erfolgreichen Teile der Anfrage. Halten Sie die ursprüngliche Bildreferenz, die genaue Modellkennung, prompt, Bewegungskennungen, Stärkewerte, seed, angeforderte Einstellungen und fertige Medien zusammen, damit der nächste Vergleich auf der tatsächlichen Erzeugung beruht.

Ailoot Ultra · Videoerzeugung POST /v1/videos dop-preview

dop-preview

Higgsfield /dop-preview

Einstieg

Zulässige Eingaben: Bilder · Text
Ergebnisse: Video

In Ailoot verfügbar · Eingaben und Methoden

Ailoot Ultra · Videoerzeugung POST /v1/videos

Eingabe: image, text
Ausgabe: video

Feld	Typ	Anforderung	Werte und Limits	Standard
Feld`model`	Typ`string`	AnforderungErforderlich	Werte und Limits dop-preview Bedingungen: Modellauswahl von Ailoot.	Standard—
Feld`params`	Typ`object`	AnforderungErforderlich	Werte und Limits Bedingungen: Parameter für Bild-zu-Video; bewahren Sie diese umschliessende Struktur.	Standard—
Feld`params.model`	Typ`string`	AnforderungErforderlich	Werte und Limits dop-preview Bedingungen: Verwenden Sie dieselbe Auswahl wie bei model auf der obersten Ebene.	Standard—
Feld`params.prompt`	Typ`string`	AnforderungErforderlich	Werte und Limits Bedingungen: Behalten Sie dieses Feld bei; eine leere Zeichenkette ist dokumentiert. Schriftliche Vorgaben beeinflussen den ausgewählten Bewegungseffekt stark.	Standard—
Feld`params.seconds`	Typ`integer`	AnforderungOptional	Werte und Limits Bedingungen: Angeforderte Dauer; ein dokumentierter Wertebereich oder Standardwert wird nicht zugesichert.	Standard—
Feld`params.motions`	Typ`array`	AnforderungOptional	Werte und Limits Bedingungen: Wählen Sie eine oder zwei dokumentierte Bewegungsvorlagen.	Standard—
Feld`params.motions[].id`	Typ`string`	AnforderungErforderlich	Werte und Limits Bedingungen: Bewegungskennung aus dem dokumentierten funktionierenden Anfragebeispiel.	Standard—
Feld`params.motions[].strength`	Typ`number`	AnforderungErforderlich	Werte und Limits Minimum: 0 Maximum: 1 Bedingungen: Bewegungsintensität: 0.3 wird als dezent und 1 als stark beschrieben.	Standard0.8
Feld`params.input_images`	Typ`array`	AnforderungOptional	Werte und Limits Bedingungen: Referenzbilder mit dem im funktionierenden Beispiel gezeigten Array von image_url-Objekten.	Standard—
Feld`params.input_images[].type`	Typ`string`	AnforderungErforderlich	Werte und Limits image_url Bedingungen: Referenzdarstellung.	Standard—
Feld`params.input_images[].image_url`	Typ`string`	AnforderungErforderlich	Werte und Limits Bedingungen: Ihre tatsächliche, erreichbare Referenzbild-URL.	Standard—
Feld`params.enhance_prompt`	Typ`boolean`	AnforderungOptional	Werte und Limits Bedingungen: Verbesserung der Textbeschreibung.	Standardtrue
Feld`params.check_nsfw`	Typ`boolean`	AnforderungOptional	Werte und Limits Bedingungen: Inhaltsfilterung.	Standardtrue
Feld`params.seed`	Typ`integer`	AnforderungOptional	Werte und Limits Minimum: 1 Maximum: 1'000'000 Bedingungen: Startwert für konsistente Ausgaben.	Standard—
Feld`webhook`	Typ`object`	AnforderungOptional	Werte und Limits Bedingungen: Optionale dokumentierte webhook-Einstellungen; der Abruf zugeordneter Ergebnisse erfolgt über die Aufgabenpfade von Ailoot.	Standard—
Feld`webhook.url`	Typ`string`	AnforderungOptional	Werte und Limits Bedingungen: Ihre Empfänger-URL.	Standard—
Feld`webhook.secret`	Typ`string`	AnforderungOptional	Werte und Limits Bedingungen: Ihr Empfängergeheimnis.	Standard—
Feld`callback`	Typ`string`	AnforderungOptional	Werte und Limits Bedingungen: Optionaler callback-Empfänger; der dokumentierte Empfänger antwortet mit HTTP 200.	Standard—

Kombinationen von Eingabematerialien

Methodenparameter und Lebenszyklus

Parameter	Vertrag
Parameter`content_type`	Vertragapplication/json
Parameter`required`	Vertragmodel, params
Parameter`optional`	Vertragparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
Parameter`material_types`	Vertragimage, text
Parameter`additional_properties`	Vertragtrue
Parameter`validation_scope`	VertragDas Modell bestimmt die Route der Anfrage; die umschliessende Parameterstruktur folgt der gezeigten Bild-zu-Video-Anfrage.

Methodenaliasnamen: /v1/videos/generations

Lebenszyklus: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Verwenden Sie auf der obersten Ebene und innerhalb von params dieselbe Modellauswahl.

Erstellen Sie den Vorgang einmal und verwenden Sie danach die zurückgegebene öffentliche id und polling_url für diesen ursprünglichen Vorgang.

Rufen Sie jedes fertiggestellte, Ihnen zugeordnete Video ab; prüfen Sie die tatsächliche Dauer und die Abmessungen im Ergebnis.

Ersetzen Sie YOUR_ACCESSIBLE_IMAGE_URL im Beispiel durch die tatsächliche URL Ihres Referenzbildes.

Tarife

So wird die endgültige Gebühr berechnet

Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.

Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.

Schnellmodus: Nicht angegeben Wenn der Schnellmodus ausgewählt ist
Flex-Modus: Nicht angegeben Wenn der Modus flex ausgewählt ist
Maximaler Denkaufwand: Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird

Geschätzte Tarife zum Vergleich

Preise nach Konfiguration

Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.

Konfiguration	Tarifstaffel	Prognostizierte Menge	Gebühr
KonfigurationToken-Basistarife	TarifstaffelGrundtarif	Prognostizierte Menge—	Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens
KonfigurationGeschätzte Erzeugungskosten	Tarifstaffel—	Prognostizierte MengeSchätzung für eine Generierung	Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $1.24 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung.

Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →

Beispielanfragen

Ailoot Ultra · Videoerzeugung

JSON · Video erstellencurl · ursprünglichen Auftrag auslesen

{
  "model": "dop-preview",
  "params": {
    "model": "dop-preview",
    "prompt": "a cat",
    "seed": 500000,
    "motions": [
      {
        "id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa",
        "strength": 0.5
      }
    ],
    "input_images": [
      {
        "type": "image_url",
        "image_url": "YOUR_ACCESSIBLE_IMAGE_URL"
      }
    ],
    "enhance_prompt": true,
    "check_nsfw": true
  }
}

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json

Ergebnisse abrufen und speichern

Ailoot Ultra · Videoerzeugung

Bewahren Sie die zurückgegebenen Aufträge und deren Zustände auf. Rufen Sie jedes fertiggestellte, Ihnen zugeordnete Videoergebnis ab.

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Alle fertiggestellten Ergebnisse aufbewahren

Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.

Rufen Sie jede tatsächliche fertiggestellte Ausgabe ab; gehen Sie nicht von einer festen Anzahl aus.

Wenn die ursprüngliche Antwort geprüft werden muss

Bewahren Sie die ursprüngliche Antwort und zurückgegebene Aufgabenkennung auf; ein unbekannter Zustand oder ein Sendevorgang mit unklarem Ausgang berechtigt nicht zu einer neuen Erstellung.

Antwortfelder

Feld	Typ	Bedeutung
Feld`id`	Typstring	BedeutungÖffentliche Aufgaben- oder Vorgangskennung von Ailoot.
Feld`provider_task_id`	Typstring	BedeutungUrsprüngliche Aufgabenkennung, getrennt von der öffentlichen id.
Feld`polling_url`	Typstring	BedeutungZurückgegebener Abfragepfad von Ailoot.
Feld`jobs[].id`	Typstring	BedeutungTatsächlich zurückgegebene Auftragskennung.
Feld`jobs[].status`	Typstring	BedeutungZustand jedes zurückgegebenen Auftrags.
Feld`jobs[].results.raw.url`	Typstring	BedeutungJedes fertiggestellte Video wird über eine signierte URL unter Kontrolle von Ailoot bereitgestellt.

Fehler und nächste Schritte

Antwort	Bedingung	Nächster Schritt
Antwort400 · `invalid_request_error`	BedingungUngültiges JSON/Modell oder ungültiger Inhaltsindex.	Nächster Schritt
Antwort401 · `authentication_error`	BedingungUngültiger API-Schlüssel von Ailoot.	Nächster Schritt
Antwort403 · `permission_error`	BedingungDie Gruppe des API-Schlüssels ist für diese Medienroute nicht zugelassen.	Nächster Schritt
Antwort404 · `not_found_error`	BedingungDie ursprüngliche Aufgabe oder die angeforderte Ausgabe fehlt oder gehört nicht demselben Benutzer, API-Schlüssel und derselben Gruppe.	Nächster Schritt
Antwort502 · `result_pending_check`	BedingungDie ursprüngliche Einreichung oder der Status ist unvollständig oder lässt sich nicht abgleichen; bewahren Sie die ursprüngliche ID auf und reichen Sie den Auftrag nicht erneut ein.	Nächster Schritt
Antwort503 · `result_pending_check`	BedingungDie ursprüngliche Zuordnung, Route oder das Ihnen zugeordnete Medium wird noch geprüft; setzen Sie die Prüfung dieses ursprünglichen Vorgangs fort.	Nächster Schritt
Antwort503 · `server_error`	BedingungDer Mediendienst oder der Speicher der ursprünglichen Aufgaben ist nicht verfügbar.	Nächster Schritt

Aliasnamen

Modellaliasnamen

Ailoot Ultra dop-preview

Aliasnamen für Methodenpfade

/v1/videos/generations

Zugehörige Aufrufer-IDs

dop-preview

FAQ · Higgsfield: DOP Preview

Welche Eingaben und Ergebnisse sind verfügbar?: POST /v1/videos · dop-preview: image, text → video
Welche Felder verwendet die Anfrage?: POST /v1/videos · dop-preview: model, params, webhook, callback
Welche Grenzen gelten?: POST /v1/videos · dop-preview: params.motions[].strength.minimum: 0; params.motions[].strength.maximum: 1; params.seed.minimum: 1; params.seed.maximum: 1000000

Higgsfield: DOP Preview