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

Marigold V2 Depth

אינטעגרירן

מאָדעל־id marigold-v2
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/marigold-v2?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

דער דאָזיקער ריקוועסט: ⁨$ 0.03⁩ 30 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Open model בילד־עדיטירונג #depth#utility

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

Open model · בילד

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

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

בויען אַ בעטן

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

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

URL פֿונעם אַרײַנגעבונג־בילד.

image_size

דימענסיעס פֿאַר אינפֿערענץ; אויב מען לאָזט זיי אויס, ווערט גענוצט די גרייס פון דער אַרײַנגעגעבענער בילד נאָכן ראָונדען יעדער דימענסיע צום נאָענטסטן מערפֿאַכיקן פון 16. ספּעציפֿיצירט אַ פּרעסעט ווי `"square_hd"` אָדער `"landscape_4_3"`, אָדער גיט אַ `{width, height}` אָביעקט. ברייט און הייך מוזן ביידע זײַן טיילבאַר דורך 16, קיינער טאָר נישט איבערגיין 2048 פּיקסעלן, און זייער פאַרהעלטעניש מוז זײַן צווישן 1:16 און 16:1.

פֿאָרגעשריטן prediction_type · seed · enable_safety_checker
prediction_type סטאַנדאַרט depth

טיפּ פון פּראָגנאָז־מאַפּע וואָס זאָל ווערן געשאַפֿן.

צופֿעליקער סיד וואָס מאַכט דעם רעזולטאַט רעפּראָדוצירבאַר ווען דאָס זעלבע בילד ווערט ווידערגענוצט. זײַן השפּעה איז באַגרענעצט צו לאַטענט־סאַמפּלינג פונעם VAE-ענקאָדער, ווײַל דער פֿאָרווערד־פּאַס איז אַליין איין דיטערמיניסטישער שריט.

POST /run/marigold-v2?wait=20 פּרײַז → ⁨$ 0.03⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/marigold-v2?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

וועגן Marigold V2 Depth

שאַצט אַ מאַפּע פֿון איין בילד. `prediction_type` קלייבט טיפקייַט, דורכזעענדיקע טיפקייַט, נאָרמאַלן אָדער אַלבעדאָ. דער רעזולטאַט איז אַ PNG־וויזואַליזאַציע, נישט אַ נומערישער טענזור. `image_size` קען זײַן אַ פּריסעט אָדער אַן אָביעקט מיט ברייט/הייך, מיט מערצאָלן פֿון 16 ביז 2048, און `seed` מאַכט די רעזולטאַטן איבערחזרבאַר.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
prediction_typeאָפּציאָנעל
טיפּenum
סטאַנדאַרטdepth
depthsee-through-depthnormalsalbedo
טיפּ פון פּראָגנאָז־מאַפּע וואָס זאָל ווערן געשאַפֿן.
image_urlפארלאנגט image
טיפּurl · image
URL פֿונעם אַרײַנגעבונג־בילד.
image_sizeאָפּציאָנעל
טיפּobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
דימענסיעס פֿאַר אינפֿערענץ; אויב מען לאָזט זיי אויס, ווערט גענוצט די גרייס פון דער אַרײַנגעגעבענער בילד נאָכן ראָונדען יעדער דימענסיע צום נאָענטסטן מערפֿאַכיקן פון 16. ספּעציפֿיצירט אַ פּרעסעט ווי `"square_hd"` אָדער `"landscape_4_3"`, אָדער גיט אַ `{width, height}` אָביעקט. ברייט און הייך מוזן ביידע זײַן טיילבאַר דורך 16, קיינער טאָר נישט איבערגיין 2048 פּיקסעלן, און זייער פאַרהעלטעניש מוז זײַן צווישן 1:16 און 16:1.
seedאָפּציאָנעל
טיפּinteger | null
צופֿעליקער סיד וואָס מאַכט דעם רעזולטאַט רעפּראָדוצירבאַר ווען דאָס זעלבע בילד ווערט ווידערגענוצט. זײַן השפּעה איז באַגרענעצט צו לאַטענט־סאַמפּלינג פונעם VAE-ענקאָדער, ווײַל דער פֿאָרווערד־פּאַס איז אַליין איין דיטערמיניסטישער שריט.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
סקרינינג קען ווערן פאַרלייכטערט דורך שטעלן false, אויב דער רופער איז אָטעריזירט.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "marigold-v2",
  "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": 30,
    "usd": "0.03",
    "charged": 30,
    "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,
      "width": 1024,
      "height": 768
    },
    "seed": 42
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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, width, height}פּראָגנאָז רענדערט ווי PNG פֿאַר באַטראַכטונג; דער ענטפֿער גיט נישט קיין לאָסלעס נומערישן טענסאָר דורך דעם בילד.
seed
integerסיד גענוצט בײַם סאַמפּלען לאַטענטן אינעם VAE-ענקאָדער.

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