Passer au contenu

PATINA · Material

Intégrer

Identifiant du modèle patina/material
# 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/patina/material?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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"

Fichiers comme dans l’exemple: 0,08 $ 80 crédits API vos fichiers sont mesurés avant l’exécution L’exécuter sur cette page

Obtenir une clé API
Open model Texte vers image #material#pbr#displacement#metalness

Générateur texte vers texture produisant des images répétables et des cartes PBR, avec img2img et inpainting facultatifs

Open model · image

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

Description textuelle du matériau ou de la texture à créer.

image_size par défaut square_hd

Dimensions en pixels de la texture obtenue.

upscale_factor par défaut 0

Facteur d’agrandissement sans jointure de SeedVR, qui affecte les cartes PBR prédites mais conserve la texture de base à sa résolution d’origine. Sélectionnez 2 pour doubler la résolution, 4 pour la quadrupler ou 0 pour désactiver l’agrandissement.

num_images par défaut 1

Nombre d’images de texture à créer.

Avancé image · mask · tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
image_url
Déposez un fichier, ou

URL de l’image source, utilisée pour l’inpainting si mask_url l’accompagne, et sinon pour le traitement image-à-image.

mask_url
Déposez un fichier, ou

URL du masque d’inpainting fournie avec image_url, qui est obligatoire. Le masque conserve les zones noires inchangées et régénère les zones blanches.

tiling_mode par défaut both

Direction du pavage : 'both' pour un pavage omnidirectionnel, 'horizontal' ou 'vertical'.

output_format par défaut png

Format de fichier image pour les textures et cartes PBR de sortie.

par défaut 8

Nombre d’étapes de débruitage utilisées pour générer les textures.

par défaut 128

Taille des pavés dans l’espace latent, où 64 représente 512px et 128 représente 1024px. Sur chaque axe pavé, la dimension de l’image générée définit une limite supérieure automatique.

par défaut 64

Définit le pas entre les pavés de l’espace latent ; une limite automatique l’empêche de dépasser la moitié de la taille effective du pavé.

par défaut 0.6

Intensité de transformation appliquée uniquement à une image fournie via image_url ; sinon inutilisée.

Seed aléatoire rendant la génération reproductible.

par défaut ["basecolor","normal"...

Cartes PBR sélectionnées pour la prédiction, les cinq étant sélectionnées par défaut. N’en sélectionner aucune ignore entièrement l’estimation PBR.

POST /run/patina/material?wait=20 devis → 0,08 $
# 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/patina/material?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 PATINA · Material

Crée des textures répétables à partir d’un prompt et prédit les cartes PBR : basecolor, normal, roughness, metalness et height. Utilisez `tiling_mode` pour le pavage dans les deux directions, horizontal ou vertical, et `upscale_factor` égal à 0, 2 ou 4 pour agrandir les cartes. La transmission de `image_url` active image-to-image et l’ajout de `mask_url` active l’inpainting. Jusqu’à 4 images par requête.

Paramètres

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

NomType Par défautAutorisé Description
promptrequis
Typestring
Description textuelle du matériau ou de la texture à créer.
image_sizefacultatif
Typeobject
Par défautsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensions en pixels de la texture obtenue.
num_inference_stepsfacultatif
Typeinteger
Par défaut8
1 – 8
Nombre d’étapes de débruitage utilisées pour générer les textures.
seedfacultatif
Typeinteger | null
Seed aléatoire rendant la génération reproductible.
num_imagesfacultatif num_outputs
Typeinteger
Par défaut1
1 – 4
Nombre d’images de texture à créer.
enable_prompt_expansionfacultatif
Typeboolean
Par défauttrue
Active l’expansion du prompt basée sur un LLM pour ajouter des détails.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Active la vérification de sécurité des images générées.
tiling_modefacultatif
Typeenum
Par défautboth
bothhorizontalvertical
Direction du pavage : 'both' pour un pavage omnidirectionnel, 'horizontal' ou 'vertical'.
tile_sizefacultatif
Typeinteger
Par défaut128
32 – 256
Taille des pavés dans l’espace latent, où 64 représente 512px et 128 représente 1024px. Sur chaque axe pavé, la dimension de l’image générée définit une limite supérieure automatique.
tile_stridefacultatif
Typeinteger
Par défaut64
16 – 128
Définit le pas entre les pavés de l’espace latent ; une limite automatique l’empêche de dépasser la moitié de la taille effective du pavé.
image_urlfacultatif image
Typeurl · image
URL de l’image source, utilisée pour l’inpainting si mask_url l’accompagne, et sinon pour le traitement image-à-image.
mask_urlfacultatif mask
Typeurl · image
URL du masque d’inpainting fournie avec image_url, qui est obligatoire. Le masque conserve les zones noires inchangées et régénère les zones blanches.
strengthfacultatif
Typenumber
Par défaut0.6
≤ 1> 0
Intensité de transformation appliquée uniquement à une image fournie via image_url ; sinon inutilisée.
mapsfacultatif
Typeenum[]
Par défaut["basecolor","normal","roughness","metalness","height"]
Cartes PBR sélectionnées pour la prédiction, les cinq étant sélectionnées par défaut. N’en sélectionner aucune ignore entièrement l’estimation PBR.
upscale_factorfacultatif
Typeenum
Par défaut0
024
Facteur d’agrandissement sans jointure de SeedVR, qui affecte les cartes PBR prédites mais conserve la texture de base à sa résolution d’origine. Sélectionnez 2 pour doubler la résolution, 4 pour la quadrupler ou 0 pour désactiver l’agrandissement.
output_formatfacultatif
Typeenum
Par défautpng
jpegpngwebp
Format de fichier image pour les textures et cartes PBR de sortie.
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": "patina/material",
  "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": 80,
    "usd": "0.08",
    "charged": 80,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "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
      }
    ],
    "seed": 42,
    "prompt": "string",
    "timings": {}
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "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
images
array of anyLes images de sortie incluent les cartes de matériau PBR prédites par PATINA ainsi que les textures pavables générées par z-image.
seed
integerGraine appliquée lors de la génération des textures.
prompt
stringPrompt de génération de texture, y compris toute expansion appliquée.
timings
objectVentilation temporelle couvrant l’ensemble du processus, en secondes.

Plus de modèles : Texte vers image

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