Zum Inhalt springen

Trellis 2 · Retexture

Integrieren

Modell-ID trellis-2/retexture
# 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/trellis-2/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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"

Diese Anfrage: 0,24 $ 240 API-Credits · ≈ 25,31 ₽ Auf dieser Seite ausführen

API-Schlüssel abrufen
Microsoft Bild zu 3D #image-to-3d

Texturiert ein vorhandenes untexturiertes 3D-Mesh passend zu einem Referenzbild neu und gibt GLB aus

Microsoft · 3D

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

•erforderlich image_url
Datei ablegen oder

URL des Referenzbilds für die Texturierung.

resolution Standard 1024

Texturdetails und Verarbeitungsgeschwindigkeit hängen von dieser internen Generierungsauflösung ab: Eine Erhöhung liefert feinere Details, benötigt aber mehr Zeit.

•erforderlich

Quell-URL zur erneuten Texturierung eines untexturierten 3D-Meshes im GLB-, OBJ-, PLY- oder STL-Format.

Erweitert texture_size · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_guidance_interval_start · tex_slat_guidance_interval_end · tex_slat_sampling_steps · tex_slat_rescale_t · seed
texture_size Standard 2048

Texturauflösung des Meshes zum Baken. Feinere Oberflächendetails führen bei höherer Auflösung zu größeren Dateien.

Standard 1

Steuerung der Farbtreue der Textur: höhere Werte halten sich stärker an die Farben des Eingabebilds, erhöhen die Leuchtkraft, können jedoch Übersättigung verursachen.

Standard 0

Erhöhen Sie diese Einstellung bei verrauschten Texturen oder Farbstreifen; sie reduziert durch starke Steuerung während der Texturphase verursachte Artefakte.

Standard 0.6

Aktivierungspunkt der classifier-free guidance für die Texturgenerierung. Als Anteil des Entrauschungsfortschritts legt er interval_start fest; die Anleitung wirkt nur innerhalb des von interval_start und interval_end begrenzten Fensters.

Standard 0.9

Endgrenze der classifier-free guidance der Texturstufe, angegeben als Entrauschungsanteil, der nicht kleiner als tex_slat_guidance_interval_start ist.

Standard 12

Anzahl der Denoising-Schritte zur TexTurerzeugung. Eine höhere Anzahl benötigt mehr Zeit, kann aber sauberere Texturen liefern.

Standard 3

Legt die Schärfe von Texturdetails über den Rauschplan der TexTurerzeugung fest; höhere Werte erzeugen schärfere Details.

Seed für reproduzierbare Zufallsgenerierung.

POST /run/trellis-2/retexture?wait=20 Preis → 0,24 $
# 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/trellis-2/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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"

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über Trellis 2 · Retexture

Wendet auf das Mesh unter `mesh_url` (GLB, OBJ, PLY oder STL) eine neue Textur basierend auf einem Referenzbild `image_url` an. `resolution` ist 512 oder 1024; `texture_size` ist 1024, 2048 oder 4096. Einstellungen für Führung und Sampling der Texturstufe sind verfügbar. Die Geometrie wird nicht neu erzeugt.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
image_urlerforderlich image
Typurl · image
URL des Referenzbilds für die Texturierung.
mesh_urlerforderlich
Typstring
Quell-URL zur erneuten Texturierung eines untexturierten 3D-Meshes im GLB-, OBJ-, PLY- oder STL-Format.
seedoptional
Typinteger | null
Seed für reproduzierbare Zufallsgenerierung.
resolutionoptional
Typenum
Standard1024
5121024
Texturdetails und Verarbeitungsgeschwindigkeit hängen von dieser internen Generierungsauflösung ab: Eine Erhöhung liefert feinere Details, benötigt aber mehr Zeit.
tex_slat_guidance_strengthoptional
Typnumber
Standard1
0 – 10
Steuerung der Farbtreue der Textur: höhere Werte halten sich stärker an die Farben des Eingabebilds, erhöhen die Leuchtkraft, können jedoch Übersättigung verursachen.
tex_slat_guidance_rescaleoptional
Typnumber
Standard0
0 – 1
Erhöhen Sie diese Einstellung bei verrauschten Texturen oder Farbstreifen; sie reduziert durch starke Steuerung während der Texturphase verursachte Artefakte.
tex_slat_guidance_interval_startoptional
Typnumber
Standard0.6
0 – 1
Aktivierungspunkt der classifier-free guidance für die Texturgenerierung. Als Anteil des Entrauschungsfortschritts legt er interval_start fest; die Anleitung wirkt nur innerhalb des von interval_start und interval_end begrenzten Fensters.
tex_slat_guidance_interval_endoptional
Typnumber
Standard0.9
0 – 1
Endgrenze der classifier-free guidance der Texturstufe, angegeben als Entrauschungsanteil, der nicht kleiner als tex_slat_guidance_interval_start ist.
tex_slat_sampling_stepsoptional
Typinteger
Standard12
1 – 50
Anzahl der Denoising-Schritte zur TexTurerzeugung. Eine höhere Anzahl benötigt mehr Zeit, kann aber sauberere Texturen liefern.
tex_slat_rescale_toptional
Typnumber
Standard3
1 – 6
Legt die Schärfe von Texturdetails über den Rauschplan der TexTurerzeugung fest; höhere Werte erzeugen schärfere Details.
texture_sizeoptional
Typenum
Standard2048
102420484096
Texturauflösung des Meshes zum Baken. Feinere Oberflächendetails führen bei höherer Auflösung zu größeren Dateien.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2/retexture",
  "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": 240,
    "usd": "0.24",
    "charged": 240,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "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
    }
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
model_glb
object {url, content_type, file_name, file_size}Im GLB-Format generiertes 3D-Modell.

Weitere Modelle: Bild zu 3D

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/trellis-2/retexture.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt