Passer au contenu

Triposplat

Intégrer

Identifiant du modèle tripo3d/triposplat
# 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/tripo3d/triposplat?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"

Cette requête: 0,05 $ 50 crédits API L’exécuter sur cette page

Obtenir une clé API
Tripo · 3D

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•requis image_url
Déposez un fichier, ou

URL de l'image source pour la conversion en nuage de points gaussiens 3D.

Avancé output_format · num_gaussians · num_inference_steps · guidance_scale · seed · enable_safety_checker
output_format par défaut ply

Format du fichier de sortie du nuage de points gaussiens.

par défaut 262144

Nombre de Gaussiens souhaité pour le nuage généré, arrondi en interne au multiple de 32 le plus proche. L'augmenter ajoute des détails, mais augmente également la taille du fichier et ralentit le rendu.

par défaut 20

Nombre d'étapes pour l'échantillonneur flow-matching.

par défaut 3

Contrôle du guidage sans classifieur : des paramètres plus élevés ajoutent des détails et rapprochent le résultat de l'image source, au risque de couleurs sursaturées. Le guidage est désactivé à 1.0 ou moins.

Graine utilisée pour reproduire les résultats. La valeur None sélectionne une graine aléatoire.

POST /run/tripo3d/triposplat?wait=20 devis → 0,05 $
# 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/tripo3d/triposplat?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"

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Triposplat

Génère un splat gaussien 3D à partir d'une seule image (`image_url`) plutôt que d'un maillage. `num_gaussians` va de 32,768 à 262,144 et `output_format` vaut ply ou splat. Vous pouvez aussi définir `num_inference_steps` (1-50), `guidance_scale` et `seed`. La réponse inclut le nombre réel de gaussiennes ainsi que l'image sans arrière-plan utilisée par le modèle.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
image_urlrequis image
Typeurl · image
URL de l'image source pour la conversion en nuage de points gaussiens 3D.
num_gaussiansfacultatif
Typeinteger
Par défaut262144
32 768 – 262 144
Nombre de Gaussiens souhaité pour le nuage généré, arrondi en interne au multiple de 32 le plus proche. L'augmenter ajoute des détails, mais augmente également la taille du fichier et ralentit le rendu.
num_inference_stepsfacultatif
Typeinteger
Par défaut20
1 – 50
Nombre d'étapes pour l'échantillonneur flow-matching.
guidance_scalefacultatif
Typenumber
Par défaut3
0 – 10
Contrôle du guidage sans classifieur : des paramètres plus élevés ajoutent des détails et rapprochent le résultat de l'image source, au risque de couleurs sursaturées. Le guidage est désactivé à 1.0 ou moins.
output_formatfacultatif
Typeenum
Par défautply
plysplat
Format du fichier de sortie du nuage de points gaussiens.
seedfacultatif
Typeinteger | null
Graine utilisée pour reproduire les résultats. La valeur None sélectionne une graine aléatoire.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Activation du contrôle de sécurité de l'image source.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/triposplat",
  "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": 50,
    "usd": "0.05",
    "charged": 50,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_mesh": {
      "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
    },
    "preprocessed_image": {
      "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,
      "width": 1024,
      "height": 768
    },
    "num_gaussians": 1,
    "seed": 42,
    "timings": {}
  },
  "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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
model_mesh
object {url, content_type, file_name, file_size}Fichier de sortie contenant le nuage de points gaussiens 3D, au format .ply ou .splat.
preprocessed_image
object {url, content_type, file_name, file_size, width, height}Image effectivement utilisée par le modèle : composition RGB affichant le premier plan sur fond noir après suppression de l'arrière-plan.
num_gaussians
integerNombre réel de Gaussiens générés.
seed
integerValeur du seed appliquée pendant la génération.
timings
objectTemps consacré à chaque étape, mesuré en secondes.

Plus de modèles : Image vers 3D

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/tripo3d/triposplat.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt