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,24 ₽ 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 en quads et options d’alignement

Tripo · 3D

Votre premier résultat apparaîtra ici

Créez 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 pendant 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 au fur et à mesure de vos modifications.

•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

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

Réglage du 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

Réglage de priorité de l’alignement des textures d’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 de sortie, choisie de façon adaptative sauf si vous fournissez une limite explicite.

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

Graine de génération des textures, fournie sous forme entière ou choisie aléatoirement lorsqu’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 au 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` comme clay, steampunk, gold ou ancient bronze peut modifier le style du résultat. Les autres contrôles comprennent `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 la géométrie; sa réutilisation produit des modèles identiques. Une valeur aléatoire est sélectionnée lorsqu’elle est omise.
face_limitfacultatif
Typeinteger | null
Limite du nombre de faces de sortie, choisie de façon 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 réglage des textures et le traite comme True. PBR est activé par défaut.
texturefacultatif
Typeenum
Par défautstandard
nostandardHD
Réglage des textures 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 entière ou choisie aléatoirement lorsqu’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
Réglage du 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 aucun face_limit spécifié, face_limit prend par défaut la valeur 10000.
texture_alignmentfacultatif
Typeenum
Par défautoriginal_image
original_imagegeometry
Réglage de priorité de l’alignement des textures d’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 par Go-mois) ou pendant 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, les vidéos et les fichiers audio. output est l’objet de résultat propre au 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 montrant un aperçu du modèle.

Plus de modèles : Image vers 3D

Pour les agents IA : cette page en Markdown se trouve à https://doitong.com/fr-CA/developers/models/tripo3d/tripo/v2.5/image-to-3d.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt