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

Pixal3d

אינטעגרירן

מאָדעל־id pixal3d
# 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/pixal3d?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.30⁩ 300 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Open model בילד צו 3D #stylized#transform

קאָנווערטירט איין בילד אין אַ טעקסטורירטן GLB 3D מאָדעל מיט דעטאַלירטער קאָנטראָל איבער יעדער גענעראַציע־שטאַפּל

Open model · 3D

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

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

בויען אַ בעטן

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

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

URL וואָס ווייזט צו דעם מקור־בילד פֿאַר 3D־קאָנווערסיע.

resolution סטאַנדאַרט 1024

רעזולטאַט־רעזאָלוציע; דאָס פֿאַרגרעסערן צוגעבט דעטאַלן אָבער נעמט לענגער.

פֿאָרגעשריטן texture_size · ss_guidance_strength · ss_guidance_rescale · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_sampling_steps · tex_slat_rescale_t · mesh_scale · max_num_tokens · decimation_target · seed · remesh · enable_safety_checker
texture_size סטאַנדאַרט 2048

מעש־טעקסטור־רעזאָלוציע פֿאַר באַקינג. פֿײַנערע אויבערפֿלאַך־דעטאַלן ברענגען גרעסערע פֿײַלן ווען די רעזאָלוציע ווערט פֿאַרגרעסערט.

סטאַנדאַרט 7.5

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

סטאַנדאַרט 0.7

גיידאַנס־אַרטעפֿאַקט־קאָנטראָל פֿאַר סטאַגע 1, וואָס בײַ נידעריקע באַשטעטיקונגען האַנדלט שטארקערע גיידאַנס־עפֿעקטן קעגן אַ סטאַבילערן רעזולטאַט בײַ הויכע באַשטעטיקונגען.

סטאַנדאַרט 12

דענאָיִזינג־צאָל פֿאַר דער ערשטיקער סטרוקטור: מעגלעכע קוואַליטעט־געווינסן פֿון נאָך סטעפּס קומען מיט פּאַמעלעכער פּראַסעסירונג.

סטאַנדאַרט 5

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

סטאַנדאַרט 7.5

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

סטאַנדאַרט 0.5

פֿאַרגרעסערט די באַשטעטיקונג ווען די געאָמעטריע זעט אויס ראַשיק: עס רעדוצירט אַרטעפֿאַקטן געפֿירט דורך שטאַרקע גיידאַנס בעת דער פֿאָרעם־סטאַגע.

סטאַנדאַרט 12

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

סטאַנדאַרט 3

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

סטאַנדאַרט 1

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

סטאַנדאַרט 0

פֿאַרגרעסערט די באַשטעטיקונג צו באַהאַנדלען ראַשיקע טעקסטורן אָדער קאָליר־באַנדירונג: עס רעדוצירט אַרטעפֿאַקטן פֿון שטאַרקע גיידאַנס בעת דער טעקסטור־סטאַגע.

סטאַנדאַרט 12

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

סטאַנדאַרט 3

שטעלט די שאַרפֿקייט פֿון טעקסטור־דעטאַל דורך דעם ראַש־סקעדזשול פֿאַר טעקסטור־גענערירונג; דאָס פֿאַרגרעסערן גיט שאַרפֿערע דעטאַלן.

סטאַנדאַרט 1

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

סטאַנדאַרט 49152

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

סטאַנדאַרט 200000

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

סיד גענוצט פֿאַר רעפּראָדוצירבאַרער טראַפֿישער גענערירונג.

POST /run/pixal3d?wait=20 פּרײַז → ⁨$ 0.30⁩
# 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/pixal3d?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 שליסל

וועגן Pixal3d

נעמט איין בילד און גיט צוריק אַ GLB מאָדעל פּלוס דעם גענוצטן זוימען. סטרוקטור, פֿאָרעם און טעקסטור־סטאַדיעס האָבן יעדע אירע אייגענע גיידאַנס־, רעסקײַל־, שריט־צאָל־און רויש־סקעדזשול־באַשטעטיקונגען. רעזולטאַט־`resolution` איז 1024 אָדער 1536, `texture_size` איז 1024, 2048 אָדער 4096, און `decimation_target` שטעלט די ווערטעקס־צאָל פֿון 5000 ביז 1586021. `remesh` בויט די טאָפּאָלאָגיע ווידער.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
URL וואָס ווייזט צו דעם מקור־בילד פֿאַר 3D־קאָנווערסיע.
seedאָפּציאָנעל
טיפּinteger | null
סיד גענוצט פֿאַר רעפּראָדוצירבאַרער טראַפֿישער גענערירונג.
resolutionאָפּציאָנעל
טיפּenum
סטאַנדאַרט1024
10241536
רעזולטאַט־רעזאָלוציע; דאָס פֿאַרגרעסערן צוגעבט דעטאַלן אָבער נעמט לענגער.
ss_guidance_strengthאָפּציאָנעל
טיפּnumber
סטאַנדאַרט7.5
0 – 10
קאָנטראָל פֿון פֿידעליטעט פֿאַר דער ערשטיקער 3D־סטרוקטור: אַ העכערע ווערט פֿאַוואָריזירט נעענטערע צושטימונג מיט דער אַרײַנגעבונגס־בילד, מיט ריזיקירן פֿון צוגעגעבענעם ראַש.
ss_guidance_rescaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.7
0 – 1
גיידאַנס־אַרטעפֿאַקט־קאָנטראָל פֿאַר סטאַגע 1, וואָס בײַ נידעריקע באַשטעטיקונגען האַנדלט שטארקערע גיידאַנס־עפֿעקטן קעגן אַ סטאַבילערן רעזולטאַט בײַ הויכע באַשטעטיקונגען.
ss_sampling_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט12
1 – 50
דענאָיִזינג־צאָל פֿאַר דער ערשטיקער סטרוקטור: מעגלעכע קוואַליטעט־געווינסן פֿון נאָך סטעפּס קומען מיט פּאַמעלעכער פּראַסעסירונג.
ss_rescale_tאָפּציאָנעל
טיפּnumber
סטאַנדאַרט5
1 – 6
שטעלט די שאַרפֿקייט פֿון טראַנסיציעס דורך דעם ראַש־סקעדזשול פֿאַר סטרוקטור־גענערירונג: דאָס פֿאַרגרעסערן מאַכט טראַנסיציעס שאַרפֿער.
shape_slat_guidance_strengthאָפּציאָנעל
טיפּnumber
סטאַנדאַרט7.5
0 – 10
קאָנטראָל פֿון פֿידעליטעט פֿאַר דעטאַלירטער געאָמעטריע: העכערע צוגעפּאַסטקייט צו דער אַרײַנגעבונגס־בילד גיט נאָך דעטאַלן, מיט ריזיקירן פֿון צוגעגעבענעם ראַש.
shape_slat_guidance_rescaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.5
0 – 1
פֿאַרגרעסערט די באַשטעטיקונג ווען די געאָמעטריע זעט אויס ראַשיק: עס רעדוצירט אַרטעפֿאַקטן געפֿירט דורך שטאַרקע גיידאַנס בעת דער פֿאָרעם־סטאַגע.
shape_slat_sampling_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט12
1 – 50
דענאָיִזינג־צאָל פֿאַר פֿאָרעם־פֿײַנונג: פּאָטענציעל גלאַטערע געאָמעטריע קאָסט גיכקייט ווען מע ניצט נאָך סטעפּס.
shape_slat_rescale_tאָפּציאָנעל
טיפּnumber
סטאַנדאַרט3
1 – 6
שטעלט די שאַרפֿקייט פֿון געאָמעטרישן דעטאַל דורך דעם ראַש־סקעדזשול פֿאַר פֿאָרעם־פֿײַנונג; דאָס פֿאַרגרעסערן גיט שאַרפֿערע דעטאַלן.
tex_slat_guidance_strengthאָפּציאָנעל
טיפּnumber
סטאַנדאַרט1
0 – 10
קאָנטראָל פֿון קאָליר־פֿידעליטעט פֿאַר טעקסטור: נעענטערע צוגעפּאַסטקייט צו די קאָלירן אין דער אַרײַנגעבונגס־בילד בײַ העכערע באַשטעטיקונגען פֿאַרגרעסערט די לעבעדיקייט, אָבער קען שאַפֿן איבערזעטיקונג.
tex_slat_guidance_rescaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0
0 – 1
פֿאַרגרעסערט די באַשטעטיקונג צו באַהאַנדלען ראַשיקע טעקסטורן אָדער קאָליר־באַנדירונג: עס רעדוצירט אַרטעפֿאַקטן פֿון שטאַרקע גיידאַנס בעת דער טעקסטור־סטאַגע.
tex_slat_sampling_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט12
1 – 50
צאָל דענאָיִזינג־סטעפּס גענוצט צו גענערירן טעקסטורן. דאָס פֿאַרגרעסערן די סטעפּ־צאָל נעמט לענגער אָבער קען געבן ריינערע טעקסטורן.
tex_slat_rescale_tאָפּציאָנעל
טיפּnumber
סטאַנדאַרט3
1 – 6
שטעלט די שאַרפֿקייט פֿון טעקסטור־דעטאַל דורך דעם ראַש־סקעדזשול פֿאַר טעקסטור־גענערירונג; דאָס פֿאַרגרעסערן גיט שאַרפֿערע דעטאַלן.
mesh_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט1
0.1 – 4
סקעילט דעם אָפּגעשאַצטן מעש צו ווירקן אויף דער אָפּשאַצונג פֿון דער אַפּאַראַט־דיסטאַנץ וואָס דער מאָדעל ניצט.
max_num_tokensאָפּציאָנעל
טיפּinteger
סטאַנדאַרט49152
4,096 – 131,072
HR־טאָקען־גרענעץ פֿאַר דעם קאַסקאַדירטן פֿאָרעם־סאַמפּלער, וואָס באַלאַנסירט פֿײַנערע געאָמעטריע בײַ העכערע באַשטעטיקונגען קעגן זכּרון־און־פּראַסעסירונג־צײַט־שפּאָרונגען בײַ נידעריקערע באַשטעטיקונגען.
decimation_targetאָפּציאָנעל
טיפּinteger
סטאַנדאַרט200000
5,000 – 1,586,021
ציל פֿאַר מעש־קאָמפּלעקסיטעט, אויסגעדריקט ווי אַ ווערטעקס־צאָל פֿאַרן ענדגילטיקן רעזולטאַט. דאָס רעדוצירן די פֿײַל־גרייס דורך אַראָפּנידערן דעם ציל קרבנות אויך דעטאַלן.
texture_sizeאָפּציאָנעל
טיפּenum
סטאַנדאַרט2048
102420484096
מעש־טעקסטור־רעזאָלוציע פֿאַר באַקינג. פֿײַנערע אויבערפֿלאַך־דעטאַלן ברענגען גרעסערע פֿײַלן ווען די רעזאָלוציע ווערט פֿאַרגרעסערט.
remeshאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
אויפֿבויען די מעש־טאָפּאָלאָגיע, וואָס העלפֿט בדרך־כלל בײַם ווײַטערדיקן באַניץ דורך שאַפֿן ריינערע טריאַנגען, אויפֿן חשבון פֿון לענגערער פּראַסעסירונג.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
סקרינינג קען ווערן פאַרלייכטערט דורך שטעלן false, אויב דער רופער איז אָטעריזירט.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixal3d",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "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
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "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 איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
model_glb
object {url, content_type, file_name, file_size}3D־מאָדעל גענערירט אין GLB פֿאָרמאַט.
seed
integerסיד־ווערט וואָס איז טאַקע גענוצט געוואָרן.

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