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

•obligatoire

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 de mise à l’échelle sans raccord de SeedVR, affectant les cartes PBR prédites tout en conservant 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 la mise à l’échelle.

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, 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 tuiles 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éfinissez le pas entre les tuiles de l’espace latent ; une limite automatique l’empêche de dépasser la moitié de la taille effective de la tuile.

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'une invite et prédit des cartes PBR : basecolor, normal, roughness, metalness et height. Utilisez `tiling_mode` pour une répétition dans les deux directions, horizontale ou verticale, et `upscale_factor` de 0, 2 ou 4 pour agrandir les cartes. La transmission de `image_url` active la conversion image vers 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
promptobligatoire
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 des invites 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 tuiles 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éfinissez le pas entre les tuiles de l’espace latent ; une limite automatique l’empêche de dépasser la moitié de la taille effective de la tuile.
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, 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 de mise à l’échelle sans raccord de SeedVR, affectant les cartes PBR prédites tout en conservant 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 la mise à l’échelle.
output_formatfacultatif
Typeenum
Par défautpng
jpegpngwebp
Format de fichier image pour les textures et cartes PBR de sortie.
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": "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 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
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
stringInvite de génération de texture, y compris toute expansion appliquée.
timings
objectVentilation du chronométrage 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 à l'adresse https://doitong.com/fr-FR/developers/models/patina/material.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt