Saltar al cuntegna

Uso

Integrar

ID dal model 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 dumonda: $0,10 100 credits API Lantschar sin questa pagina

Obtegna ina clav API
ByteDance Modificaziun da maletgs #image-to-image

Generaziun da maletgs guidada d'in stil e d'in subject, cun in maletg da cuntegn e in u dus maletgs d'estil

ByteDance · Maletg

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

standard

Text dal prompt da generaziun; laschar vid per excluder la generaziun e far mo il transfer da stil.

•obligatori
Trametta in datoteca u

Glista da URLs da maletgs cun quest urden: [content_image, style_image, extra_style_image].

image_size standard square_hd

Dimensiuns dal maletg generà.

num_images standard 1

Dumber da maletgs generadas simultanamain.

Avanzà negative_prompt · output_format · num_inference_steps · guidance_scale · seed · keep_size · enable_safety_checker
standard

Cuntì da maletg betg giavischà da stgassar, inclus elements, stils ed artifacts.

output_format standard png

Format dal maletg d'output: PNG mantegna la transparenza, entant che JPEG producescha datotecas pli pitschnas.

standard 28

Dumber d'iteraziuns da denoising, barattà in temp da generaziun pli lung cunter ina qualitad eventualmain meglra cun l'augment dal dumber.

standard 4

Controlla l'aderenza al prompt: augmentar questa valur fa suandar il resultat il prompt pli exactamain.

Seed che controlla la casualitad da la generaziun. Reutilisar in seed producescha resultats consistents e reproducibels.

POST /run/uso?wait=20 calculaziun → $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"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Uso

Pren `input_image_urls` en l'urden maletg da cuntegn, maletg d'estil e maletg d'estil supplementar facultativ. Il prompt po esser vid per in transferiment d'estil pur, e `negative_prompt` excluda elements indesirads. `keep_size` mantegna il layout e las dimensiuns dal maletg da cuntegn. Producescha 1 fin 4 maletgs per execuziun, cun 1 fin 50 pass e output PNG u JPEG.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
promptopziunal
Tipstring
Standard
Text dal prompt da generaziun; laschar vid per excluder la generaziun e far mo il transfer da stil.
input_image_urlsobligatori
Tipurl[] · image
Glista da URLs da maletgs cun quest urden: [content_image, style_image, extra_style_image].
image_sizeopziunal
Tipobject
Standardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensiuns dal maletg generà.
negative_promptopziunal
Tipstring
Standard
Cuntì da maletg betg giavischà da stgassar, inclus elements, stils ed artifacts.
num_inference_stepsopziunal
Tipinteger
Standard28
1 – 50
Dumber d'iteraziuns da denoising, barattà in temp da generaziun pli lung cunter ina qualitad eventualmain meglra cun l'augment dal dumber.
guidance_scaleopziunal
Tipnumber
Standard4
1 – 10
Controlla l'aderenza al prompt: augmentar questa valur fa suandar il resultat il prompt pli exactamain.
keep_sizeopziunal
Tipboolean
Standardfalse
Mantegnair intactas la grondezza e la disposiziun dal maletg da cuntegnair durant il processament, in'opziun utila per transferir il stil.
num_imagesopziunal num_outputs
Tipinteger
Standard1
1 – 4
Dumber da maletgs generadas simultanamain.
seedopziunal
Tipinteger | null
Seed che controlla la casualitad da la generaziun. Reutilisar in seed producescha resultats consistents e reproducibels.
enable_safety_checkeropziunal
Tipboolean
Standardtrue
Activescha la detecziun e la filtraziun da cuntegns NSFW.
output_formatopziunal
Tipenum
Standardpng
jpegpng
Format dal maletg d'output: PNG mantegna la transparenza, entant che JPEG producescha datotecas pli pitschnas.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
images
array of object {url, content_type, file_name, file_size, width, height}Maletgs generads che cumbineschan persunalizaziun dal stil, persunalizaziun dal subject u omaduas.
seed
integerValur dal sem utilisada durant la generaziun.
has_nsfw_concepts
array of booleanResultats per maletg da la detecziun NSFW sin ils maletgs generads.
prompt
stringPrompt utilisà durant la generaziun.
timings
objectMesiraziuns dal temp d'execuziun repartidas tenor stadi.

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/uso.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt