Bruk vidu-q1-reference med model og prompt i /v1/videos. Forespørselen tilbyr image som en streng eller en liste med opptil ti strenger, end_image, aspect_ratio, duration og resolution. Velg fire eller åtte sekunder, 360p, 720p eller 1080p, og utsnitt på 16:9, 1:1 eller 9:16.
Beskriv en scene som holder referansemotivet gjenkjennelig. Når du legger ved bilder, angir du rollen til hver referanse og motivdetaljene som skal bevares. Gi handling og kameraregi separate instruksjoner, og definer deretter sluttpositur eller utsnitt. Behold de valgte bildene, instruksjonen og det valgfrie sluttbildet sammen med forespørselen, slik at den ferdige videoen kan sammenlignes med samme materiale.
Send inn opptaket én gang gjennom /v1/videos, og behold den returnerte forespørsels-ID-en. Poll den samme operasjonen gjennom /v1/videos/{request_id}, og lagre deretter alle ferdige videoutdata og hele svaret. Vurder hele handlingen og sluttkomposisjonen mot det vedlagte materialet og oppgavebeskrivelsen.
", "aboutText": "Bruk vidu-q1-reference med model og prompt i /v1/videos. Forespørselen tilbyr image som en streng eller en liste med opptil ti strenger, end_image, aspect_ratio, duration og resolution. Velg fire eller åtte sekunder, 360p, 720p eller 1080p, og utsnitt på 16:9, 1:1 eller 9:16.\n\nBeskriv en scene som holder referansemotivet gjenkjennelig. Når du legger ved bilder, angir du rollen til hver referanse og motivdetaljene som skal bevares. Gi handling og kameraregi separate instruksjoner, og definer deretter sluttpositur eller utsnitt. Behold de valgte bildene, instruksjonen og det valgfrie sluttbildet sammen med forespørselen, slik at den ferdige videoen kan sammenlignes med samme materiale.\n\nSend inn opptaket én gang gjennom /v1/videos, og behold den returnerte forespørsels-ID-en. Poll den samme operasjonen gjennom /v1/videos/{request_id}, og lagre deretter alle ferdige videoutdata og hele svaret. Vurder hele handlingen og sluttkomposisjonen mot det vedlagte materialet og oppgavebeskrivelsen.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "dc9fe7e76f2d078933ed72eb560e5521439c05262f78213a19722efed9bca29f", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nb", "methods": [ { "html": "vidu-q1-referenceVidu Q1 Reference kombinerer en skriftlig videobeskrivelse med valgfrie bildereferanser og et sluttbilde. Velg utsnitt, oppløsning og en varighet på fire eller åtte sekunder gjennom Ailoot.
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Bruk vidu-q1-reference med model og prompt i /v1/videos. Forespørselen tilbyr image som en streng eller en liste med opptil ti strenger, end_image, aspect_ratio, duration og resolution. Velg fire eller åtte sekunder, 360p, 720p eller 1080p, og utsnitt på 16:9, 1:1 eller 9:16.
Beskriv en scene som holder referansemotivet gjenkjennelig. Når du legger ved bilder, angir du rollen til hver referanse og motivdetaljene som skal bevares. Gi handling og kameraregi separate instruksjoner, og definer deretter sluttpositur eller utsnitt. Behold de valgte bildene, instruksjonen og det valgfrie sluttbildet sammen med forespørselen, slik at den ferdige videoen kan sammenlignes med samme materiale.
Send inn opptaket én gang gjennom /v1/videos, og behold den returnerte forespørsels-ID-en. Poll den samme operasjonen gjennom /v1/videos/{request_id}, og lagre deretter alle ferdige videoutdata og hele svaret. Vurder hele handlingen og sluttkomposisjonen mot det vedlagte materialet og oppgavebeskrivelsen.
POST /v1/videostext, imagevideo| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser vidu-q1-reference Vilkår: Bruk nøyaktig denne rutingsvelgeren for Ailoot. | Standard— |
Feltaspect_ratio | Typestring | KravValgfritt | Verdier & grenser 16:9, 1:1, 9:16 Vilkår: Bruk det dokumenterte feltet og de angitte alternativene for den valgte modellen; utelat en valgfri verdi som ikke er angitt. | Standard— |
Feltduration | Typeinteger | KravValgfritt | Verdier & grenser 4, 8 Vilkår: Bruk det dokumenterte feltet og de angitte alternativene for den valgte modellen; utelat en valgfri verdi som ikke er angitt. | Standard— |
Feltend_image | Typestring | KravValgfritt | Verdier & grenser Vilkår: Bruk det dokumenterte feltet og de angitte alternativene for den valgte modellen; utelat en valgfri verdi som ikke er angitt. | Standard— |
Feltimage | Typestring or array<string> | KravValgfritt | Verdier & grenser Vilkår: Oppgi bildets faktiske, tilgjengelige URL. En liste godtas bare der parameterskjemaet angir typen array. | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Vilkår: Bruk det dokumenterte feltet og de angitte alternativene for den valgte modellen; utelat en valgfri verdi som ikke er angitt. | Standard— |
Feltresolution | Typestring | KravValgfritt | Verdier & grenser 360p, 720p, 1080p Vilkår: Bruk det dokumenterte feltet og de angitte alternativene for den valgte modellen; utelat en valgfri verdi som ikke er angitt. | Standard— |
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt |
Parameteroptional | Avtaleaspect_ratio, duration, end_image, image, resolution |
Parametermaterial_types | Avtaletext, image |
Parameterconditions | AvtaleBruk nøyaktig denne rutingsvelgeren for Ailoot., Bruk det dokumenterte feltet og de angitte alternativene for den valgte modellen; utelat en valgfri verdi som ikke er angitt., Bruk det dokumenterte feltet og de angitte alternativene for den valgte modellen; utelat en valgfri verdi som ikke er angitt., Bruk det dokumenterte feltet og de angitte alternativene for den valgte modellen; utelat en valgfri verdi som ikke er angitt., Oppgi bildets faktiske, tilgjengelige URL. En liste godtas bare der parameterskjemaet angir typen array., Bruk det dokumenterte feltet og de angitte alternativene for den valgte modellen; utelat en valgfri verdi som ikke er angitt., Bruk det dokumenterte feltet og de angitte alternativene for den valgte modellen; utelat en valgfri verdi som ikke er angitt. |
Metodealiaser: /v1/videos/generations
Livssyklus: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Faktureringsmengde | Kostnad |
|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Faktureringsmengde— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonPer forespørsel | Prisplan— | Forventet mengde— | Faktureringsmengdeén forespørsel | Kostnad Inndata · Estimat kun for sammenligning $0.8 per forespørsel |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsmengde— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.8 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\n: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "vidu-q1-reference", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')\np['image']=os.environ['AILOOT_IMAGE_URL']\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\\x89PNG\\r\\n\\x1a\\n" else "jpg" if raw[:3]==b"\\xff\\xd8\\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nGET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Lagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Behold hele svaret og alle svarhoder, opprinnelige identifikatorer, alle faktiske utdata og alle felt for forbruk og avregning. Lagre hver unike ressurs du eier, og behold alle roller som viser til den.
Behold den returnerte offentlige oppgave- eller operasjons-ID-en og alle svarhoder. Les bare den opprinnelige oppgaven; unknown eller result_pending_check gir ikke tillatelse til en ny opprettelse.
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltpolling_url | Typestring |
Feltprovider_task_id | Typestring |
Felttask_id | Typestring |
Feltstatus | Typestring |
Feltvideo_url | Typestring |
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårEt obligatorisk felt, en modellvelger, en type eller en representasjon av inndata er ugyldig. | Neste trinnUndersøk de returnerte valideringsdetaljene før du forbereder en separat forespørsel. |
Svar | VilkårDen opprinnelige forespørselen eller resultatet er ukjent eller må kontrolleres. | Neste trinnBehold opprinnelige identifikatorer og hoder; les bare status- eller biblioteksposter som støttes. Ikke send opprettelsesforespørselen på nytt. |
Ailoot Ultra vidu-q1-reference
/v1/videos/generations