Vai al contenuto

Uno

Integra

ID del modello 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"

Questa richiesta: 0,05 $ 50 crediti API Esegui in questa pagina

Ottieni la chiave API
ByteDance Modifica immagini #image-to-image

Generazione di immagini con più riferimenti che fonde diverse immagini di input con un prompt testuale

ByteDance · Immagine

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio

Prompt che guida la generazione di immagini.

•obbligatorio
Trascina un file oppure

URL delle immagini usate durante la generazione dell'immagine.

image_size predefinito square_hd

Dimensioni dell'immagine di output, selezionate dai preset o specificate come larghezza e altezza personalizzate. Entrambe le dimensioni personalizzate devono essere divisibili per 8.

num_images predefinito 1

Numero di immagini richiesto per la generazione.

Avanzate output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker
output_format predefinito jpeg

Formato del file dell'immagine risultante.

predefinito 28

Numero di passaggi di inferenza da eseguire.

predefinito 3.5

Intensità di aderenza al prompt per la selezione dell'immagine, espressa come CFG (Classifier Free Guidance).

Seed di generazione: none ne seleziona uno casualmente, mentre un valore fornito abilita una generazione riproducibile.

POST /run/uno?wait=20 preventivo → 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"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Uno

Genera nuove immagini da un prompt e una o più immagini di riferimento in `input_image_urls`. `image_size` accetta preset dal formato quadrato al 16:9 verticale e orizzontale, mentre `num_images` produce da 1 a 4 risultati. `num_inference_steps` varia da 1 a 50 e `guidance_scale` da 1 a 20. L'output è JPEG o PNG, con un seed per la riproducibilità.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
input_image_urlsobbligatorio
Tipourl[] · image
URL delle immagini usate durante la generazione dell'immagine.
image_sizefacoltativo
Tipoobject
Predefinitosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensioni dell'immagine di output, selezionate dai preset o specificate come larghezza e altezza personalizzate. Entrambe le dimensioni personalizzate devono essere divisibili per 8.
promptobbligatorio
Tipostring
Prompt che guida la generazione di immagini.
seedfacoltativo
Tipointeger | null
Seed di generazione: none ne seleziona uno casualmente, mentre un valore fornito abilita una generazione riproducibile.
num_imagesfacoltativo num_outputs
Tipointeger
Predefinito1
1 – 4
Numero di immagini richiesto per la generazione.
num_inference_stepsfacoltativo
Tipointeger
Predefinito28
1 – 50
Numero di passaggi di inferenza da eseguire.
guidance_scalefacoltativo
Tiponumber
Predefinito3.5
1 – 20
Intensità di aderenza al prompt per la selezione dell'immagine, espressa come CFG (Classifier Free Guidance).
output_formatfacoltativo
Tipoenum
Predefinitojpeg
jpegpng
Formato del file dell'immagine risultante.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Interruttore del controllo di sicurezza la cui disattivazione richiede l'autorizzazione dell'account. Senza tale autorizzazione, ogni richiesta viene controllata indipendentemente dall'impostazione; true abilita il controllo.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
images
array of object {url, content_type, file_name, file_size, width, height}URL delle immagini generate.
timings
object
seed
integerSeed della generazione di immagini, incluso il valore scelto casualmente se l'input non forniva un seed; altrimenti ripete il valore fornito.
has_nsfw_concepts
array of booleanIndica se nelle immagini generate compaiono concetti NSFW.
prompt
stringPrompt fornito per la generazione dell'immagine.

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/uno.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt