Passer au contenu

Tripo3D · Image to 3D

Intégrer

Identifiant du modèle tripo3d/tripo/v2.5/image-to-3d
# 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/tripo3d/tripo/v2.5/image-to-3d?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"

Fichiers comme dans l’exemple: 0,30 $ 300 crédits API · ≈ 32,19 ₽ vos fichiers sont mesurés avant l’exécution L’exécuter sur cette page

Obtenir une clé API
Tripo Image vers 3D #image-to-3d#stylized

Image vers 3D (v2.5) avec préréglages de style, texturation HD, sortie quad et options d'alignement

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 utilisée pour générer le modèle.

texture par défaut standard

Paramètre de texture du modèle : 'standard' est la valeur par défaut, 'no' désactive les textures et 'HD' produit des textures haute définition.

Paramètre de style ; laissez-le non spécifié pour conserver l'apparence et le style d'origine.

Avancé texture_alignment · orientation · face_limit · seed · texture_seed · pbr · auto_size
texture_alignment par défaut original_image

Paramètre de priorité de l'alignement des textures pour un modèle 3D, utilisant original_image sauf si une autre valeur est fournie.

orientation par défaut default

Orientation du modèle, initialement définie sur `default`. Choisissez `align_image` pour faire pivoter automatiquement le modèle afin de l'aligner sur l'image d'origine.

Limite du nombre de faces en sortie, choisie de manière adaptative sauf si vous fournissez une limite explicite.

Graine entière contrôlant la génération de géométrie ; sa réutilisation produit des modèles identiques. Une valeur aléatoire est sélectionnée si elle est omise.

Graine de génération des textures, fournie sous forme d'entier ou choisie aléatoirement si elle est omise. Des valeurs de graine identiques reproduisent les textures ; pour modifier les textures d'un modèle, faites varier texture_seed tout en conservant la graine du modèle.

POST /run/tripo3d/tripo/v2.5/image-to-3d?wait=20 devis → 0,30 $
# 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/tripo3d/tripo/v2.5/image-to-3d?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"

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 Tripo3D · Image to 3D

Génère un modèle 3D à partir d'une seule `image_url`. `texture` peut être no, standard ou HD, avec une sortie PBR facultative. Un préréglage `style` tel que clay, steampunk, gold ou ancient bronze peut modifier le style du résultat. Les autres contrôles incluent `face_limit`, `quad` (force FBX), `auto_size`, `texture_alignment` et `orientation` pour aligner le modèle sur l'image.

Paramètres

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

NomType Par défautAutorisé Description
seedfacultatif
Typeinteger | null
Graine entière contrôlant la génération de géométrie ; sa réutilisation produit des modèles identiques. Une valeur aléatoire est sélectionnée si elle est omise.
face_limitfacultatif
Typeinteger | null
Limite du nombre de faces en sortie, choisie de manière adaptative sauf si vous fournissez une limite explicite.
pbrfacultatif
Typeboolean | null
Par défautfalse
Commutateur PBR : False produit un modèle sans PBR, tandis que True remplace le paramètre de texture et le traite comme True. PBR est activé par défaut.
texturefacultatif
Typeenum
Par défautstandard
nostandardHD
Paramètre de texture du modèle : 'standard' est la valeur par défaut, 'no' désactive les textures et 'HD' produit des textures haute définition.
texture_seedfacultatif
Typeinteger | null
Graine de génération des textures, fournie sous forme d'entier ou choisie aléatoirement si elle est omise. Des valeurs de graine identiques reproduisent les textures ; pour modifier les textures d'un modèle, faites varier texture_seed tout en conservant la graine du modèle.
auto_sizefacultatif
Typeboolean | null
Par défautfalse
Commutateur de dimensionnement réel, désactivé par défaut (False), qui ajuste automatiquement les dimensions du modèle en mètres.
stylefacultatif
Typeenum
person:person2cartoonobject:clayobject:steampunkanimal:venomobject:barbieobject:christmasgoldancient_bronze
Paramètre de style ; laissez-le non spécifié pour conserver l'apparence et le style d'origine.
quadfacultatif
Typeboolean | null
Par défautfalse
Le mode quad force une sortie FBX lorsqu'il est activé. Avec quad=True et sans face_limit spécifié, face_limit prend par défaut la valeur 10000.
texture_alignmentfacultatif
Typeenum
Par défautoriginal_image
original_imagegeometry
Paramètre de priorité de l'alignement des textures pour un modèle 3D, utilisant original_image sauf si une autre valeur est fournie.
orientationfacultatif
Typeenum
Par défautdefault
defaultalign_image
Orientation du modèle, initialement définie sur `default`. Choisissez `align_image` pour faire pivoter automatiquement le modèle afin de l'aligner sur l'image d'origine.
image_urlrequis image
Typeurl · image
URL de l'image utilisée pour générer le modèle.
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/tripo/v2.5/image-to-3d",
  "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": {
    "task_id": "string",
    "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
    },
    "base_model": {
      "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
    },
    "pbr_model": {
      "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
    },
    "rendered_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
    }
  },
  "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"
  }
}
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
task_id
stringIdentifiant de tâche pour générer le modèle 3D.
model_mesh
object {url, content_type, file_name, file_size} | nullSortie du modèle.
base_model
object {url, content_type, file_name, file_size} | nullSortie du modèle de base.
pbr_model
object {url, content_type, file_name, file_size} | nullSortie du modèle PBR.
rendered_image
object {url, content_type, file_name, file_size} | nullImage affichant un aperçu du modèle.

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/tripo/v2.5/image-to-3d.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt