Higgsfield: DOP Lite
DOP Lite animuje dostarczony obraz przy użyciu udokumentowanych szablonów ruchu, regulowanej intensywności i opisu tekstowego. Dokładny identyfikator dop-lite korzysta z żądania generowania wideo z obrazu i zwraca wideo przez zadanie asynchroniczne.
O modelu
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
DOP Lite animuje dostarczone obrazy w udokumentowanym procesie generowania wideo z obrazu firmy Higgsfield. Dokładny identyfikator to dop-lite. Użyj dop-lite jako wyboru w polu model na najwyższym poziomie oraz jako wartości pola model w udokumentowanym obiekcie params. Obraz dostarcza materiał wizualny, a szablony ruchu i opis tekstowy sterują żądanym ruchem i efektem.
Przygotuj obraz referencyjny, na którym zamierzony główny obiekt, ważne szczegóły i otaczająca przestrzeń są czytelne. Przewodnik zaleca obraz o wysokiej rozdzielczości dla wyraźniejszych szczegółów. W scenie produktowej wybierz widok pokazujący kształt przedmiotu i powierzchnie, które mają pozostać rozpoznawalne podczas ruchu. W przypadku postaci lub otoczenia wskaż cechę wizualną, którą ruch powinien podkreślić. Podaj rzeczywisty adres URL obrazu referencyjnego przez wejście obrazu użyte w przykładzie metody.
Dokumentacja operacji przewiduje jeden lub dwa szablony ruchu. Gdy podano dwa, przewodnik opisuje połączenie ich efektów. Opisy gotowych ustawień obejmują ruch kamery, obrót obiektu i przemiany wizualne; na przykład Dolly In opisuje zbliżenie kamery, a 3D Rotation obrót postaci lub produktu w miejscu. Wybierz udokumentowane identyfikatory szablonów pasujące do zamierzonej sekwencji i zachowaj każdy identyfikator wraz z wartością intensywności.
Intensywność ruchu jest liczbą od 0 do 1, a udokumentowana wartość domyślna wynosi 0.8. Przewodnik opisuje 0.3 jako subtelny efekt, a 1 jako silny ruch. Dobierz intensywność do szczegółu, który powinien pozostać czytelny, i sprawdź cały wygenerowany ruch. Opis ruchu i intensywność mają różne zadania: szablon wybiera efekt, a intensywność określa jego siłę.
Zgodnie z opisem pole prompt musi występować, ale pusty ciąg znaków jest dozwolony. Dla efektów opartych na szablonach przewodnik zaleca pozostawienie pola prompt pustego; jeśli podajesz tekst, zaleca dołączenie opisu szablonu, ponieważ prompt może znacznie zmienić wynik. Parametr enhance_prompt włącza optymalizację zawartości pola prompt i zgodnie z dokumentacją ma domyślną wartość true. Porównując wersje, zachowaj tekst i to ustawienie wraz z obrazem referencyjnym i wybranymi szablonami.
Parametr seed przyjmuje liczbę całkowitą od 1 do 1000000. Zapisz wybraną wartość seed wraz z ustawieniami generowania. Żądanie udostępnia również pole seconds typu całkowitego; zachowaj użytą wartość wraz z powstałym klipem i sprawdź jego rzeczywisty przebieg w czasie oraz kadrowanie. Wartość logiczna check_nsfw włącza udokumentowany filtr treści i domyślnie wynosi true. Te ustawienia należą do żądania generowania wideo z obrazu i powinny pozostać powiązane z dokładnie wybranym modelem.
Generowanie jest asynchroniczne. Zachowaj zwrócony identyfikator zadania podczas korzystania ze skonfigurowanego zapytania o stan i wynik. Mapowanie ukończenia odczytuje ukończone wpisy zadań i adresy URL ich wyników raw. Zapisz każdy ukończony wynik wideo i zachowaj identyfikator jego zadania wraz ze zwróconym adresem URL, utrzymując wszystkie ukończone wpisy razem jako wynik jednej operacji.
Sprawdź całe wideo względem dostarczonego obrazu, wybranego efektu i opisu tekstowego: wygląd obiektu, ruch, kadrowanie i końcowy widok. Przy poprawce wskaż konkretny szczegół wizualny do zmiany i zachowaj udane części żądania. Przechowuj razem pierwotne odwołanie do obrazu, dokładny identyfikator, prompt, identyfikatory ruchu, intensywności, seed, żądane ustawienia i ukończone materiały, aby następne porównanie opierało się na rzeczywistym wyniku generowania.
Ailoot Ultra · Wideo POST /v1/videos dop-lite
dop-liteStart
DOP Lite animuje dostarczony obraz przy użyciu udokumentowanych szablonów ruchu, regulowanej intensywności i opisu tekstowego. Dokładny identyfikator dop-lite korzysta z żądania generowania wideo z obrazu i zwraca wideo przez zadanie asynchroniczne.
- Akceptowane dane wejściowe
- Obrazy · Tekst
- Wyniki
- Wideo
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · Wideo POST /v1/videos
- Wejście
image,text- Wyjście
video
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity dop-lite Warunki: Selektor modelu Ailoot. | Domyślnie— |
Poleparams | Typobject | WymaganieWymagane | Wartości i limity Warunki: Parametry generowania wideo z obrazu; zachowaj tę strukturę. | Domyślnie— |
Poleparams.model | Typstring | WymaganieWymagane | Wartości i limity dop-lite Warunki: Użyj tego samego selektora co w polu model na najwyższym poziomie. | Domyślnie— |
Poleparams.prompt | Typstring | WymaganieWymagane | Wartości i limity Warunki: Zachowaj obecność tego pola; dokumentacja dopuszcza pusty ciąg znaków. Wskazówki tekstowe silnie wpływają na wybrany efekt ruchu. | Domyślnie— |
Poleparams.seconds | Typinteger | WymaganieOpcjonalne | Wartości i limity Warunki: Żądany czas trwania; nie wskazano udokumentowanego zakresu ani wartości domyślnej. | Domyślnie— |
Poleparams.motions | Typarray | WymaganieOpcjonalne | Wartości i limity Warunki: Wybierz jeden lub dwa udokumentowane szablony ruchu. | Domyślnie— |
Poleparams.motions[].id | Typstring | WymaganieWymagane | Wartości i limity Warunki: Identyfikator ruchu w udokumentowanym działającym przykładzie żądania. | Domyślnie— |
Poleparams.motions[].strength | Typnumber | WymaganieWymagane | Wartości i limity Minimum: 0 Maksimum: 1 Warunki: Intensywność ruchu: 0.3 opisano jako subtelną, a 1 jako silną. | Domyślnie0,8 |
Poleparams.input_images | Typarray | WymaganieOpcjonalne | Wartości i limity Warunki: Obrazy referencyjne w tablicy obiektów image_url pokazanej w działającym przykładzie. | Domyślnie— |
Poleparams.input_images[].type | Typstring | WymaganieWymagane | Wartości i limity image_url Warunki: Reprezentacja danych referencyjnych. | Domyślnie— |
Poleparams.input_images[].image_url | Typstring | WymaganieWymagane | Wartości i limity Warunki: Rzeczywisty, dostępny URL Twojego obrazu referencyjnego. | Domyślnie— |
Poleparams.enhance_prompt | Typboolean | WymaganieOpcjonalne | Wartości i limity Warunki: Ulepszanie promptu. | Domyślnietrue |
Poleparams.check_nsfw | Typboolean | WymaganieOpcjonalne | Wartości i limity Warunki: Filtrowanie treści. | Domyślnietrue |
Poleparams.seed | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 1 Maksimum: 1 000 000 Warunki: Ziarno losowości zapewniające spójność wyników. | Domyślnie— |
Polewebhook | Typobject | WymaganieOpcjonalne | Wartości i limity Warunki: Opcjonalne udokumentowane ustawienia webhook; pobieranie wyników należących do użytkownika odbywa się przez ścieżki zadań Ailoot. | Domyślnie— |
Polewebhook.url | Typstring | WymaganieOpcjonalne | Wartości i limity Warunki: URL Twojego odbiorcy. | Domyślnie— |
Polewebhook.secret | Typstring | WymaganieOpcjonalne | Wartości i limity Warunki: Sekret Twojego odbiorcy. | Domyślnie— |
Polecallback | Typstring | WymaganieOpcjonalne | Wartości i limity Warunki: Opcjonalny odbiorca callback; zgodnie z dokumentacją odbiorca odpowiada kodem HTTP 200. | Domyślnie— |
Kombinacje materiałów wejściowych
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, params |
Parametroptional | Kontraktparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Parametrmaterial_types | Kontraktimage, text |
Parametradditional_properties | Kontrakttrue |
Parametrvalidation_scope | KontraktModel określa routing żądania; struktura parameters odpowiada pokazanemu żądaniu generowania wideo z obrazu. |
Aliasy metody: /v1/videos/generations
Cykl życia: 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
Użyj tego samego selektora modelu na najwyższym poziomie i wewnątrz params.
Utwórz raz, a następnie używaj zwróconego publicznego id i polling_url dla pierwotnej operacji.
Pobierz wszystkie ukończone wideo należące do użytkownika; sprawdź rzeczywisty czas trwania i wymiary w wyniku.
Zastąp YOUR_ACCESSIBLE_IMAGE_URL w przykładzie rzeczywistym adresem URL swojego obrazu referencyjnego.
Cennik
Jak obliczana jest ostateczna opłata
Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
- Tryb szybki
- Nie określono Gdy wybrany jest tryb szybki
- Tryb flex
- Nie określono Gdy wybrany jest tryb flex
- Maksymalna intensywność rozumowania
- Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
Szacunkowe stawki do porównania
Ceny według konfiguracji
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Przewidywana ilość | Opłata |
|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów |
| KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $1.24 szacunek przed generowaniem Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie. |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
Ailoot Ultra · Wideo
{
"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
Odbieranie i zapisywanie wyników
Ailoot Ultra · Wideo
Zachowaj zwrócone zadania i ich stany. Odczytaj wszystkie ukończone wyniki wideo należące do użytkownika.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Zachowaj wszystkie ukończone wyniki
Zapisz każde ukończone wideo lub zwrócony plik; pobierz każdy faktycznie zwrócony URL zasobu.
Pobierz każdy rzeczywisty ukończony wynik; nie zakładaj stałej liczby.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Zachowaj oryginalną odpowiedź i zwróconą tożsamość zadania; nierozpoznany stan ani niejednoznaczne wysłanie nie uprawniają do nowego utworzenia.
Pola odpowiedzi
| Pole | Typ | Znaczenie |
|---|---|---|
Poleid | Typstring | ZnaczeniePubliczny identyfikator zadania lub operacji Ailoot. |
Poleprovider_task_id | Typstring | ZnaczeniePierwotny identyfikator zadania, odrębny od publicznego id. |
Polepolling_url | Typstring | ZnaczenieZwrócona ścieżka odczytu Ailoot. |
Polejobs[].id | Typstring | ZnaczenieFaktycznie zwrócony identyfikator zadania. |
Polejobs[].status | Typstring | ZnaczenieStan każdego zwróconego zadania. |
Polejobs[].results.raw.url | Typstring | ZnaczenieKażde ukończone wideo jest udostępniane przez podpisany URL należący do Ailoot. |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekNieprawidłowy JSON/model lub nieprawidłowy indeks treści. | Następny krok |
Odpowiedź401 · authentication_error | WarunekNieprawidłowy klucz API Ailoot. | Następny krok |
Odpowiedź403 · permission_error | WarunekGrupa klucza API nie ma uprawnień do tej ścieżki multimedialnej. | Następny krok |
Odpowiedź404 · not_found_error | WarunekPierwotne zadanie lub żądany wynik nie istnieje albo nie należy do tego samego użytkownika, klucza API lub grupy. | Następny krok |
Odpowiedź502 · result_pending_check | WarunekPierwotne wysłanie lub sprawdzenie statusu jest niekompletne albo nie można uzgodnić jego wyniku; zachowaj pierwotny identyfikator i nie wysyłaj żądania ponownie. | Następny krok |
Odpowiedź503 · result_pending_check | WarunekPowiązanie pierwotnego żądania, ścieżka lub multimedia należące do użytkownika są nadal sprawdzane; kontynuuj sprawdzanie tej pierwotnej operacji. | Następny krok |
Odpowiedź503 · server_error | WarunekUsługa multimedialna lub magazyn pierwotnych zadań są niedostępne. | Następny krok |
Aliasy
Aliasy modelu
Ailoot Ultra dop-lite
Aliasy ścieżek metod
/v1/videos/generations
Powiązane ID modeli
FAQ · Higgsfield: DOP Lite
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/videos·dop-lite:image,text→video- Jakich pól używa żądanie?
POST /v1/videos·dop-lite:model,params,webhook,callback- Jakie limity obowiązują?
POST /v1/videos·dop-lite:params.motions[].strength.minimum:0;params.motions[].strength.maximum:1;params.seed.minimum:1;params.seed.maximum:1000000