Higgsfield: DOP Lite
DOP Lite animiert ein bereitgestelltes Bild mit dokumentierten Bewegungsvorlagen, einstellbarer Stärke und schriftlichen Vorgaben. Die konkrete Modellauswahl dop-lite nutzt die Bild-zu-Video-Anfrage und liefert das Video über eine asynchrone Aufgabe.
Ü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 Lite animiert bereitgestelltes Bildmaterial über den von Higgsfield dokumentierten Bild-zu-Video-Arbeitsablauf. Die konkrete Modellkennung ist dop-lite. Verwenden Sie dop-lite 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 außerdem 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äßig 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 · Videos POST /v1/videos dop-lite
dop-liteEinstieg
DOP Lite animiert ein bereitgestelltes Bild mit dokumentierten Bewegungsvorlagen, einstellbarer Stärke und schriftlichen Vorgaben. Die konkrete Modellauswahl dop-lite nutzt die Bild-zu-Video-Anfrage und liefert das Video über eine asynchrone Aufgabe.
- Zulässige Eingaben
- Bilder · Text
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Videos POST /v1/videos
- Eingabe
image,text- Ausgabe
video
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits dop-lite Bedingungen: Ailoot-Modellauswahl. | Standard— |
Feldparams | Typobject | AnforderungErforderlich | Werte und Limits Bedingungen: Parameter für Bild-zu-Video; behalten Sie diese äußere Struktur bei. | Standard— |
Feldparams.model | Typstring | AnforderungErforderlich | Werte und Limits dop-lite Bedingungen: Verwenden Sie dieselbe Auswahl wie für model auf oberster Ebene. | Standard— |
Feldparams.prompt | Typstring | AnforderungErforderlich | Werte und Limits Bedingungen: Behalten Sie dieses Feld bei; eine leere Zeichenfolge ist dokumentiert. Schriftliche Anweisungen beeinflussen den ausgewählten Bewegungseffekt stark. | Standard— |
Feldparams.seconds | Typinteger | AnforderungOptional | Werte und Limits Bedingungen: Angeforderte Dauer; es wird weder ein dokumentierter Bereich noch ein Standardwert zugesichert. | Standard— |
Feldparams.motions | Typarray | AnforderungOptional | Werte und Limits Bedingungen: Wählen Sie eine oder zwei dokumentierte Bewegungsvorlagen. | Standard— |
Feldparams.motions[].id | Typstring | AnforderungErforderlich | Werte und Limits Bedingungen: Bewegungskennung aus dem dokumentierten funktionierenden Anfragebeispiel. | Standard— |
Feldparams.motions[].strength | Typnumber | AnforderungErforderlich | Werte und Limits Minimum: 0 Maximum: 1 Bedingungen: Bewegungsintensität: 0.3 wird als dezent und 1 als stark beschrieben. | Standard0,8 |
Feldparams.input_images | Typarray | AnforderungOptional | Werte und Limits Bedingungen: Referenzbilder mit dem Array aus image_url-Objekten, das im funktionierenden Beispiel gezeigt wird. | Standard— |
Feldparams.input_images[].type | Typstring | AnforderungErforderlich | Werte und Limits image_url Bedingungen: Darstellung der Referenz. | Standard— |
Feldparams.input_images[].image_url | Typstring | AnforderungErforderlich | Werte und Limits Bedingungen: Die URL Ihres tatsächlichen, erreichbaren Referenzbildes. | Standard— |
Feldparams.enhance_prompt | Typboolean | AnforderungOptional | Werte und Limits Bedingungen: Prompt-Verbesserung. | Standardtrue |
Feldparams.check_nsfw | Typboolean | AnforderungOptional | Werte und Limits Bedingungen: Inhaltsfilterung. | Standardtrue |
Feldparams.seed | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 1 000 000 Bedingungen: Startwert für konsistente Ausgaben. | Standard— |
Feldwebhook | Typobject | AnforderungOptional | Werte und Limits Bedingungen: Optionale dokumentierte webhook-Einstellungen; der Abruf der Ihnen zugeordneten Ergebnisse verwendet die Ailoot-Aufgabenpfade. | Standard— |
Feldwebhook.url | Typstring | AnforderungOptional | Werte und Limits Bedingungen: Die URL Ihres Empfängers. | Standard— |
Feldwebhook.secret | Typstring | AnforderungOptional | Werte und Limits Bedingungen: Ihr Empfängergeheimnis. | Standard— |
Feldcallback | Typstring | 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 |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, params |
Parameteroptional | Vertragparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Parametermaterial_types | Vertragimage, text |
Parameteradditional_properties | Vertragtrue |
Parametervalidation_scope | VertragDas Modell bestimmt die Route der Anfrage; die äußere 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 den 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 Ihre tatsächliche Referenzbild-URL.
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 |
|---|---|---|---|
| KonfigurationBasistarife für Tokens | 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 · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationGeschätzte Generierungskosten | 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 abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Videos
{
"model": "dop-lite",
"params": {
"model": "dop-lite",
"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 · Videos
Bewahren Sie die zurückgegebenen Aufträge und deren Zustände auf. Lesen Sie jedes fertiggestellte, Ihnen zugeordnete Videoergebnis.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /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 die zurückgegebene Aufgabenkennung auf; ein unbekannter Zustand oder eine unklare Übermittlung berechtigt nicht zu einer neuen Erstellung.
Antwortfelder
| Feld | Typ | Bedeutung |
|---|---|---|
Feldid | Typstring | BedeutungÖffentliche Ailoot-Aufgaben- oder Vorgangskennung. |
Feldprovider_task_id | Typstring | BedeutungUrsprüngliche Aufgabenkennung, getrennt von der öffentlichen id. |
Feldpolling_url | Typstring | BedeutungZurückgegebener Ailoot-Abfragepfad. |
Feldjobs[].id | Typstring | BedeutungTatsächlich zurückgegebene Auftragskennung. |
Feldjobs[].status | Typstring | BedeutungZustand jedes zurückgegebenen Auftrags. |
Feldjobs[].results.raw.url | Typstring | BedeutungJedes fertiggestellte Video wird über eine signierte URL im Eigentum 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 Ailoot API-Schlüssel. | 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 ist nicht demselben Benutzer/API-Schlüssel/derselben Gruppe zugeordnet. | Nächster Schritt |
Antwort502 · result_pending_check | BedingungDie ursprüngliche Übermittlung oder der Status ist unvollständig oder lässt sich nicht abgleichen; bewahren Sie die ursprüngliche ID auf und übermitteln Sie die Anfrage nicht erneut. | Nächster Schritt |
Antwort503 · result_pending_check | BedingungDie ursprüngliche Zuordnung, Route oder die Ihnen zugeordneten Medien werden 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 Aufgabe ist nicht verfügbar. | Nächster Schritt |
Aliasnamen
Modellaliasnamen
Ailoot Ultra dop-lite
Aliasnamen für Methodenpfade
/v1/videos/generations
Zugehörige Aufrufer-IDs
FAQ · Higgsfield: DOP Lite
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·dop-lite:image,text→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·dop-lite:model,params,webhook,callback- Welche Grenzen gelten?
POST /v1/videos·dop-lite:params.motions[].strength.minimum:0;params.motions[].strength.maximum:1;params.seed.minimum:1;params.seed.maximum:1000000