Op den Inhalt sprangen

Playground v2.5

Integréieren

Modell-ID playground-v25
# 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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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,013 $ 13 API-Kreditter Op dëser Säit ausféieren

API-Schlëssel kréien
Playground Text zu Bild #artistic#style

Text-zu-Bild-Generatioun mat negativen Prompts, Embeddings a bis zu 8 Biller pro Ufro

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.

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 · seed · enable_safety_checker · expand_prompt · embeddings
Standard

Negativen Prompt, deen auszeschléissend Bilddetailer ugëtt, dorënner Faarwen, Objeten, Landschaften oder méi fein Feature. Beispiller si 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).

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

Erstellt Biller aus engem néidege `prompt` mat sechs preset-`image_size`-Wäerter vu square_hd bis landscape_16_9. `num_inference_steps` geet vun 1 bis 50 an `guidance_scale` vun 0 bis 20. Pro Uruff kënnen bis zu 8 Biller zeréckginn, am jpeg- oder png-Format. Ausserdeem ginn `negative_prompt`, eng Lëscht vun `embeddings`, e `seed` an eng optional Prompt-Erweiderung ënnerstëtzt.

Parameteren

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

NummTyp StandardErlaabt Beschreiwung
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 auszeschléissend Bilddetailer ugëtt, dorënner Faarwen, Objeten, Landschaften oder méi fein Feature. Beispiller si 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 – 50
Unzuel vun Inferenz-Schrëtt, déi ausgefouert ginn.
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.
guidance_scaleoptional
Typnumber
Standard3
0 – 20
Stäerkt vun der Prompt-Entspriechung bei der Bildauswiel, ausgedréckt als CFG (Classifier Free Guidance).
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.
obligatoresch Kanoneschen Numm, och akzeptéiert

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "playground-v25",
  "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": 13,
    "usd": "0.013",
    "charged": 13,
    "refunded": 0
  },
  "input": {
    "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: Text zu Bild

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