Pro API: generer og retusjer bilder
Ett bilde koster 1 kreditt, uansett modus. Generering fra en prompt og retusjering av et bilde du laster opp går begge gjennom samme rute.
Send inn et bilde
POST /images
{ "prompt": "portrait of a woman in a rainy street at night, neon reflections, cinematic",
"width": 832, "height": 1216 }
| Felt | Type | Standard | Hva det gjør |
|---|---|---|---|
prompt | string | obligatorisk | Scenen. Engelsk gir de mest presise resultatene. |
width, height | int | 1024 x 1024 | Pikselstørrelse. Gode formater: 1024 x 1024 (kvadrat), 832 x 1216 (portrett), 1216 x 832 (landskap). |
mode | string | generation | edit, img2img eller inpaint, se nedenfor. Utelatt betyr generer fra prompten. |
image_b64 | string | Kildebilde i base64 (PNG eller JPEG), obligatorisk for alle tre retusjeringsmodusene. Maks 12 MB dekomprimert. | |
mask_b64 | string | Maske i base64: obligatorisk for inpaint, valgfritt for edit. Mal områdene som skal retusjeres i rødt, i kildebildets størrelse. | |
lora | string | En trent karakter på kontoen: name returnert av GET /loras. Legg inn dens trigger i prompten. | |
lora2, lora2_strength | string, number | En andre karakter og dens styrke (0 til 1, standard 1) for en scene med to personer. | |
steps | int | engine | La stå tomt. Motoren kjenner sin egen verdi. |
Svaret:
{ "jobId": "test-79634842-4586-46d4-ad52-d9ea236ae00d", "seed": 178078967, "cost": 1 }
seed trekkes av motoren og returneres til informasjon. Den kan ikke låses som inndata i
denne versjonen.
De tre retusjeringsmodusene
Alle tre kjører på samme instruksjonsdrevne redigeringsmotor, som bevarer utseendet på
kildebildet. Når du oppgir et kildebilde, leses width og height fra bildet selv og
trenger ikke sendes med.
mode | Inngangsverdier | Hva motoren gjør |
|---|---|---|
edit | image_b64 + prompt (+ valgfritt mask_b64) | Anvender instruksjonen på hele bildet ("add sunglasses", "make it snow"). Med en maske konsentreres endringen innenfor det røde området. |
inpaint | image_b64 + mask_b64 + prompt | Regenererer kun det røde området i masken, etter instruksjonen. Resten settes sammen piksel for piksel. |
img2img | image_b64 + prompt | Bearbeider hele bildet langs prompten mens komposisjon og utseende beholdes: en variasjon. |
IMG=$(base64 -w0 photo.png)
curl -s $B/images -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d "{\"mode\":\"edit\",\"prompt\":\"add a red scarf, keep everything else identical\",\"image_b64\":\"$IMG\"}"
Poll
GET /images/{jobId}
| Svar | Betydning |
|---|---|
{ "status": "pending", "phase": "IN_QUEUE" } | I kø |
{ "status": "pending", "phase": "IN_PROGRESS" } | Rendrer |
{ "status": "completed", "cost": 1, "file_url": "/pro/v1/images/{jobId}/file", ... } | Ferdig, fil klar |
{ "status": "failed", "detail": "..." } | Mislyktes, og ingenting belastes |
Poll hvert 3. sekund, ikke raskere: køen er delt.
Last ned
GET /images/{jobId}/file
Selve PNG-filen, som responskroppen (Content-Type: image/png). Tilgjengelig så snart
statusen er completed, og 404 media_indisponible når renderingen er borte. Last den ned
med en gang, den arkiveres ikke.
Avbryt
POST /images/{jobId}/cancel
Avbryter en kø-lagt eller pågående rendering. Svarer { "ok": true }. Ingenting belastes, og
kostnaden som var reservert mot nøkkelens daglige grense, blir tilbakeført.