Мазмұнға өту

Pixal3d

Интеграциялау

Модель идентификаторы 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
Файлды тастаңыз немесе

3D түрлендіруге арналған бастапқы кескінге сілтейтін URL.

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

Соңғы нәтиже үшін төбелер саны ретінде берілетін меш күрделілігінің мақсаты. Бұл мақсатты төмендету файл өлшемін азайтады, бірақ детальдарды да кемітеді.

Қайталанымды кездейсоқ генерация үшін қолданылатын seed.

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"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Pixal3d туралы

Бір кескін қабылдап, GLB моделін және пайдаланылған сидті қайтарады. Құрылым, пішін және текстура кезеңдерінің әрқайсысында жеке бағыттау, қайта масштабтау, қадам саны және шу кестесі параметрлері бар. Шығыс `resolution` 1024 немесе 1536, `texture_size` 1024, 2048 немесе 4096, ал `decimation_target` төбелер санын 5000-нан 1586021-ге дейін белгілейді. `remesh` топологияны қайта құрады.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
image_urlміндетті image
Түріurl · image
3D түрлендіруге арналған бастапқы кескінге сілтейтін URL.
seedміндетті емес
Түріinteger | null
Қайталанымды кездейсоқ генерация үшін қолданылатын seed.
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 мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
model_glb
object {url, content_type, file_name, file_size}GLB пішімінде жасалған 3D модель.
seed
integerІс жүзінде қолданылған seed мәні.

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/pixal3d.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt