Wan2.7-Image crea immagini da un'istruzione testuale. L'attuale scheda Ailoot presenta precisamente input testuale e un risultato sotto forma di immagine. Secondo Alibaba, questa versione è orientata a ottenere varianti più rapidamente. Le specifiche del produttore prevedono anche modifica, combinazione di riferimenti e interventi locali; richiedono un supporto separato delle immagini in ingresso, non rappresentato dal metodo attuale della scheda.
Per la modalità con riferimenti, Alibaba prevede fino a nove immagini iniziali nell'istruzione. Servono da base per l'aspetto dell'oggetto, la composizione e i dettagli. Il modello può riunire più materiali in una nuova scena oppure modificare l'immagine originale conservando l'oggetto principale. Per la modifica mirata sono previste aree indicate esplicitamente: in un'immagine si possono individuare fino a due regioni rettangolari.
Nelle specifiche di Alibaba, la modalità ordinaria produce da uno a quattro risultati. Una serie sequenziale permette di richiedere fino a 12 immagini collegate da una storia o da caratteristiche comuni dei personaggi. Per la serie è un limite superiore: il modello determina autonomamente il numero necessario di fotogrammi e può restituirne meno. L'istruzione e il materiale iniziale aiutano a mantenere una trama comune.
Per la normale generazione da testo, senza riferimenti né una serie sequenziale, è prevista una modalità di ragionamento. Il modello analizza così più a fondo una descrizione complessa prima di creare l'immagine. Questa modalità non si applica alla modifica basata su immagini né alle serie sequenziali. Una palette definita di 3–10 colori è disponibile al di fuori delle serie sequenziali.
Nelle modalità con immagini iniziali, presso il produttore sono supportati JPEG, JPG, PNG senza trasparenza, BMP e WEBP. Ogni lato può avere da 240 a 8000 pixel, il file può arrivare a 20 MB e le proporzioni vanno da 1:8 a 8:1.
L'istruzione testuale supporta cinese e inglese ed è limitata a 5000 caratteri; la parte in eccesso viene scartata. Questa versione non prevede una descrizione negativa né un'ulteriore espansione dell'istruzione.
Il formato di uscita è PNG, con risoluzione fino al livello 2K. L'indicazione riguarda l'area complessiva in pixel, non una lunghezza massima fissa del lato; la forma può essere scelta nell'intervallo da 1:8 a 8:1. Nella modifica con una risoluzione preimpostata, il risultato mantiene le proporzioni dell'ultimo riferimento. Lo stesso seme casuale iniziale aiuta a ottenere varianti simili, ma non garantisce una corrispondenza completa.
", "aboutText": "Wan2.7-Image crea immagini da un'istruzione testuale. L'attuale scheda Ailoot presenta precisamente input testuale e un risultato sotto forma di immagine. Secondo Alibaba, questa versione è orientata a ottenere varianti più rapidamente. Le specifiche del produttore prevedono anche modifica, combinazione di riferimenti e interventi locali; richiedono un supporto separato delle immagini in ingresso, non rappresentato dal metodo attuale della scheda.\n\n### Le modalità descritte da Alibaba\n\nPer la modalità con riferimenti, Alibaba prevede fino a nove immagini iniziali nell'istruzione. Servono da base per l'aspetto dell'oggetto, la composizione e i dettagli. Il modello può riunire più materiali in una nuova scena oppure modificare l'immagine originale conservando l'oggetto principale. Per la modifica mirata sono previste aree indicate esplicitamente: in un'immagine si possono individuare fino a due regioni rettangolari.\n\nNelle specifiche di Alibaba, la modalità ordinaria produce da uno a quattro risultati. Una serie sequenziale permette di richiedere fino a 12 immagini collegate da una storia o da caratteristiche comuni dei personaggi. Per la serie è un limite superiore: il modello determina autonomamente il numero necessario di fotogrammi e può restituirne meno. L'istruzione e il materiale iniziale aiutano a mantenere una trama comune.\n\nPer la normale generazione da testo, senza riferimenti né una serie sequenziale, è prevista una modalità di ragionamento. Il modello analizza così più a fondo una descrizione complessa prima di creare l'immagine. Questa modalità non si applica alla modifica basata su immagini né alle serie sequenziali. Una palette definita di 3–10 colori è disponibile al di fuori delle serie sequenziali.\n\n### Input e risultato\n\nNelle modalità con immagini iniziali, presso il produttore sono supportati JPEG, JPG, PNG senza trasparenza, BMP e WEBP. Ogni lato può avere da 240 a 8000 pixel, il file può arrivare a 20 MB e le proporzioni vanno da 1:8 a 8:1.\n\nL'istruzione testuale supporta cinese e inglese ed è limitata a 5000 caratteri; la parte in eccesso viene scartata. Questa versione non prevede una descrizione negativa né un'ulteriore espansione dell'istruzione.\n\nIl formato di uscita è PNG, con risoluzione fino al livello 2K. L'indicazione riguarda l'area complessiva in pixel, non una lunghezza massima fissa del lato; la forma può essere scelta nell'intervallo da 1:8 a 8:1. Nella modifica con una risoluzione preimpostata, il risultato mantiene le proporzioni dell'ultimo riferimento. Lo stesso seme casuale iniziale aiuta a ottenere varianti simili, ma non garantisce una corrispondenza completa.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "e64f5f7b4f2166bef86247ac17daefaabc0fa3fae819711a398bc803d6563b8a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "wan2.7-imageModello per generare immagini da testo e preparare varianti di design e illustrazioni. Secondo Alibaba, questa versione è orientata a una generazione più rapida delle immagini.
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.
Wan2.7-Image crea immagini da un'istruzione testuale. L'attuale scheda Ailoot presenta precisamente input testuale e un risultato sotto forma di immagine. Secondo Alibaba, questa versione è orientata a ottenere varianti più rapidamente. Le specifiche del produttore prevedono anche modifica, combinazione di riferimenti e interventi locali; richiedono un supporto separato delle immagini in ingresso, non rappresentato dal metodo attuale della scheda.
Per la modalità con riferimenti, Alibaba prevede fino a nove immagini iniziali nell'istruzione. Servono da base per l'aspetto dell'oggetto, la composizione e i dettagli. Il modello può riunire più materiali in una nuova scena oppure modificare l'immagine originale conservando l'oggetto principale. Per la modifica mirata sono previste aree indicate esplicitamente: in un'immagine si possono individuare fino a due regioni rettangolari.
Nelle specifiche di Alibaba, la modalità ordinaria produce da uno a quattro risultati. Una serie sequenziale permette di richiedere fino a 12 immagini collegate da una storia o da caratteristiche comuni dei personaggi. Per la serie è un limite superiore: il modello determina autonomamente il numero necessario di fotogrammi e può restituirne meno. L'istruzione e il materiale iniziale aiutano a mantenere una trama comune.
Per la normale generazione da testo, senza riferimenti né una serie sequenziale, è prevista una modalità di ragionamento. Il modello analizza così più a fondo una descrizione complessa prima di creare l'immagine. Questa modalità non si applica alla modifica basata su immagini né alle serie sequenziali. Una palette definita di 3–10 colori è disponibile al di fuori delle serie sequenziali.
Nelle modalità con immagini iniziali, presso il produttore sono supportati JPEG, JPG, PNG senza trasparenza, BMP e WEBP. Ogni lato può avere da 240 a 8000 pixel, il file può arrivare a 20 MB e le proporzioni vanno da 1:8 a 8:1.
L'istruzione testuale supporta cinese e inglese ed è limitata a 5000 caratteri; la parte in eccesso viene scartata. Questa versione non prevede una descrizione negativa né un'ulteriore espansione dell'istruzione.
Il formato di uscita è PNG, con risoluzione fino al livello 2K. L'indicazione riguarda l'area complessiva in pixel, non una lunghezza massima fissa del lato; la forma può essere scelta nell'intervallo da 1:8 a 8:1. Nella modifica con una risoluzione preimpostata, il risultato mantiene le proporzioni dell'ultimo riferimento. Lo stesso seme casuale iniziale aiuta a ottenere varianti simili, ma non garantisce una corrispondenza completa.
POST /v1/images/generationstextimage| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti wan2.7-image | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 | Predefinito— |
Campon | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: 1 | Predefinito1 |
Camporesponse_format | Tipostring | RequisitoFacoltativo | Valori e limiti url, b64_json | Predefinito— |
Campostream | Tipoboolean | RequisitoFacoltativo | Valori e limiti | Predefinitofalse |
Camposize | Tipostring | RequisitoFacoltativo | Valori e limiti Dipende dal modello | Predefinito— |
Campopartial_images | Tipointeger | RequisitoFacoltativo | Valori e limiti Dipende dal modello | Predefinito— |
Campoimages[].image_url | Tipostring | RequisitoNon supportato | Valori e limiti Numero massimo di byte decodificati: 20.971.520 Tipi MIME: image/png, image/jpeg Numero massimo di immagini per array: 9 Condizioni: Un URL effettivo per ogni oggetto images[]. Il numero di elementi dell'array è distinto da questo nodo foglia di tipo stringa. Si applica quando: Solo JSON images/edits; JSON images/generations non analizza i riferimenti images. | Predefinito— |
Campoimage | Tipofile | RequisitoFacoltativo | Valori e limiti Numero massimo di byte decodificati: 20.971.520 Tipi MIME: image/png, image/jpeg Si applica quando: generazione con multipart/form-data | Predefinito— |
Campoimage[] | Tipofile[] | RequisitoFacoltativo | Valori e limiti Numero massimo di elementi: 9 Numero massimo di byte decodificati: 20.971.520 Tipi MIME: image/png, image/jpeg Si applica quando: generazione con multipart/form-data | Predefinito— |
Da testo a immagine · Obbligatorio: prompt
reference_images_generation · Obbligatorio: prompt
| Parametro | Contratto |
|---|---|
Parametromaterial_types | Contrattotext |
Parametrorequired | Contrattomodel, prompt |
Parametrooptional_controls | Contrattonull |
Parametrocontent_type | Contrattoapplication/json |
Ciclo di vita: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effettivamente restituito o record della libreria multimediale
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Le strutture dei metodi e gli ID sono esatti; la capacità del fornitore è distinta dall’ammissione delle richieste.
POST /v1/images/generationsAiloot 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 →
I listini di riferimento del modello non modificano la selezione del metodo, i preventivi o gli addebiti. Gli addebiti attivi usano le tariffe del metodo Ailoot selezionato.
| Configurazione | Condizioni di fatturazione | Costo |
|---|---|---|
| Configurazionewan2.7-image · Configurazione predefinita | Condizioni di fatturazioneConfigurazione predefinita | Costo Input · Input 0,00 USD per chiamata Output · Output 0,06 USD per chiamata |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "wan2.7-image", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'wan2.7-image', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "wan2.7-image", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nScarica ogni immagine restituita o salvane il contenuto Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Salva ogni immagine completata; recupera ogni URL restituito oppure decodificane il contenuto Base64.
Salva ogni elemento data. Decodifica ogni b64_json o recupera ogni URL firmato restituito. Scegli l'estensione del nome del file in base al MIME e ai byte effettivi.
Se il risultato di una generazione o modifica di immagini richiede una verifica, conserva operation_id/X-Client-Request-ID originale e le informazioni sul risultato restituito. Recupera i risultati esistenti che ti appartengono tramite la libreria multimediale usando i valori effettivi di task_id o asset_id. Non reinviare la richiesta di generazione/modifica e non costruire un URL di polling a partire da operation_id.
| Campo | Tipo |
|---|---|
Campocreated | Tipointeger |
Campodata[].url | Tipostring |
Campodata[].b64_json | Tipobase64 string |
Campousage | Tipoobject |
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneCampi obbligatori, rappresentazione del materiale o valore del parametro non validi | Passaggio successivoCorreggi i campi indicati prima di una nuova richiesta di creazione. |
Rispostaserver_error | CondizioneLa risposta restituita indica che l'operazione o il risultato richiede una verifica | Passaggio successivoConserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione. |
Ailoot wan2.7-image
Usa i percorsi dei metodi indicati sopra.