Ir al contenido

PATINA · Material · Extract

Integrar

Id del modelo patina/material/extract
# 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/extract?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",
    "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"

Archivos como el ejemplo: 0,17 $ 170 créditos de API tus archivos se miden antes de la ejecución Ejecutar en esta página

Obtener clave de API
Open model Edición de imágenes #material#pbr#extraction

Extrae una textura en mosaico con mapas PBR de una imagen de origen, guiado por un prompt que nombra la superficie

Open model · Imagen

Tu primer resultado aparecerá aquí

Crea una solicitud abajo y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, conservadas para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan al modificarlos.

•obligatorio

Descripción de la textura deseada que se extraerá de la imagen.

•obligatorio image_url
Suelta un archivo o

URL de la imagen de origen para la extracción de texturas.

image_size predeterminado square_hd

Dimensiones en píxeles de la textura resultante.

upscale_factor predeterminado 0

Factor de ampliación sin juntas de SeedVR que afecta a los mapas PBR predichos, pero mantiene la textura base en su resolución original. Seleccione 2 para duplicar la resolución, 4 para cuadruplicarla o 0 para desactivar la ampliación.

num_images predeterminado 1

Cantidad de imágenes de textura que se crearán.

Avanzado tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
tiling_mode predeterminado both

Dirección del mosaico: 'both' para mosaico omnidireccional, 'horizontal' o 'vertical'.

output_format predeterminado png

Formato de archivo de imagen para las texturas y los mapas PBR de salida.

predeterminado 8

Cantidad de pasos de eliminación de ruido utilizados para generar texturas.

predeterminado 128

Tamaño de mosaico en el espacio latente, donde 64 representa 512px y 128 representa 1024px. En cada eje con mosaico, la dimensión de la imagen generada establece un límite superior automático.

predeterminado 64

Establezca el paso entre mosaicos del espacio latente; un límite automático evita que supere la mitad del tamaño efectivo del mosaico.

predeterminado 0.6

Intensidad de transformación aplicada únicamente a una imagen proporcionada mediante image_url; de lo contrario, no se utiliza.

Seed aleatorio que hace reproducible la generación.

predeterminado ["basecolor","normal"...

Mapas PBR seleccionados para la predicción; los cinco se seleccionan de forma predeterminada. No seleccionar ninguno omite por completo la estimación PBR.

POST /run/patina/material/extract?wait=20 cotización → 0,17 $
# 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/extract?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",
    "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"

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y se guarda (localStorage) únicamente si marcas Recordar. Obtener una clave de API

Acerca de PATINA · Material · Extract

Recibe una imagen de entrada y un prompt que describe qué superficie extraer, y devuelve una textura en mosaico junto con los mapas PBR predichos. `maps` selecciona cuáles de basecolor, normal, roughness, metalness y height producir. Las opciones incluyen `tiling_mode`, `strength` de 0 a 1, `upscale_factor` de 0, 2 o 4 y de 1 a 4 resultados.

Parámetros

Envía el nombre canónico o el nombre nativo, no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
promptobligatorio
Tipostring
Descripción de la textura deseada que se extraerá de la imagen.
image_sizeopcional
Tipoobject
Predeterminadosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensiones en píxeles de la textura resultante.
num_inference_stepsopcional
Tipointeger
Predeterminado8
1 – 8
Cantidad de pasos de eliminación de ruido utilizados para generar texturas.
seedopcional
Tipointeger | null
Seed aleatorio que hace reproducible la generación.
num_imagesopcional num_outputs
Tipointeger
Predeterminado1
1 – 4
Cantidad de imágenes de textura que se crearán.
enable_prompt_expansionopcional
Tipoboolean
Predeterminadotrue
Activa la expansión del prompt basada en LLM para añadir detalles.
enable_safety_checkeropcional
Tipoboolean
Predeterminadotrue
Activa la comprobación de seguridad de las imágenes generadas.
tiling_modeopcional
Tipoenum
Predeterminadoboth
bothhorizontalvertical
Dirección del mosaico: 'both' para mosaico omnidireccional, 'horizontal' o 'vertical'.
tile_sizeopcional
Tipointeger
Predeterminado128
32 – 256
Tamaño de mosaico en el espacio latente, donde 64 representa 512px y 128 representa 1024px. En cada eje con mosaico, la dimensión de la imagen generada establece un límite superior automático.
tile_strideopcional
Tipointeger
Predeterminado64
16 – 128
Establezca el paso entre mosaicos del espacio latente; un límite automático evita que supere la mitad del tamaño efectivo del mosaico.
image_urlobligatorio image
Tipourl · image
URL de la imagen de origen para la extracción de texturas.
strengthopcional
Tiponumber
Predeterminado0.6
≤ 1> 0
Intensidad de transformación aplicada únicamente a una imagen proporcionada mediante image_url; de lo contrario, no se utiliza.
mapsopcional
Tipoenum[]
Predeterminado["basecolor","normal","roughness","metalness","height"]
Mapas PBR seleccionados para la predicción; los cinco se seleccionan de forma predeterminada. No seleccionar ninguno omite por completo la estimación PBR.
upscale_factoropcional
Tipoenum
Predeterminado0
024
Factor de ampliación sin juntas de SeedVR que afecta a los mapas PBR predichos, pero mantiene la textura base en su resolución original. Seleccione 2 para duplicar la resolución, 4 para cuadruplicarla o 0 para desactivar la ampliación.
output_formatopcional
Tipoenum
Predeterminadopng
jpegpngwebp
Formato de archivo de imagen para las texturas y los mapas PBR de salida.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una carga. Archivos

Salida

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "patina/material/extract",
  "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": 170,
    "usd": "0.17",
    "charged": 170,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (se cobra por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para vídeo y audio. output es el objeto de resultado propio del modelo.
Campos de salida
images
array of anyLas imágenes de salida incluyen mapas de materiales PBR predichos por PATINA junto a texturas en mosaico generadas por z-image.
seed
integerSemilla aplicada al generar texturas.
prompt
stringPrompt de generación de texturas, incluida cualquier expansión aplicada.
timings
objectDesglose de tiempos de todo el proceso, en segundos.

Más modelos: Edición de imágenes

Para agentes de IA: esta página en Markdown está en https://doitong.com/es/developers/models/patina/material/extract.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt