Siirry sisältöön

Topaz Upscale Image Generative

Integroi

Mallin tunniste topaz/upscale/image/generative
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/topaz/upscale/image/generative?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esimerkin kaltaiset tiedostot: 0,08 $ 80 API-krediittiä · ≈ 8,44 ₽ tiedostosi mitataan ennen suorittamista Suorita tällä sivulla

Hanki API-avain
Topaz Labs Skaalaus #upscale#image

Generatiivinen kuvan suurentaja, jossa on useita malleja, kasvojen parannus ja kehotteella ohjattava Redefine-tila

Topaz Labs · Kuva

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

0 / 1024

Generatiivisen skaalauksen ohjeteksti, enintään 1024 merkkiä ja vain Redefinen tukema.

•pakollinen image_url
Pudota tiedosto tai

Skaalattavan lähdekuvan URL-osoite.

oletus Wonder 3

Generatiivisen skaalauksen mallin valinta: Recovery ja Recovery V2 rekonstruoivat erittäin pieniresoluutioisia kuvia, Redefine ohjaa luovaa yksityiskohtaa kehotteilla, Standard MAX painottaa tarkkuutta ja laatua, ja Recover 3 rekonstruoi luonnollisia yksityiskohtia. Wonder-malliperheessä Wonder ja Wonder 2 edeltävät Wonder 3:a, edistyneintä generatiivisen realismin mallia; uusin julkaisu Wonder 3.5 tuottaa hienompia yksityiskohtia ja vähemmän kuvioiden toistoa.

oletus 2

Kuvan suurennuskerroin; esimerkiksi 2.0 kaksinkertaistaa molemmat mitat.

Lisäasetukset output_format · subject_detection · enhancement_strength · face_enhancement_creativity · face_enhancement_strength · creativity · texture · sharpen · denoise · detail · crop_to_fill · face_enhancement · autoprompt · enable_safety_checker
output_format oletus jpeg

Skaalatun kuvan käyttämä muoto.

subject_detection oletus All

Määrittää, miten kohteet tunnistetaan kuvia Recovery V2:lla, Wonder 3:lla tai Recoverylla parannettaessa.

enhancement_strength

Generatiivisen skaalauksen parannuksen voimakkuus; määritetään automaattisesti, jos sitä ei anneta. Tuetut mallit ovat Wonder 3.5 ja Wonder 3.

oletus 0

Kasvojenparannuksen luovuuden säätö, aktiivinen vain kasvojenparannuksen ollessa käytössä: aseta 1.0 enimmäisluovuudelle tai 0.0 luovuuden poistamiseksi.

oletus 0.8

Kasvojenparannuksen voimakkuuden säätö, aktiivinen vain kasvojenparannuksen ollessa käytössä: aseta 1.0 enimmäisparannukselle tai 0.0 parannuksen poistamiseksi.

Generatiivisen skaalauksen luovuus välillä 1–6, vain Redefinen tukema. Suurempi arvo lisää mielikuvituksellisia tai hallusinoituja yksityiskohtia.

Redefinen generatiiviselle skaalaukselle tarkoitettu tekstuurin yksityiskohtien säätö, jonka taso voi olla 1–5.

Terävöityksen voimakkuus välillä 0.0–1.0, vain Redefinen tukema.

Kohinanpoiston voimakkuus välillä 0.0–1.0, vain Redefinen tukema.

Yksityiskohtien palautuksen voimakkuus välillä 0.0–1.0, vain Recovery V2:n tukema.

POST /run/topaz/upscale/image/generative?wait=20 hinta → 0,08 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/topaz/upscale/image/generative?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Topaz Upscale Image Generative

Suurentaa kuvan 1x–4x valitulla `model`-mallilla, kuten Wonder 3.5, Wonder 3, Recover 3, Redefine ja Recovery V2. Kasvojen parannuksella on omat voimakkuus- ja luovuussäätimensä. Redefine lisää enintään 1024 merkin `prompt`-kehotteen sekä `creativity`-, `texture`-, `sharpen`- ja `denoise`-asetukset. Sopii pienille tai sumeille lähdekuville.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
image_urlpakollinen image
Tyyppiurl · image
Skaalattavan lähdekuvan URL-osoite.
modelvalinnainen
Tyyppienum
OletusWonder 3
Wonder 3.5Wonder 3Wonder 2WonderRecover 3Standard MAXRedefineRecovery V2Recovery
Generatiivisen skaalauksen mallin valinta: Recovery ja Recovery V2 rekonstruoivat erittäin pieniresoluutioisia kuvia, Redefine ohjaa luovaa yksityiskohtaa kehotteilla, Standard MAX painottaa tarkkuutta ja laatua, ja Recover 3 rekonstruoi luonnollisia yksityiskohtia. Wonder-malliperheessä Wonder ja Wonder 2 edeltävät Wonder 3:a, edistyneintä generatiivisen realismin mallia; uusin julkaisu Wonder 3.5 tuottaa hienompia yksityiskohtia ja vähemmän kuvioiden toistoa.
upscale_factorvalinnainen
Tyyppinumber
Oletus2
1 – 4
Kuvan suurennuskerroin; esimerkiksi 2.0 kaksinkertaistaa molemmat mitat.
crop_to_fillvalinnainen
Tyyppiboolean
Oletusfalse
output_formatvalinnainen
Tyyppienum
Oletusjpeg
jpegpng
Skaalatun kuvan käyttämä muoto.
subject_detectionvalinnainen
Tyyppienum
OletusAll
AllForegroundBackground
Määrittää, miten kohteet tunnistetaan kuvia Recovery V2:lla, Wonder 3:lla tai Recoverylla parannettaessa.
face_enhancementvalinnainen
Tyyppiboolean
Oletustrue
Kuvan kasvojenparannuksen valitsin.
face_enhancement_creativityvalinnainen
Tyyppinumber
Oletus0
0 – 1
Kasvojenparannuksen luovuuden säätö, aktiivinen vain kasvojenparannuksen ollessa käytössä: aseta 1.0 enimmäisluovuudelle tai 0.0 luovuuden poistamiseksi.
face_enhancement_strengthvalinnainen
Tyyppinumber
Oletus0.8
0 – 1
Kasvojenparannuksen voimakkuuden säätö, aktiivinen vain kasvojenparannuksen ollessa käytössä: aseta 1.0 enimmäisparannukselle tai 0.0 parannuksen poistamiseksi.
enhancement_strengthvalinnainen
Tyyppienum
lowmediumhigh
Generatiivisen skaalauksen parannuksen voimakkuus; määritetään automaattisesti, jos sitä ei anneta. Tuetut mallit ovat Wonder 3.5 ja Wonder 3.
creativityvalinnainen
Tyyppiinteger | null
1 – 6
Generatiivisen skaalauksen luovuus välillä 1–6, vain Redefinen tukema. Suurempi arvo lisää mielikuvituksellisia tai hallusinoituja yksityiskohtia.
texturevalinnainen
Tyyppiinteger | null
1 – 5
Redefinen generatiiviselle skaalaukselle tarkoitettu tekstuurin yksityiskohtien säätö, jonka taso voi olla 1–5.
promptvalinnainen
Tyyppistring | null
≤ 1 024 merkkiä
Generatiivisen skaalauksen ohjeteksti, enintään 1024 merkkiä ja vain Redefinen tukema.
autopromptvalinnainen
Tyyppiboolean | null
Automaattisen kehotteen generoinnin valitsin, käytettävissä vain Redefinen generatiivisessa skaalauksessa.
sharpenvalinnainen
Tyyppinumber | null
0 – 1
Terävöityksen voimakkuus välillä 0.0–1.0, vain Redefinen tukema.
denoisevalinnainen
Tyyppinumber | null
0 – 1
Kohinanpoiston voimakkuus välillä 0.0–1.0, vain Redefinen tukema.
detailvalinnainen
Tyyppinumber | null
0 – 1
Yksityiskohtien palautuksen voimakkuus välillä 0.0–1.0, vain Recovery V2:n tukema.
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Suodatusta voi höllentää asettamalla arvoksi false, jos kutsujalla on siihen valtuutus.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "topaz/upscale/image/generative",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 80,
    "usd": "0.08",
    "charged": 80,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
image
object {url, content_type, file_name, file_size}Suurentamalla tuotettu kuva.

Lisää malleja: Skaalaus

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/topaz/upscale/image/generative.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt