wan2.7-image
Dizayn variantlari va illyustratsiyalarni tayyorlash uchun matn asosida tasvir yaratish modeli. Alibaba ma’lumotiga ko‘ra, bu versiya tasvirlarni tezroq yaratishga yo‘naltirilgan.
Model haqida
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Wan2.7-Image matnli topshiriq asosida tasvirlar yaratadi. Joriy Ailoot kartasida aynan matnli kirish va tasvir ko‘rinishidagi natija taqdim etilgan. Alibaba ma’lumotiga ko‘ra, bu versiya variantlarni tezroq olishga yo‘naltirilgan. Ishlab chiqaruvchi spetsifikatsiyasida tahrirlash, namunalarni birlashtirish va tasvirning ayrim qismlarini o‘zgartirish ham ko‘zda tutilgan; ular kiruvchi tasvirlarni alohida qo‘llab-quvvatlashni talab qiladi va bu kartaning joriy metodida taqdim etilmagan.
Alibaba tavsiflagan rejimlar
Namuna tasvirli rejim uchun Alibaba topshiriqda to‘qqiztagacha boshlang‘ich tasvirni ko‘zda tutadi. Ular obyekt ko‘rinishi, kompozitsiya va tafsilotlar uchun tayanch bo‘lib xizmat qiladi. Model bir nechta materialni yangi sahnaga birlashtirishi yoki asosiy buyumni saqlagan holda boshlang‘ich rasmni o‘zgartirishi mumkin. Aniq joyni tahrirlash uchun aniq belgilangan sohalar ko‘zda tutilgan: bitta tasvirda ikkitagacha to‘g‘ri to‘rtburchak sohani ko‘rsatish mumkin.
Alibaba spetsifikatsiyasida oddiy rejim birdan to‘rttagacha natija hosil qiladi. Ketma-ket turkum orqali hikoya yoki personajlarning umumiy xususiyatlari bilan bog‘langan 12 tagacha tasvir so‘rash mumkin. Turkum uchun bu yuqori chegara: model kerakli kadrlar sonini o‘zi belgilaydi va kamroq qaytarishi mumkin. Topshiriq va boshlang‘ich materiallar umumiy syujet yo‘nalishini saqlashga yordam beradi.
Namunasiz va ketma-ket turkumsiz oddiy matndan yaratish uchun mulohaza yuritish rejimi ko‘zda tutilgan. Unda model tasvir yaratishdan oldin murakkab tavsifni batafsilroq tahlil qiladi. Rasmlar asosida tahrirlashda va ketma-ket turkumda bu rejim ishlatilmaydi. 3–10 rangdan iborat belgilangan palitra ketma-ket turkumlardan tashqarida mavjud.
Kirish va natija
Ishlab chiqaruvchining boshlang‘ich tasvirli rejimlarida JPEG, JPG, shaffofliksiz PNG, BMP va WEBP qo‘llab-quvvatlanadi. Har bir tomon 240 dan 8000 pikselgacha bo‘lishi mumkin, fayl hajmi — 20 MB gacha, tomonlar nisbati — 1:8 dan 8:1 gacha.
Matnli topshiriq xitoy va ingliz tillarini qo‘llab-quvvatlaydi hamda 5000 belgi bilan cheklangan; ortiqcha qism tashlab yuboriladi. Bu versiyada salbiy tavsif va topshiriqni qo‘shimcha kengaytirish ko‘zda tutilmagan.
Chiqish formati — PNG, aniqlik — 2K darajasigacha. Bu belgi tomonning qat’iy maksimal uzunligini emas, umumiy piksellar maydonini bildiradi; shaklni 1:8 dan 8:1 gacha oraliqda tanlash mumkin. Oldindan belgilangan aniqlik bilan tahrirlashda natija oxirgi namunaning tomonlar nisbatini saqlaydi. Bir xil boshlang‘ich tasodifiylik urug‘i o‘xshash variantlar olishga yordam beradi, lekin to‘liq mos tushishni kafolatlamaydi.
Ailoot · Rasmlar POST /v1/images/generations wan2.7-image
wan2.7-imageBoshlash
Dizayn variantlari va illyustratsiyalarni tayyorlash uchun matn asosida tasvir yaratish modeli. Alibaba ma’lumotiga ko‘ra, bu versiya tasvirlarni tezroq yaratishga yo‘naltirilgan.
- Qabul qilinadigan kirish ma’lumotlari
- Matn
- Natijalar
- Rasmlar
Ailoot da mavjud · kirish ma’lumotlari va usullar
Ailoot · Rasmlar POST /v1/images/generations
- Kirish
text- Chiqish
image- Chiqish formati
- Rasm fayli
| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar wan2.7-image | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Eng kam uzunlik: 1 | Standart— |
Maydonn | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng kam: 1 | Standart1 |
Maydonresponse_format | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar url, b64_json | Standart— |
Maydonstream | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standartfalse |
Maydonsize | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonpartial_images | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonimages[].image_url | Turstring | TalabQo‘llab-quvvatlanmaydi | Qiymatlar va cheklovlar Dekodlangan baytlarning eng ko‘p soni: 20 971 520 MIME turlari: image/png, image/jpeg Massivdagi rasmlarning eng ko‘p soni: 9 Shartlar: Har bir images[] obyektiga bitta haqiqiy URL. Massivdagi elementlar soni ushbu yakuniy satr maydonidan alohida tushunchadir. Quyidagi holatda qo‘llanadi: Faqat JSON images/edits; JSON images/generations rasm referenslarini tahlil qilmaydi. | Standart— |
Maydonimage | Turfile | TalabIxtiyoriy | Qiymatlar va cheklovlar Dekodlangan baytlarning eng ko‘p soni: 20 971 520 MIME turlari: image/png, image/jpeg Quyidagi holatda qo‘llanadi: multipart/form-data orqali yaratish | Standart— |
Maydonimage[] | Turfile[] | TalabIxtiyoriy | Qiymatlar va cheklovlar Elementlarning eng ko‘p soni: 9 Dekodlangan baytlarning eng ko‘p soni: 20 971 520 MIME turlari: image/png, image/jpeg Quyidagi holatda qo‘llanadi: multipart/form-data orqali yaratish | Standart— |
Kirish materiallari birikmalari
Matndan rasm · Majburiy: prompt
reference_images_generation · Majburiy: prompt
Usul parametrlari va hayot sikli
| Parametr | Parametr talablari |
|---|---|
Parametrmaterial_types | Parametr talablaritext |
Parametrrequired | Parametr talablarimodel, prompt |
Parametroptional_controls | Parametr talablarinull |
Parametrcontent_type | Parametr talablariapplication/json |
Hayot sikli: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Amalda qaytarilgan task_id yoki media kutubxonasidagi yozuv
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Metod tuzilishlari va IDlari aniq; yetkazib beruvchining imkoniyati so‘rovni qabul qilishga ruxsatdan alohida.
Tariflar
Ailoot usullari tariflari
POST /v1/images/generations- Chiqish
- 0,03 US$ 1K o‘lchamdagi rasm uchun
- Chiqish
- 0,03 US$ 2K o‘lchamdagi rasm uchun
Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →
Ma’lumot uchun tarif tafsilotlari
Modelning ma’lumot jadvallari usul tanlash, narx hisobi yoki to‘lovlarni o‘zgartirmaydi. Amaldagi to‘lovlar tanlangan Ailoot usuli tariflari bo‘yicha hisoblanadi.
wan2.7-image
Sozlamalar bo‘yicha narxlar
| Sozlama | To‘lovni hisoblash shartlari | To‘lov |
|---|---|---|
| Sozlamawan2.7-image · Standart sozlama | To‘lovni hisoblash shartlariStandart konfiguratsiya | To‘lov Kirish · Kirish 0,00 US$ har chaqiruv uchun Chiqish · Chiqish 0,06 US$ har chaqiruv uchun |
So‘rov namunalari
Ailoot · Rasmlar
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
export AILOOT_API_KEY
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "wan2.7-image", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
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"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
from openai import OpenAI
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
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"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")
request={'model': 'wan2.7-image', 'prompt': ''}
request["prompt"]=f.read_text(encoding="utf-8")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.images.generate(**request)
Path("sdk-result.txt").write_text(str(result),encoding="utf-8")
save_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])
import OpenAI from "openai";
import { readFileSync, writeFileSync } from "node:fs";
const key=process.env.AILOOT_API_KEY;
if(!key) throw new Error("Set your actual Ailoot API key");
const client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});
const request={"model": "wan2.7-image", "prompt": ""};
if(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");
request.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");
const result=await client.images.generate(request);
writeFileSync("sdk-result.json",JSON.stringify(result,null,2));
if(!result.data?.length) throw new Error("No completed images");
for(let index=0;index<result.data.length;index++) {
const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;
if(!encoded && uri.startsWith("data:image/")) {
const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");
encoded=uri.slice(comma+1);
}
if(encoded) {
if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");
raw=Buffer.from(encoded,"base64");
} else if(uri) {
const u=new URL(uri,"https://api.ailoot.ai");
if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");
const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");
const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});
if(!response.ok) throw new Error("Image content download failed: "+response.status);
raw=Buffer.from(await response.arrayBuffer());
} else throw new Error("Image has neither bytes nor URL");
if(!raw.length) throw new Error("Empty image result");
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";
writeFileSync(`image-${index}.${ext}`,raw);
}
console.log("Every returned image saved; sdk-result.json retains complete metadata");
Natijalarni olish va saqlash
Ailoot · Rasmlar
Har bir qaytarilgan rasmni yuklab oling yoki uning Base64 kontentini saqlang
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Barcha tayyor natijalarni saqlash
Har bir tayyor rasmni saqlang; har bir qaytarilgan URL dan kontentni oling yoki uning Base64 kontentini dekodlang.
Har bir ma’lumot elementini saqlang. Har bir b64_json ni dekodlang yoki qaytarilgan har bir imzolangan URL dan faylni yuklab oling. Fayl nomi kengaytmasini haqiqiy MIME turi/baytlar asosida tanlang.
Asl javobni tekshirish kerak bo‘lsa
Rasm yaratish yoki tahrirlash natijasini tekshirish kerak bo‘lsa, dastlabki operation_id/X-Client-Request-ID va qaytarilgan natija haqidagi ma’lumotlarni saqlang. Amalda qaytarilgan task_id yoki asset_id qiymatlari yordamida media kutubxonasidan o‘zingizga tegishli mavjud natijalarni tiklang. Rasm yaratish/tahrirlash so‘rovini qayta yubormang va operation_id dan holatni davriy tekshirish uchun URL tuzmang.
Javob maydonlari
| Maydon | Tur |
|---|---|
Maydoncreated | Turinteger |
Maydondata[].url | Turstring |
Maydondata[].b64_json | Turbase64 string |
Maydonusage | Turobject |
Xatolar va keyingi qadamlar
| Javob | Shart | Keyingi qadam |
|---|---|---|
Javob400 · invalid_request_error | ShartMajburiy maydonlar, material ifodasi yoki parametr qiymati noto‘g‘ri | Keyingi qadamYangi yaratish so‘rovidan oldin ko‘rsatilgan maydonlarni tuzating. |
Javobserver_error | ShartQaytarilgan javob operatsiya yoki natijani tekshirish kerakligini bildiradi | Keyingi qadamDastlab qaytarilgan operatsiya/vazifa ID sini, so‘rov sarlavhalarini va javobni saqlang; aynan shu operatsiya uchun qo‘llab-quvvatlanadigan o‘qish so‘rovlarini davom ettiring. Yaratish so‘rovini qayta yubormang. |
Taxalluslar
Model taxalluslari
Ailoot wan2.7-image
Usul yo‘llari taxalluslari
Yuqorida ko‘rsatilgan usul yo‘llaridan foydalaning.
Chaqirish uchun tegishli ID lar
FAQ · wan2.7-image
- Qanday kirish ma’lumotlari va natijalar mavjud?
POST /v1/images/generations·wan2.7-image:text→image- So‘rov qaysi maydonlardan foydalanadi?
POST /v1/images/generations·wan2.7-image:model,prompt,n,response_format,stream,image,image[]- Qanday cheklovlar amal qiladi?
POST /v1/images/generations·wan2.7-image:n.minimum:1