Seleziona wan2.7-r2v su /v1/videos. La sua richiesta espone prompt, negative_prompt, image, reference_images, reference_voice, prompt_extend e watermark. resolution offre 720P o 1080P, ratio copre orizzontale, verticale, quadrato, 4:3 e 3:4, mentre duration accetta secondi interi da due a quindici.
Spiega cosa deve stabilire ciascun riferimento fornito e cosa deve fare l’inquadratura. Identifica separatamente aspetto del soggetto, ambiente, movimento e composizione finale. Mantieni i valori di reference_images e reference_voice nel formato documentato dei rispettivi campi insieme ai file sorgente. Per una sequenza, rendi chiari ordine previsto e continuità, così che il video completato abbia un obiettivo concreto di verifica.
Invia l’inquadratura una sola volta tramite /v1/videos e conserva l’ID della richiesta restituito. Interroga periodicamente la stessa operazione tramite /v1/videos/{request_id}, quindi salva tutti i video completati e la risposta completa. Verifica l’intera azione e la composizione finale rispetto al materiale fornito e al brief.
", "aboutText": "Seleziona wan2.7-r2v su /v1/videos. La sua richiesta espone prompt, negative_prompt, image, reference_images, reference_voice, prompt_extend e watermark. resolution offre 720P o 1080P, ratio copre orizzontale, verticale, quadrato, 4:3 e 3:4, mentre duration accetta secondi interi da due a quindici.\n\nSpiega cosa deve stabilire ciascun riferimento fornito e cosa deve fare l’inquadratura. Identifica separatamente aspetto del soggetto, ambiente, movimento e composizione finale. Mantieni i valori di reference_images e reference_voice nel formato documentato dei rispettivi campi insieme ai file sorgente. Per una sequenza, rendi chiari ordine previsto e continuità, così che il video completato abbia un obiettivo concreto di verifica.\n\nInvia l’inquadratura una sola volta tramite /v1/videos e conserva l’ID della richiesta restituito. Interroga periodicamente la stessa operazione tramite /v1/videos/{request_id}, quindi salva tutti i video completati e la risposta completa. Verifica l’intera azione e la composizione finale rispetto al materiale fornito e al brief.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "ac947b11a0c3143369bc911656fc85e655042d9fff2ea15b88fc08191933c772", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "wan2.7-r2vWan 2.7 R2V espone i campi image, reference_images e reference_voice per un brief video guidato da riferimenti. Scegli durata, risoluzione e ratio, quindi recupera il risultato Ailoot originale.
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
Seleziona wan2.7-r2v su /v1/videos. La sua richiesta espone prompt, negative_prompt, image, reference_images, reference_voice, prompt_extend e watermark. resolution offre 720P o 1080P, ratio copre orizzontale, verticale, quadrato, 4:3 e 3:4, mentre duration accetta secondi interi da due a quindici.
Spiega cosa deve stabilire ciascun riferimento fornito e cosa deve fare l’inquadratura. Identifica separatamente aspetto del soggetto, ambiente, movimento e composizione finale. Mantieni i valori di reference_images e reference_voice nel formato documentato dei rispettivi campi insieme ai file sorgente. Per una sequenza, rendi chiari ordine previsto e continuità, così che il video completato abbia un obiettivo concreto di verifica.
Invia l’inquadratura una sola volta tramite /v1/videos e conserva l’ID della richiesta restituito. Interroga periodicamente la stessa operazione tramite /v1/videos/{request_id}, quindi salva tutti i video completati e la risposta completa. Verifica l’intera azione e la composizione finale rispetto al materiale fornito e al brief.
POST /v1/videostext, imagevideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti wan2.7-r2v Condizioni: Usa esattamente questo selettore di instradamento di Ailoot. | Predefinito— |
Campoprompt | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito |
Camponegative_prompt | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito |
Camporesolution | Tipostring | RequisitoFacoltativo | Valori e limiti 720P, 1080P Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
Camporatio | Tipostring | RequisitoFacoltativo | Valori e limiti 16:9, 9:16, 1:1, 4:3, 3:4 Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
Campoduration | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: 2 Massimo: 15 Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
Campoprompt_extend | Tipoboolean | RequisitoFacoltativo | Valori e limiti Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
Campowatermark | Tipoboolean | RequisitoFacoltativo | Valori e limiti Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
Campoimage | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
Camporeference_images | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
Camporeference_voice | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel |
Parametrooptional | Contrattoprompt, negative_prompt, resolution, ratio, duration, prompt_extend, watermark, image, reference_images, reference_voice |
Parametromaterial_types | Contrattotext, image |
Parametroconditions | ContrattoUsa esattamente questo selettore di instradamento di Ailoot., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. |
Alias del metodo: /v1/videos/generations
Ciclo di vita: 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}
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Risoluzione di output | Unità di fatturazione | Condizioni di fatturazione | Costo |
|---|---|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Risoluzione di output— | Unità di fatturazione— | Condizioni di fatturazione— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazioneVideo in uscita | Listino delle tariffe— | Quantità prevista— | Risoluzione di output1080P | Unità di fatturazioneper secondo di video | Condizioni di fatturazioneStima indicativa del video in uscita alla risoluzione 1080P. L’importo finale addebitato è calcolato in base alla fattura originale registrata. | Costo Output · Video in uscita · Stima solo a fini di confronto $0.3 per secondo di video Stima puramente indicativa; l’importo finale addebitato è calcolato in base alla fattura originale registrata. |
| ConfigurazioneVideo in uscita | Listino delle tariffe— | Quantità prevista— | Risoluzione di output720P | Unità di fatturazioneper secondo di video | Condizioni di fatturazioneStima indicativa del video in uscita alla risoluzione 720P. L’importo finale addebitato è calcolato in base alla fattura originale registrata. | Costo Output · Video in uscita · Stima solo a fini di confronto $0.2 per secondo di video Stima puramente indicativa; l’importo finale addebitato è calcolato in base alla fattura originale registrata. |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Risoluzione di output— | Unità di fatturazione— | Condizioni di fatturazione— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $0.2 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
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": "wan2.7-r2v", "reference_images": "YOUR_ACCESSIBLE_IMAGE_URL"}')\np['reference_images']=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}Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
Conserva la risposta completa e le intestazioni, gli identificatori originali, ogni risultato effettivo e tutti i campi di utilizzo e contabilizzazione. Salva ogni risorsa univoca di tua proprietà e conserva ogni ruolo che vi fa riferimento.
Conserva l'id pubblico dell'attività o dell'operazione restituito e tutte le intestazioni. Consulta solo l'attività originale; unknown o result_pending_check non autorizza un'altra creazione.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campopolling_url | Tipostring |
Campoprovider_task_id | Tipostring |
Campotask_id | Tipostring |
Campostatus | Tipostring |
Campovideo_url | Tipostring |
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneUn campo obbligatorio, il selettore del modello, il tipo o la rappresentazione dei dati in ingresso non è valido. | Passaggio successivoEsamina i dettagli di validazione restituiti prima di preparare una richiesta separata. |
Risposta | CondizioneLa richiesta originale o il relativo risultato è sconosciuto o richiede una verifica. | Passaggio successivoConserva gli identificatori e le intestazioni originali; consulta solo i record di stato o della libreria supportati. Non inviare di nuovo la richiesta di creazione. |
Ailoot Ultra wan2.7-r2v
/v1/videos/generations