Ghid operator pentru editarea imaginilor cu Venice

Ce face

venice-image-edit modifică imagini existente prin Venice. Nu generează o imagine nouă doar din text; pornește de la una sau mai multe imagini de input și returnează o variantă editată.

Acoperă patru endpoint-uri:

Inputul poate fi base64, upload de fișier sau URL HTTPS, în funcție de endpoint. Rezultatul este imaginea editată ca binary image/png.

Pentru text-to-image, folosește venice-image-generate, nu acest capability.

Vezi și All guides.

Când îmi folosește

Folosește venice-image-edit când ai deja material vizual și vrei o intervenție controlată:

• schimbi un element: cer, culoare, obiect, stil;
• adaugi sau elimini un detaliu;
• pui un subiect dintr-o imagine peste fundalul alteia;
• faci upscale sau enhancement fără reconstrucție manuală;
• scoți fundalul pentru un asset transparent;
• cureți o imagine pentru publicare.

Prompturile scurte și specifice sunt mai bune decât proza lungă: remove the tree, add sunglasses to the cat, make the sky a vivid orange sunrise. Modelul are nevoie de instrucțiune, nu de roman.

Cum îl invoc / declanșez

Invocarea depinde de runtime-ul care expune capability-ul. La nivel API, folosește Venice cu autentificare Authorization: Bearer <API key>. Nu pune cheia în prompturi, loguri, ghiduri sau output public. Dacă lipsește cheia, escaladează către operatorul sistemului; nu inventa credentiale și nu reutiliza tokenuri din alte contexte.

Pentru editarea unei singure imagini:

POST /image/edit

Pentru compoziție:

POST /image/multi-edit

Aici câmpul este modelId, nu model. Prima imagine este baza; restul sunt layere, măști sau referințe. Ordinea contează. JSON-ul folosește images cu 1–3 elemente, base64 sau URL-uri HTTPS. Varianta multipart trimite mai multe părți cu același field name: images.

Pentru upscale:

POST /image/upscale

Folosește scale între 1 și 4. Dacă scale este 1, trebuie enhance: true. La scale: 4, imaginile mari pot fi clampate automat ca să rămână sub limita de pixeli.

Pentru eliminarea fundalului:

POST /image/background-remove

Trimite fie image, fie image_url, nu ambele.

Exemplu practic

Ai o fotografie și vrei o variantă curată pentru publicare.

1. Dacă fundalul nu contează, folosești POST /image/background-remove și obții un PNG transparent.
2. Dacă vrei să schimbi un detaliu, folosești POST /image/edit cu un prompt scurt.
3. Dacă imaginea e prea mică, folosești POST /image/upscale cu scale: 2 și, opțional, enhance: true.
4. Dacă vrei să combini imagini, folosești POST /image/multi-edit, cu imaginea de bază prima.

Nu presupune că un URL privat, un fișier din spatele unui login sau o imagine inaccesibilă public poate fi citită de Venice. Descarcă sau furnizează inputul într-un mod acceptat.

Output / unde aterizează

Toate cele patru endpoint-uri returnează imaginea rezultată ca binary image/png. Nu există câmp return_binary pentru edit, multi-edit, upscale sau background-remove; acel flag aparține fluxului /image/generate.

La background-remove, PNG-ul are alpha channel, deci fundal transparent.

Salvează răspunsul ca fișier imagine și verifică efectiv fișierul rezultat înainte să declari operația reușită. Un status HTTP bun nu garantează că editarea semantică arată corect.

Limite / gotchas

Fișierul trebuie să fie sub 25 MB. Dimensiunile imaginii trebuie să fie între 65 536 și 33 177 600 pixeli. Pentru upscale, rezultatul este limitat la 16 777 216 pixeli după scalare.

URL-urile HTTPS trebuie să fie public accesibile din rețeaua Venice. Dacă imaginea este în spatele unui login, nu te baza pe URL.

Erori comune:

Gotcha principal: /image/edit preferă model, dar /image/multi-edit cere modelId. Dacă le încurci, primești 400. Birocrație mică, dinți ascuțiți.