Op den Inhalt sprangen

Playground v2.5 · Image to Image

Integréieren

Modell-ID playground-v25/image-to-image
# 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/playground-v25/image-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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"

Dës Ufro: ≈0,018 $ 18 API-Kreditter Op dëser Säit ausféieren

API-Schlëssel kréien
Playground Bildbearbechtung #artistic#style

Ännert de Stil vun engem Inputbild no engem Prompt, mat enger Stäerktkontroll fir d'Distanz zum Original festzeleeën

Playground · Bild

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

•obligatoresch

Beschreift d'Bild, dat Dir generéiere wëllt, mat esou vill Detailer wéi méiglech, fir déi bescht Resultater ze kréien.

•obligatoresch image_url
Fichier erofzéien, oder

Startbild fir d'Generatioun, dat per URL geliwwert gëtt.

image_size Standard square_hd

Dimensioune vum generéierte Bild.

num_images Standard 1

Ugefrote Bildzuel fir d'Generatioun.

Erweidert negative_prompt · safety_checker_version · format · request_id · num_inference_steps · guidance_scale · strength · seed · enable_safety_checker · expand_prompt · preserve_aspect_ratio · crop_output · embeddings
Standard

Negativen Prompt, deen ongewollt Bilddetailer ugëtt. E ka Faarwen, Objeten, Landschaften oder méi fein Detailer a Qualitéiten ausschléissen, ewéi e Moustache, Onschäerft oder niddreg Opléisung.

safety_checker_version Standard v1

Wielt tëscht engem personaliséierte ViT-Sécherheetschecker (`v2`) an dem CompVis-Checker (`v1`, de Standard).

format Standard jpeg

Dateiformat vum resultéierende Bild.

Standard

Identifikator vun der Ufro fir eng Äntwert mat der Ufro ze verknëppen, déi se produzéiert huet.

Standard 25

Unzuel vun Inferenz-Schrëtt, déi ausgefouert ginn.

Standard 3

Stäerkt vun der Prompt-Entspriechung bei der Bildauswiel, ausgedréckt als CFG (Classifier Free Guidance).

Standard 0.95

Ähnlechkeetsgrad tëscht dem generéierte Bild an dem initiale Bild.

Seed fir d'Reproduktioun vu Biller a Stable Diffusion. E Bild kann bei all Duerchlaf genee reproduzéiert ginn, wann d'Modellversioun, de Prompt an de Seed onverännert bleiwen.

Standard []

Fir d'Benotzung ausgewielte Embeddings, als Lëscht geliwwert.

POST /run/playground-v25/image-to-image?wait=20 Präis → 0,018 $
# 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/playground-v25/image-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer Playground v2.5 · Image to Image

Start mat engem `image_url` an engem néidege `prompt`, fir nei Versioune vum Bild ze produzéieren. `strength` geet vun 0.05 bis 1 a bestëmmt, wéi no d'Resultat dem Original follegt. Et si bis zu 65 Inferenzschrëtt méiglech, `guidance_scale` geet vun 0 bis 20, an et kënnen bis zu 8 Biller zeréckginn. Zousätzlech ginn `preserve_aspect_ratio`, `crop_output`, Embeddings an jpeg- oder png-Output ënnerstëtzt.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
image_urlobligatoresch image
Typurl · image
Startbild fir d'Generatioun, dat per URL geliwwert gëtt.
promptobligatoresch
Typstring
Beschreift d'Bild, dat Dir generéiere wëllt, mat esou vill Detailer wéi méiglech, fir déi bescht Resultater ze kréien.
negative_promptoptional
Typstring
Standard
Negativen Prompt, deen ongewollt Bilddetailer ugëtt. E ka Faarwen, Objeten, Landschaften oder méi fein Detailer a Qualitéiten ausschléissen, ewéi e Moustache, Onschäerft oder niddreg Opléisung.
image_sizeoptional
Typobject
Standardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensioune vum generéierte Bild.
num_inference_stepsoptional
Typinteger
Standard25
1 – 65
Unzuel vun Inferenz-Schrëtt, déi ausgefouert ginn.
guidance_scaleoptional
Typnumber
Standard3
0 – 20
Stäerkt vun der Prompt-Entspriechung bei der Bildauswiel, ausgedréckt als CFG (Classifier Free Guidance).
strengthoptional
Typnumber
Standard0.95
0,05 – 1
Ähnlechkeetsgrad tëscht dem generéierte Bild an dem initiale Bild.
seedoptional
Typinteger | null
Seed fir d'Reproduktioun vu Biller a Stable Diffusion. E Bild kann bei all Duerchlaf genee reproduzéiert ginn, wann d'Modellversioun, de Prompt an de Seed onverännert bleiwen.
num_imagesoptional num_outputs
Typinteger
Standard1
1 – 8
Ugefrote Bildzuel fir d'Generatioun.
embeddingsoptional
Typobject[]
Standard[]
Fir d'Benotzung ausgewielte Embeddings, als Lëscht geliwwert.
embeddings[].pathobligatoresch
Typstring
Embedding-Gewiichter, déi duerch URL oder Datei-Pad spezifizéiert ginn.
embeddings[].tokensoptional
Typstring[]
Lëscht vun Embedding-Tokens, mat automatescher Benennung wann ewechgelooss: all Vektor an der Embedding-Datei kritt en Token aus der Sequenz <s0>, <s1>, ... .
enable_safety_checkeroptional
Typboolean
Standardtrue
Aktivéierung vun der Sécherheetskontroll; true aktivéiert d'Kontroll.
safety_checker_versionoptional
Typenum
Standardv1
v1v2
Wielt tëscht engem personaliséierte ViT-Sécherheetschecker (`v2`) an dem CompVis-Checker (`v1`, de Standard).
expand_promptoptional
Typboolean
Standardfalse
Prompt-Erweiderung mat zousätzleche Prompts, aktivéiert wann true.
formatoptional
Typenum
Standardjpeg
jpegpng
Dateiformat vum resultéierende Bild.
request_idoptional
Typstring
Standard
Identifikator vun der Ufro fir eng Äntwert mat der Ufro ze verknëppen, déi se produzéiert huet.
preserve_aspect_ratiooptional
Typboolean
Standardfalse
Op true setzen, fir den Aspektverhältnis vum generéierte Bild ze behalen, och wann seng Gréisst d'Limit iwwerschreit. Fir déi korrekt Proportiounen duerch Cropping no der Generatioun ze kréien, setzt crop_output op True. Breet- oder Héichtewäerter, déi net duerch 32 deelbar sinn, ginn nach ëmmer op dat nooste Multiple vun 32 geronnt; dës Redimensionéierung behält d'Aspektverhältnis par défaut net.
crop_outputoptional
Typboolean
Standardfalse
Schneit den generéierten Output op dat korrekt Aspektverhältnis zou, wann true.
obligatoresch Kanoneschen Numm, och akzeptéiert

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "playground-v25/image-to-image",
  "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": 18,
    "usd": "0.018",
    "charged": 18,
    "refunded": 0
  },
  "input": {
    "image_url": "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",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "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"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
images
array of object {url, width, height, content_type}Dateiinformatioun fir déi generéiert Biller.
timings
object
seed
integerSeed fir d'Bild-Generatioun, inklusiv dem zoufälleg gewielte Wäert, wann am Input kee Seed uginn ass; soss gëtt de geliwwerte Wäert widderholl.
has_nsfw_concepts
array of booleanGëtt un, ob NSFW-Konzepter an de generéierte Biller optrieden.
prompt
stringPrompt, deen während der Bild-Generatioun benotzt gëtt.

Méi Modeller: Bildbearbechtung

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/playground-v25/image-to-image.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt