Accéder 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.

•obligatoire 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 Gauss souhaité pour le nuage généré, arrondi en interne au multiple de 32 le plus proche. L'augmentation de cette valeur ajoute des détails, mais augmente également la taille du fichier et ralentit le rendu.

par défaut 20

Nombre d'étapes de 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 Gaussian splat 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 également définir `num_inference_steps` (1-50), `guidance_scale` et `seed`. La réponse inclut le nombre réel de Gaussians et l'image dont l'arrière-plan a été supprimé et 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_urlobligatoire 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 Gauss souhaité pour le nuage généré, arrondi en interne au multiple de 32 le plus proche. L'augmentation de cette valeur 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 de 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
Commutateur de contrôle de sécurité pour l'image source.
obligatoire 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 sur notre stockage : conservée indéfiniment (facturation par Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Une structure identique pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et l'audio. output est l'objet de résultat propre au 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 : un assemblage RGB montrant le premier plan sur fond noir après suppression de l'arrière-plan.
num_gaussians
integerNombre réel de Gauss générés.
seed
integerValeur de graine 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 à l'adresse https://doitong.com/fr-FR/developers/models/tripo3d/triposplat.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt