שפּרינגען צו אינהאַלט

Topaz Upscale Image Generative

אינטעגרירן

מאָדעל־id 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"

פֿײַלן ווי דער בײַשפּיל: ⁨$ 0.08⁩ 80 API־קרעדיטן · ≈ ⁨₽ 8.44⁩ אײַערע פֿײַלן ווערן געמאסטן איידערן לויפֿן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Topaz Labs אויפֿהייבן רעזאָלוציע #upscale#image

גענעראַטיווער בילד־ופּסקיילער מיט אַ סך מאָדעלן, פּנים־פֿאַרבעסערונג און פּראָמפּט־געפֿירטער Redefine־מאָדע

Topaz Labs · בילד

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

0 / 1024

פֿירער־טעקסט פֿאַר גענעראַטיוון אַפּסקעילינג, באַגרענעצט צו 1024 צייכנס און געשטיצט נאָר דורך Redefine.

•פארלאנגט image_url
לייגט אַרײַן אַ טעקע, אָדער

URL פֿון דעם מקור־בילד פֿאַר אַפּסקעילינג.

סטאַנדאַרט Wonder 3

אויסקלײַב פֿון גענעראַטיוון אַפּסקעילינג־מאָדעל: Recovery און Recovery V2 בויען איבער בילדער מיט גאָר נידעריקער רעזאָלוציע; Redefine ניצט פּראָמפּטן צו פֿירן קרעאַטיוון דעטאַל; Standard MAX פּריאָריטיזירט גענויעקייט און הויכע קוואַליטעט; Recover 3 בויט איבער נאַטירלעכן דעטאַל. אין דער Wonder־פֿאַמיליע קומען Wonder און Wonder 2 פֿאַר Wonder 3, דעם פֿאָרגעשריטנסטן גענעראַטיוון רעאַליזם־מאָדעל; די נײַסטע מעלדונג, Wonder 3.5, גיט פֿײַנערן דעטאַל מיט ווייניקער מוסטער־איבערחזרונג.

סטאַנדאַרט 2

מולטיפּליקאַטאָר פֿאַר בילד־פֿאַרגרעסערונג; למשל, 2.0 מאַכט ביידע דימענסיעס טאָפּלט אַזוי גרויס.

פֿאָרגעשריטן 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 סטאַנדאַרט jpeg

פֿאָרמאַט גענוצט פֿאַר דעם אַפּסקעילטן בילד.

subject_detection סטאַנדאַרט All

קאָנטראָלירט ווי טעמעס ווערן דערקענט בײַם פֿאַרבעסערן בילדער מיט Recovery V2, Wonder 3 אָדער Recovery.

enhancement_strength

פֿאַרבעסערונג־שטאַרקייט פֿון גענעראַטיוון אַפּסקעילינג, אויטאָמאַטיש באַשטימט ווען נישט ספּעציפֿיצירט; געשטיצט דורך Wonder 3.5 און Wonder 3.

סטאַנדאַרט 0

קרעאַטיוויטעט־קאָנטראָל פֿאַר פּנים־פֿאַרבעסערונג, אַקטיוו נאָר ווען פּנים־פֿאַרבעסערונג איז אַקטיוו: שטעל 1.0 פֿאַר מאַקסימום קרעאַטיוויטעט אָדער 0.0 פֿאַר קיין שום.

סטאַנדאַרט 0.8

שטאַרקייט־קאָנטראָל פֿאַר פּנים־פֿאַרבעסערונג, אַקטיוו נאָר ווען פּנים־פֿאַרבעסערונג איז אַקטיוו: שטעל 1.0 פֿאַר מאַקסימום פֿאַרבעסערונג אָדער 0.0 פֿאַר קיין שום.

קרעאַטיוויטעט פֿון גענעראַטיוון אַפּסקעילינג פֿון 1 ביז 6, געשטיצט נאָר דורך Redefine. אַ העכערע ווערט לייגט צו מער פֿאַנטאַזיעדיקן אָדער אילוזאָרישן דעטאַל.

געוועב־דעטאַל־קאָנטראָל, אויסשליסלעך פֿאַר Redefine'ס גענעראַטיוון אַפּסקעילינג, מיט מדרגות פֿון 1 ביז 5.

שאַרפּענינג־אינטענסיטעט פֿון 0.0 ביז 1.0, געשטיצט נאָר דורך Redefine.

דע־נויזינג־אינטענסיטעט פֿון 0.0 ביז 1.0, געשטיצט נאָר דורך Redefine.

דעטאַל־רעקאָווערי־אינטענסיטעט פֿון 0.0 ביז 1.0, געשטיצט נאָר דורך Recovery V2.

POST /run/topaz/upscale/image/generative?wait=20 פּרײַז → ⁨$ 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"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Topaz Upscale Image Generative

ופּסקיילט אַ בילד פֿון 1x ביז 4x מיט אַן אויסקלײַב פֿון `model`, אַרײַנגערעכנט Wonder 3.5, Wonder 3, Recover 3, Redefine און Recovery V2. פּנים־פֿאַרבעסערונג האָט אייגענע שטאַרקייט־ און שעפֿערישקייט־סליידער. Redefine צולייגט אַ `prompt` ביז 1024 אותיות פּלוס `creativity`, `texture`, `sharpen` און `denoise`. גוט פֿאַר קליינע אָדער פֿאַרוואָלקנטע קוואַלן.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
URL פֿון דעם מקור־בילד פֿאַר אַפּסקעילינג.
modelאָפּציאָנעל
טיפּenum
סטאַנדאַרטWonder 3
Wonder 3.5Wonder 3Wonder 2WonderRecover 3Standard MAXRedefineRecovery V2Recovery
אויסקלײַב פֿון גענעראַטיוון אַפּסקעילינג־מאָדעל: Recovery און Recovery V2 בויען איבער בילדער מיט גאָר נידעריקער רעזאָלוציע; Redefine ניצט פּראָמפּטן צו פֿירן קרעאַטיוון דעטאַל; Standard MAX פּריאָריטיזירט גענויעקייט און הויכע קוואַליטעט; Recover 3 בויט איבער נאַטירלעכן דעטאַל. אין דער Wonder־פֿאַמיליע קומען Wonder און Wonder 2 פֿאַר Wonder 3, דעם פֿאָרגעשריטנסטן גענעראַטיוון רעאַליזם־מאָדעל; די נײַסטע מעלדונג, Wonder 3.5, גיט פֿײַנערן דעטאַל מיט ווייניקער מוסטער־איבערחזרונג.
upscale_factorאָפּציאָנעל
טיפּnumber
סטאַנדאַרט2
1 – 4
מולטיפּליקאַטאָר פֿאַר בילד־פֿאַרגרעסערונג; למשל, 2.0 מאַכט ביידע דימענסיעס טאָפּלט אַזוי גרויס.
crop_to_fillאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
output_formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטjpeg
jpegpng
פֿאָרמאַט גענוצט פֿאַר דעם אַפּסקעילטן בילד.
subject_detectionאָפּציאָנעל
טיפּenum
סטאַנדאַרטAll
AllForegroundBackground
קאָנטראָלירט ווי טעמעס ווערן דערקענט בײַם פֿאַרבעסערן בילדער מיט Recovery V2, Wonder 3 אָדער Recovery.
face_enhancementאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
פֿאַרבעסערונג־שאַלטער פֿאַרן פּנים אין בילד.
face_enhancement_creativityאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0
0 – 1
קרעאַטיוויטעט־קאָנטראָל פֿאַר פּנים־פֿאַרבעסערונג, אַקטיוו נאָר ווען פּנים־פֿאַרבעסערונג איז אַקטיוו: שטעל 1.0 פֿאַר מאַקסימום קרעאַטיוויטעט אָדער 0.0 פֿאַר קיין שום.
face_enhancement_strengthאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.8
0 – 1
שטאַרקייט־קאָנטראָל פֿאַר פּנים־פֿאַרבעסערונג, אַקטיוו נאָר ווען פּנים־פֿאַרבעסערונג איז אַקטיוו: שטעל 1.0 פֿאַר מאַקסימום פֿאַרבעסערונג אָדער 0.0 פֿאַר קיין שום.
enhancement_strengthאָפּציאָנעל
טיפּenum
lowmediumhigh
פֿאַרבעסערונג־שטאַרקייט פֿון גענעראַטיוון אַפּסקעילינג, אויטאָמאַטיש באַשטימט ווען נישט ספּעציפֿיצירט; געשטיצט דורך Wonder 3.5 און Wonder 3.
creativityאָפּציאָנעל
טיפּinteger | null
1 – 6
קרעאַטיוויטעט פֿון גענעראַטיוון אַפּסקעילינג פֿון 1 ביז 6, געשטיצט נאָר דורך Redefine. אַ העכערע ווערט לייגט צו מער פֿאַנטאַזיעדיקן אָדער אילוזאָרישן דעטאַל.
textureאָפּציאָנעל
טיפּinteger | null
1 – 5
געוועב־דעטאַל־קאָנטראָל, אויסשליסלעך פֿאַר Redefine'ס גענעראַטיוון אַפּסקעילינג, מיט מדרגות פֿון 1 ביז 5.
promptאָפּציאָנעל
טיפּstring | null
≤ 1,024 כאַראַקטערן
פֿירער־טעקסט פֿאַר גענעראַטיוון אַפּסקעילינג, באַגרענעצט צו 1024 צייכנס און געשטיצט נאָר דורך Redefine.
autopromptאָפּציאָנעל
טיפּboolean | null
שאַלטער פֿאַר אָטאָמאַטישער פּראָמפּט־גענערירונג, אויסשליסלעך אין Redefine'ס גענעראַטיוון אַפּסקעילינג.
sharpenאָפּציאָנעל
טיפּnumber | null
0 – 1
שאַרפּענינג־אינטענסיטעט פֿון 0.0 ביז 1.0, געשטיצט נאָר דורך Redefine.
denoiseאָפּציאָנעל
טיפּnumber | null
0 – 1
דע־נויזינג־אינטענסיטעט פֿון 0.0 ביז 1.0, געשטיצט נאָר דורך Redefine.
detailאָפּציאָנעל
טיפּnumber | null
0 – 1
דעטאַל־רעקאָווערי־אינטענסיטעט פֿון 0.0 ביז 1.0, געשטיצט נאָר דורך Recovery V2.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
סקרינינג קען ווערן פאַרלייכטערט דורך שטעלן false, אויב דער רופער איז אָטעריזירט.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

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"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
image
object {url, content_type, file_name, file_size}בילד געשאַפֿן דורך פֿאַרגרעסערונג.

מער מאָדעלן: אויפֿהייבן רעזאָלוציע

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/topaz/upscale/image/generative.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt