Vai al contenuto

Uso

Integra

ID del modello uso
# 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/uso?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"
    ]
  }'

# 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,10 $ 100 crediti API Esegui in questa pagina

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

Generazione di immagini guidata da stile e soggetto, da un'immagine di contenuto più una o due immagini di stile

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.

predefinito

Testo del prompt di generazione; lascialo vuoto per eseguire solo il trasferimento dello stile.

•obbligatorio
Trascina un file oppure

Elenco di URL di immagini con questo ordine: [content_image, style_image, extra_style_image].

image_size predefinito square_hd

Dimensioni dell'immagine generata.

num_images predefinito 1

Numero di immagini generate simultaneamente.

Avanzate negative_prompt · output_format · num_inference_steps · guidance_scale · seed · keep_size · enable_safety_checker
predefinito

Contenuto indesiderato da escludere dall'immagine, inclusi elementi, stili e artefatti.

output_format predefinito png

Formato dell'immagine di output: PNG mantiene la trasparenza, mentre JPEG produce file più piccoli.

predefinito 28

Numero di iterazioni di denoising, che sacrifica tempo di generazione più lungo per una qualità potenzialmente migliore all'aumentare del numero.

predefinito 4

Controllo dell'aderenza al prompt: aumenta questo valore per far seguire al risultato il prompt più da vicino.

Seed che controlla la casualità della generazione. Riutilizzare un seed produce risultati coerenti e riproducibili.

POST /run/uso?wait=20 preventivo → 0,10 $
# 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/uso?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"
    ]
  }'

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

Accetta `input_image_urls` nell'ordine: immagine di contenuto, immagine di stile e immagine di stile aggiuntiva opzionale. Il prompt può essere vuoto per un puro trasferimento di stile, mentre `negative_prompt` esclude gli elementi indesiderati. `keep_size` conserva layout e dimensioni dell'immagine di contenuto. Produce da 1 a 4 immagini per esecuzione, con da 1 a 50 step e output PNG o JPEG.

Parametri

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

NomeTipo PredefinitoConsentiti Descrizione
promptfacoltativo
Tipostring
Predefinito
Testo del prompt di generazione; lascialo vuoto per eseguire solo il trasferimento dello stile.
input_image_urlsobbligatorio
Tipourl[] · image
Elenco di URL di immagini con questo ordine: [content_image, style_image, extra_style_image].
image_sizefacoltativo
Tipoobject
Predefinitosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensioni dell'immagine generata.
negative_promptfacoltativo
Tipostring
Predefinito
Contenuto indesiderato da escludere dall'immagine, inclusi elementi, stili e artefatti.
num_inference_stepsfacoltativo
Tipointeger
Predefinito28
1 – 50
Numero di iterazioni di denoising, che sacrifica tempo di generazione più lungo per una qualità potenzialmente migliore all'aumentare del numero.
guidance_scalefacoltativo
Tiponumber
Predefinito4
1 – 10
Controllo dell'aderenza al prompt: aumenta questo valore per far seguire al risultato il prompt più da vicino.
keep_sizefacoltativo
Tipoboolean
Predefinitofalse
Mantiene inalterate dimensioni e disposizione dell'immagine di contenuto durante l'elaborazione, opzione utile per trasferire lo stile.
num_imagesfacoltativo num_outputs
Tipointeger
Predefinito1
1 – 4
Numero di immagini generate simultaneamente.
seedfacoltativo
Tipointeger | null
Seed che controlla la casualità della generazione. Riutilizzare un seed produce risultati coerenti e riproducibili.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Abilita il rilevamento e il filtraggio dei contenuti NSFW.
output_formatfacoltativo
Tipoenum
Predefinitopng
jpegpng
Formato dell'immagine di output: PNG mantiene la trasparenza, mentre JPEG produce file più piccoli.
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": "uso",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "input_image_urls": [
      "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,
    "has_nsfw_concepts": [
      false
    ],
    "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"
  }
}
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}Immagini generate che incorporano la personalizzazione dello stile, del soggetto o entrambe.
seed
integerValore seed usato durante la generazione.
has_nsfw_concepts
array of booleanRisultati per immagine del rilevamento NSFW sulle immagini generate.
prompt
stringPrompt utilizzato durante la generazione.
timings
objectMisurazioni dei tempi di esecuzione suddivise per fase.

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