Przejdź do treści

Pixal3d

Integracja

Identyfikator modelu 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"

To żądanie: 0,30 $ 300 kredytów API Uruchom na tej stronie

Uzyskaj klucz API
Open model Obraz na 3D #stylized#transform

Konwertuje pojedynczy obraz na teksturowany model 3D GLB ze szczegółową kontrolą każdego etapu generowania

Open model · 3D

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane image_url
Upuść plik lub

Adres URL wskazujący obraz źródłowy do konwersji 3D.

resolution domyślnie 1024

Rozdzielczość wyniku; jej zwiększenie dodaje szczegółów, ale wydłuża przetwarzanie.

Zaawansowane 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 domyślnie 2048

Rozdzielczość tekstury siatki do wypalania. Większa szczegółowość powierzchni oznacza większe pliki po zwiększeniu tej rozdzielczości.

domyślnie 7.5

Kontrola wierności początkowej struktury 3D: jej zwiększenie sprzyja lepszemu odwzorowaniu obrazu wejściowego kosztem dodatkowego szumu.

domyślnie 0.7

Kontrola artefaktów prowadzenia etapu 1, równoważąca silniejsze efekty prowadzenia przy niskich ustawieniach ze stabilniejszym wynikiem przy wysokich ustawieniach.

domyślnie 12

Liczba kroków odszumiania struktury początkowej: potencjalna poprawa jakości dzięki dodatkowym krokom oznacza wolniejsze przetwarzanie.

domyślnie 5

Ustaw ostrość przejścia za pomocą harmonogramu szumu generowania struktury: zwiększenie tej wartości wyostrza przejścia.

domyślnie 7.5

Kontrola wierności szczegółowej geometrii: większe dopasowanie do obrazu wejściowego daje więcej szczegółów, ale zwiększa ryzyko dodatkowego szumu.

domyślnie 0.5

Zwiększ to ustawienie, gdy geometria jest zaszumiona: ogranicza artefakty powodowane silnym prowadzeniem podczas etapu kształtu.

domyślnie 12

Liczba kroków odszumiania dopracowania kształtu: potencjalnie gładsza geometria odbywa się kosztem szybkości przy użyciu dodatkowych kroków.

domyślnie 3

Ustaw ostrość szczegółów geometrycznych za pomocą harmonogramu szumu dopracowania kształtu; zwiększenie tej wartości daje ostrzejsze szczegóły.

domyślnie 1

Kontrola wierności kolorów tekstury: większe dopasowanie do kolorów obrazu wejściowego przy wyższych ustawieniach zwiększa intensywność, ale może powodować nadmierne nasycenie.

domyślnie 0

Zwiększ to ustawienie, aby ograniczyć zaszumione tekstury lub pasmowanie kolorów: redukuje artefakty powodowane silnym prowadzeniem podczas etapu tekstury.

domyślnie 12

Liczba kroków odszumiania użytych do generowania tekstur. Zwiększenie liczby kroków wydłuża działanie, ale może dać czystsze tekstury.

domyślnie 3

Ustaw ostrość szczegółów tekstury za pomocą harmonogramu szumu generowania tekstury; zwiększenie tej wartości daje ostrzejsze szczegóły.

domyślnie 1

Skaluj wywnioskowaną siatkę, aby wpłynąć na używane przez model oszacowanie odległości kamery.

domyślnie 49152

Limit tokenów HR dla kaskadowego próbnika kształtu, równoważący dokładniejszą geometrię przy wyższych ustawieniach z oszczędnością pamięci i czasu przetwarzania przy niższych ustawieniach.

domyślnie 200000

Docelowa złożoność siatki wyrażona liczbą wierzchołków wyniku końcowego. Zmniejszenie rozmiaru pliku przez obniżenie celu poświęca również szczegółowość.

Ziarno używane do powtarzalnego generowania losowego.

POST /run/pixal3d?wait=20 wycena → 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"

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o Pixal3d

