Zum Inhalt springen

TRELLIS.2 LoRA Inference

Integrieren

Modell-ID trellis-2-lora
# 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-lora?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Diese Anfrage: 0,25 $ 250 API-Credits · ≈ 26,37 ₽ Auf dieser Seite ausführen

API-Schlüssel abrufen
Microsoft Bild zu 3D

Trellis-2-Bild-zu-3D, das benutzerdefinierte LoRA-Adapter für Struktur, Geometrie und Textur anwenden kann

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 Quellbilds zur Konvertierung in ein 3D-Modell.

resolution Standard 512

Generierungsauflösung, wobei 1024 die Cascade-Pipeline auswählt. Wähle die Auflösung, mit der die bereitgestellten LoRA-Adapter trainiert wurden; eine Übereinstimmung ist erforderlich.

Erweitert texture_lora_url · texture_size · sparse_structure_lora_url · geometry_lora_url · ss_guidance_strength · ss_guidance_rescale · ss_guidance_interval_start · ss_guidance_interval_end · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_guidance_interval_start · shape_slat_guidance_interval_end · shape_slat_sampling_steps · shape_slat_rescale_t · 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 · decimation_target · seed · enable_safety_checker

Optionaler LoRA-Checkpoint im safetensors-Format, speziell für den Textur-Entrauscher trainiert.

texture_size Standard 2048

Auflösung der in den GLB-Export eingebetteten Texturen.

Optionaler LoRA-Checkpoint im safetensors-Format, speziell für den Entrauscher der spärlichen Struktur trainiert.

Optionaler LoRA-Checkpoint im safetensors-Format, speziell für den Geometrie-Entrauscher trainiert.

Standard 7.5

Stärke der classifier-free guidance während der Generierung der spärlichen Struktur.

Standard 0.7

Neuskalierung der Anleitung während der Generierung der spärlichen Struktur. Höhere Werte machen die Ausgabe stabiler.

Standard 0.6

Anteil des Entrauschungsfortschritts, bei dem die Anleitung der spärlichen Struktur beginnt.

Standard 1

Verwende einen Entrauschungsanteil mindestens so groß wie `ss_guidance_interval_start`, um festzulegen, wann die Anleitung der spärlichen Struktur endet.

Standard 12

Anzahl der Entrauschungsschritte während der Generierung der spärlichen Struktur.

Standard 5

Schärfe des Rauschplans während der Generierung der spärlichen Struktur.

Standard 7.5

Stärke der classifier-free guidance während der Formgenerierung.

Standard 0.5

Auf die Anleitung angewendete Neuskalierung während der Formgenerierung; erhöhe sie, wenn die Geometrie verrauscht wirkt.

Standard 0.6

Anteil der Entrauschung, bei dem die Anleitung der Formstufe beginnt.

Standard 1

Endpunkt der Anleitung der Formstufe, ausgedrückt als Entrauschungsanteil, der nicht kleiner als shape_slat_guidance_interval_start ist.

Standard 12

Anzahl der Entrauschungsschritte während der Formgenerierung.

Standard 3

Schärfe des Rauschplans während der Formgenerierung.

Standard 1

Stärke der classifier-free guidance während der Texturgenerierung.

Standard 0

Auf die Anleitung angewendete Neuskalierung während der Texturgenerierung; erhöhe sie, wenn Texturen verrauscht wirken.

Standard 0.6

Anteil der Entrauschung, bei dem die Anleitung der Texturstufe beginnt.

Standard 0.9

Endpunkt der Anleitung der Texturstufe, ausgedrückt als Entrauschungsanteil, der nicht kleiner als tex_slat_guidance_interval_start ist.

Standard 12

Anzahl der Entrauschungsschritte während der Texturgenerierung.

Standard 3

Schärfe des Rauschplans während der Texturgenerierung.

Standard 500000

Gewünschte Vertex-Anzahl im GLB-Export.

Zufälliger Seed, der eine reproduzierbare Generierung ermöglicht.

POST /run/trellis-2-lora?wait=20 Preis → 0,25 $
# 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-lora?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.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 LoRA Inference

Erzeugt ein GLB aus `image_url` und kann optional safetensors-LoRAs über `sparse_structure_lora_url`, `geometry_lora_url` und `texture_lora_url` anwenden. `resolution` ist 512 oder 1024 und muss der Trainingsauflösung der Adapter entsprechen. Außerdem verfügbar: stufenbezogene Einstellungen für Führung und Schritte, `decimation_target` und `texture_size`.

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 Quellbilds zur Konvertierung in ein 3D-Modell.
sparse_structure_lora_urloptional
Typstring | null
Optionaler LoRA-Checkpoint im safetensors-Format, speziell für den Entrauscher der spärlichen Struktur trainiert.
geometry_lora_urloptional
Typstring | null
Optionaler LoRA-Checkpoint im safetensors-Format, speziell für den Geometrie-Entrauscher trainiert.
texture_lora_urloptional
Typstring | null
Optionaler LoRA-Checkpoint im safetensors-Format, speziell für den Textur-Entrauscher trainiert.
seedoptional
Typinteger | null
Zufälliger Seed, der eine reproduzierbare Generierung ermöglicht.
resolutionoptional
Typenum
Standard512
5121024
Generierungsauflösung, wobei 1024 die Cascade-Pipeline auswählt. Wähle die Auflösung, mit der die bereitgestellten LoRA-Adapter trainiert wurden; eine Übereinstimmung ist erforderlich.
ss_guidance_strengthoptional
Typnumber
Standard7.5
0 – 10
Stärke der classifier-free guidance während der Generierung der spärlichen Struktur.
ss_guidance_rescaleoptional
Typnumber
Standard0.7
0 – 1
Neuskalierung der Anleitung während der Generierung der spärlichen Struktur. Höhere Werte machen die Ausgabe stabiler.
ss_guidance_interval_startoptional
Typnumber
Standard0.6
0 – 1
Anteil des Entrauschungsfortschritts, bei dem die Anleitung der spärlichen Struktur beginnt.
ss_guidance_interval_endoptional
Typnumber
Standard1
0 – 1
Verwende einen Entrauschungsanteil mindestens so groß wie `ss_guidance_interval_start`, um festzulegen, wann die Anleitung der spärlichen Struktur endet.
ss_sampling_stepsoptional
Typinteger
Standard12
1 – 50
Anzahl der Entrauschungsschritte während der Generierung der spärlichen Struktur.
ss_rescale_toptional
Typnumber
Standard5
1 – 6
Schärfe des Rauschplans während der Generierung der spärlichen Struktur.
shape_slat_guidance_strengthoptional
Typnumber
Standard7.5
0 – 10
Stärke der classifier-free guidance während der Formgenerierung.
shape_slat_guidance_rescaleoptional
Typnumber
Standard0.5
0 – 1
Auf die Anleitung angewendete Neuskalierung während der Formgenerierung; erhöhe sie, wenn die Geometrie verrauscht wirkt.
shape_slat_guidance_interval_startoptional
Typnumber
Standard0.6
0 – 1
Anteil der Entrauschung, bei dem die Anleitung der Formstufe beginnt.
shape_slat_guidance_interval_endoptional
Typnumber
Standard1
0 – 1
Endpunkt der Anleitung der Formstufe, ausgedrückt als Entrauschungsanteil, der nicht kleiner als shape_slat_guidance_interval_start ist.
shape_slat_sampling_stepsoptional
Typinteger
Standard12
1 – 50
Anzahl der Entrauschungsschritte während der Formgenerierung.
shape_slat_rescale_toptional
Typnumber
Standard3
1 – 6
Schärfe des Rauschplans während der Formgenerierung.
tex_slat_guidance_strengthoptional
Typnumber
Standard1
0 – 10
Stärke der classifier-free guidance während der Texturgenerierung.
tex_slat_guidance_rescaleoptional
Typnumber
Standard0
0 – 1
Auf die Anleitung angewendete Neuskalierung während der Texturgenerierung; erhöhe sie, wenn Texturen verrauscht wirken.
tex_slat_guidance_interval_startoptional
Typnumber
Standard0.6
0 – 1
Anteil der Entrauschung, bei dem die Anleitung der Texturstufe beginnt.
tex_slat_guidance_interval_endoptional
Typnumber
Standard0.9
0 – 1
Endpunkt der Anleitung der Texturstufe, ausgedrückt als Entrauschungsanteil, der nicht kleiner als tex_slat_guidance_interval_start ist.
tex_slat_sampling_stepsoptional
Typinteger
Standard12
1 – 50
Anzahl der Entrauschungsschritte während der Texturgenerierung.
tex_slat_rescale_toptional
Typnumber
Standard3
1 – 6
Schärfe des Rauschplans während der Texturgenerierung.
decimation_targetoptional
Typinteger
Standard500000
5.000 – 2.000.000
Gewünschte Vertex-Anzahl im GLB-Export.
texture_sizeoptional
Typenum
Standard2048
102420484096
Auflösung der in den GLB-Export eingebetteten Texturen.
enable_safety_checkeroptional
Typboolean
Standardtrue
Die Prüfung kann durch Setzen auf false gelockert werden, sofern der Aufrufer dazu berechtigt ist.
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-lora",
  "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": 250,
    "usd": "0.25",
    "charged": 250,
    "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,
    "resolution": 1,
    "sparse_structure_lora_url": "string",
    "geometry_lora_url": "string",
    "texture_lora_url": "string",
    "decimation_target": 1,
    "texture_size": 1
  },
  "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}GLB-Datei mit dem generierten 3D-Modell.
seed
integerBei der Generierung verwendeter Seed.
resolution
integerAuflösung, bei der die Generierung durchgeführt wurde.
sparse_structure_lora_url
string | nullWährend der Generierung verwendeter LoRA-Checkpoint für die spärliche Struktur, falls einer angewendet wurde.
geometry_lora_url
string | nullWährend der Generierung verwendeter Geometrie-LoRA-Checkpoint, falls einer angewendet wurde.
texture_lora_url
string | nullWährend der Generierung verwendeter Textur-LoRA-Checkpoint, falls einer angewendet wurde.
decimation_target
integerAuf den GLB-Export angewendetes Vertex-Anzahlziel.
texture_size
integerAuflösung der in den GLB-Export eingebetteten Texturen.

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