Ir al contenido

Uno

Integrar

ID del modelo uno
# 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/uno?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "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"

Esta solicitud: $0.05 50 créditos de API Ejecutar en esta página

Obtener clave de API
ByteDance Edición de imágenes #image-to-image

Generación de imágenes con múltiples referencias que combina varias imágenes de entrada con un prompt de texto

ByteDance · 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, donde se conservan 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 conforme los cambias.

•obligatorio

Prompt que guía la generación de imágenes.

•obligatorio
Suelta un archivo o

URL de las imágenes usadas durante la generación de imágenes.

image_size predeterminado square_hd

Dimensiones de la imagen de salida, seleccionadas de valores predeterminados o especificadas como ancho y alto personalizados. Ambas dimensiones personalizadas deben ser divisibles entre 8.

num_images predeterminado 1

Cantidad de imágenes solicitada para la generación.

Avanzado output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker
output_format predeterminado jpeg

Formato de archivo de la imagen resultante.

predeterminado 28

Cantidad de pasos de inferencia que se ejecutarán.

predeterminado 3.5

Intensidad de adherencia al prompt para la selección de imágenes, expresada como CFG (Classifier Free Guidance).

Semilla de generación: none selecciona una al azar, mientras que un valor proporcionado permite reproducir la generación.

POST /run/uno?wait=20 cotización → $0.05
# 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/uno?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "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"

Ejecutar esta solicitud

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

Acerca de Uno

Genera imágenes nuevas a partir de un prompt y una o más imágenes de referencia en `input_image_urls`. `image_size` acepta ajustes preestablecidos desde cuadrado hasta 16:9 vertical y horizontal, y `num_images` produce de 1 a 4 resultados. `num_inference_steps` va de 1 a 50 y `guidance_scale` de 1 a 20. La salida es JPEG o PNG, con una semilla para reproducibilidad.

Parámetros

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

NombreTipo PredeterminadoPermitido Descripción
input_image_urlsobligatorio
Tipourl[] · image
URL de las imágenes usadas durante la generación de imágenes.
image_sizeopcional
Tipoobject
Predeterminadosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensiones de la imagen de salida, seleccionadas de valores predeterminados o especificadas como ancho y alto personalizados. Ambas dimensiones personalizadas deben ser divisibles entre 8.
promptobligatorio
Tipostring
Prompt que guía la generación de imágenes.
seedopcional
Tipointeger | null
Semilla de generación: none selecciona una al azar, mientras que un valor proporcionado permite reproducir la generación.
num_imagesopcional num_outputs
Tipointeger
Predeterminado1
1 – 4
Cantidad de imágenes solicitada para la generación.
num_inference_stepsopcional
Tipointeger
Predeterminado28
1 – 50
Cantidad de pasos de inferencia que se ejecutarán.
guidance_scaleopcional
Tiponumber
Predeterminado3.5
1 – 20
Intensidad de adherencia al prompt para la selección de imágenes, expresada como CFG (Classifier Free Guidance).
output_formatopcional
Tipoenum
Predeterminadojpeg
jpegpng
Formato de archivo de la imagen resultante.
enable_safety_checkeropcional
Tipoboolean
Predeterminadotrue
Interruptor de comprobación de seguridad cuya configuración desactivada requiere autorización de la cuenta. Sin esa autorización, se comprueba cada solicitud independientemente de la configuración; true activa el comprobador.
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": "uno",
  "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": 50,
    "usd": "0.05",
    "charged": 50,
    "refunded": 0
  },
  "input": {
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "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
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "The figurine is in the crystal ball"
  },
  "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: se conserva para siempre (con cobro 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 video y audio. output es el objeto de resultado propio del modelo.
Campos de salida
images
array of object {url, content_type, file_name, file_size, width, height}URL de las imágenes generadas.
timings
object
seed
integerSemilla de generación de imágenes, incluido el valor elegido aleatoriamente si la entrada omitió una semilla; de lo contrario, repite el valor proporcionado.
has_nsfw_concepts
array of booleanIndica si aparecen conceptos NSFW en las imágenes generadas.
prompt
stringPrompt proporcionado para la generación de imágenes.

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