Przyjmuje jeden obraz i zwraca model GLB oraz użyte ziarno. Etapy struktury, kształtu i tekstury mają własne ustawienia sterowania, przeskalowania, liczby kroków i harmonogramu szumu. Wynikowa `resolution` to 1024 lub 1536, `texture_size` to 1024, 2048 lub 4096, a `decimation_target` ustawia liczbę wierzchołków od 5000 do 1586021. `remesh` przebudowuje topologię.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
image_urlwymagane image
Typurl · image
Adres URL wskazujący obraz źródłowy do konwersji 3D.
seedopcjonalne
Typinteger | null
Ziarno używane do powtarzalnego generowania losowego.
resolutionopcjonalne
Typenum
Domyślne1024
10241536
Rozdzielczość wyniku; jej zwiększenie dodaje szczegółów, ale wydłuża przetwarzanie.
ss_guidance_strengthopcjonalne
Typnumber
Domyślne7.5
0 – 10
Kontrola wierności początkowej struktury 3D: jej zwiększenie sprzyja lepszemu odwzorowaniu obrazu wejściowego kosztem dodatkowego szumu.
ss_guidance_rescaleopcjonalne
Typnumber
Domyślne0.7
0 – 1
Kontrola artefaktów prowadzenia etapu 1, równoważąca silniejsze efekty prowadzenia przy niskich ustawieniach ze stabilniejszym wynikiem przy wysokich ustawieniach.
ss_sampling_stepsopcjonalne
Typinteger
Domyślne12
1 – 50
Liczba kroków odszumiania struktury początkowej: potencjalna poprawa jakości dzięki dodatkowym krokom oznacza wolniejsze przetwarzanie.
ss_rescale_topcjonalne
Typnumber
Domyślne5
1 – 6
Ustaw ostrość przejścia za pomocą harmonogramu szumu generowania struktury: zwiększenie tej wartości wyostrza przejścia.
shape_slat_guidance_strengthopcjonalne
Typnumber
Domyślne7.5
0 – 10
Kontrola wierności szczegółowej geometrii: większe dopasowanie do obrazu wejściowego daje więcej szczegółów, ale zwiększa ryzyko dodatkowego szumu.
shape_slat_guidance_rescaleopcjonalne
Typnumber
Domyślne0.5
0 – 1
Zwiększ to ustawienie, gdy geometria jest zaszumiona: ogranicza artefakty powodowane silnym prowadzeniem podczas etapu kształtu.
shape_slat_sampling_stepsopcjonalne
Typinteger
Domyślne12
1 – 50
Liczba kroków odszumiania dopracowania kształtu: potencjalnie gładsza geometria odbywa się kosztem szybkości przy użyciu dodatkowych kroków.
shape_slat_rescale_topcjonalne
Typnumber
Domyślne3
1 – 6
Ustaw ostrość szczegółów geometrycznych za pomocą harmonogramu szumu dopracowania kształtu; zwiększenie tej wartości daje ostrzejsze szczegóły.
tex_slat_guidance_strengthopcjonalne
Typnumber
Domyślne1
0 – 10
Kontrola wierności kolorów tekstury: większe dopasowanie do kolorów obrazu wejściowego przy wyższych ustawieniach zwiększa intensywność, ale może powodować nadmierne nasycenie.
tex_slat_guidance_rescaleopcjonalne
Typnumber
Domyślne0
0 – 1
Zwiększ to ustawienie, aby ograniczyć zaszumione tekstury lub pasmowanie kolorów: redukuje artefakty powodowane silnym prowadzeniem podczas etapu tekstury.
tex_slat_sampling_stepsopcjonalne
Typinteger
Domyślne12
1 – 50
Liczba kroków odszumiania użytych do generowania tekstur. Zwiększenie liczby kroków wydłuża działanie, ale może dać czystsze tekstury.
tex_slat_rescale_topcjonalne
Typnumber
Domyślne3
1 – 6
Ustaw ostrość szczegółów tekstury za pomocą harmonogramu szumu generowania tekstury; zwiększenie tej wartości daje ostrzejsze szczegóły.
mesh_scaleopcjonalne
Typnumber
Domyślne1
0,1 – 4
Skaluj wywnioskowaną siatkę, aby wpłynąć na używane przez model oszacowanie odległości kamery.
max_num_tokensopcjonalne
Typinteger
Domyślne49152
4096 – 131 072
Limit tokenów HR dla kaskadowego próbnika kształtu, równoważący dokładniejszą geometrię przy wyższych ustawieniach z oszczędnością pamięci i czasu przetwarzania przy niższych ustawieniach.
decimation_targetopcjonalne
Typinteger
Domyślne200000
5000 – 1 586 021
Docelowa złożoność siatki wyrażona liczbą wierzchołków wyniku końcowego. Zmniejszenie rozmiaru pliku przez obniżenie celu poświęca również szczegółowość.
texture_sizeopcjonalne
Typenum
Domyślne2048
102420484096
Rozdzielczość tekstury siatki do wypalania. Większa szczegółowość powierzchni oznacza większe pliki po zwiększeniu tej rozdzielczości.
remeshopcjonalne
Typboolean
Domyślnetrue
Przebudowa topologii siatki, która zwykle usprawnia dalsze użycie dzięki tworzeniu czystszych trójkątów kosztem dłuższego przetwarzania.
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Filtrowanie można złagodzić, ustawiając false, jeśli wywołujący ma odpowiednie uprawnienia.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

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"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
model_glb
object {url, content_type, file_name, file_size}Model 3D wygenerowany w formacie GLB.
seed
integerRzeczywiście użyta wartość ziarna.

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/pixal3d.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt