Naar inhoud springen

Playground v2.5

Integreren

Model-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"

Deze request: ≈$ 0,013 13 API-tegoed Op deze pagina uitvoeren

API-sleutel ophalen
Playground Tekst naar afbeelding #artistic#style

Text-to-image-generatie met negatieve prompts, embeddings en maximaal 8 afbeeldingen per request

Playground · Afbeelding

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht

Beschrijf de afbeelding die je wilt laten genereren zo gedetailleerd mogelijk voor de beste resultaten.

image_size standaard square_hd

Afmetingen van de gegenereerde afbeelding.

num_images standaard 1

Aantal afbeeldingen dat voor generatie wordt aangevraagd.

Geavanceerd negative_prompt · safety_checker_version · format · request_id · num_inference_steps · guidance_scale · seed · enable_safety_checker · expand_prompt · embeddings
standaard

Negatieve prompt met afbeeldingsdetails die moeten worden weggelaten, waaronder kleuren, objecten, landschappen of fijnere kenmerken. Voorbeelden zijn een snor, vervaging of lage resolutie.

safety_checker_version standaard v1

Kies tussen een aangepaste ViT-veiligheidscontrole (`v2`) en de CompVis-controle (`v1`, de standaard).

format standaard jpeg

Bestandsindeling van de resulterende afbeelding.

standaard

Request-ID om een response te correleren met de request die deze heeft geproduceerd.

standaard 25

Aantal uit te voeren inferentiestappen.

standaard 3

Sterkte waarmee de prompt wordt gevolgd bij beeldselectie, uitgedrukt als CFG (Classifier Free Guidance).

Seed voor het reproduceren van afbeeldingen in Stable Diffusion. Een afbeelding kan bij elke run exact worden gereproduceerd door de modelversie, prompt en seed ongewijzigd te laten.

standaard []

Embeddings die voor gebruik zijn geselecteerd, verstrekt als lijst.

POST /run/playground-v25?wait=20 prijsopgave → $ 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"

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over Playground v2.5

Maakt afbeeldingen met een verplichte `prompt` en zes vooraf ingestelde `image_size`-waarden van square_hd tot landscape_16_9. `num_inference_steps` loopt van 1 tot 50 en `guidance_scale` van 0 tot 20. Per aanroep kunnen maximaal 8 afbeeldingen in jpeg- of png-indeling worden teruggegeven. Ook worden een `negative_prompt`, een lijst met `embeddings`, een `seed` en een optionele schakelaar voor promptuitbreiding geaccepteerd.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
promptverplicht
Typestring
Beschrijf de afbeelding die je wilt laten genereren zo gedetailleerd mogelijk voor de beste resultaten.
negative_promptoptioneel
Typestring
Standaard
Negatieve prompt met afbeeldingsdetails die moeten worden weggelaten, waaronder kleuren, objecten, landschappen of fijnere kenmerken. Voorbeelden zijn een snor, vervaging of lage resolutie.
image_sizeoptioneel
Typeobject
Standaardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Afmetingen van de gegenereerde afbeelding.
num_inference_stepsoptioneel
Typeinteger
Standaard25
1 – 50
Aantal uit te voeren inferentiestappen.
seedoptioneel
Typeinteger | null
Seed voor het reproduceren van afbeeldingen in Stable Diffusion. Een afbeelding kan bij elke run exact worden gereproduceerd door de modelversie, prompt en seed ongewijzigd te laten.
guidance_scaleoptioneel
Typenumber
Standaard3
0 – 20
Sterkte waarmee de prompt wordt gevolgd bij beeldselectie, uitgedrukt als CFG (Classifier Free Guidance).
num_imagesoptioneel num_outputs
Typeinteger
Standaard1
1 – 8
Aantal afbeeldingen dat voor generatie wordt aangevraagd.
embeddingsoptioneel
Typeobject[]
Standaard[]
Embeddings die voor gebruik zijn geselecteerd, verstrekt als lijst.
embeddings[].pathverplicht
Typestring
Embedding-gewichten die via URL of bestandspad zijn opgegeven.
embeddings[].tokensoptioneel
Typestring[]
Lijst met embedding-tokens, met automatische naamgeving wanneer deze wordt weggelaten: elke vector in het embeddingbestand krijgt een token uit de reeks <s0>, <s1>, ... .
enable_safety_checkeroptioneel
Typeboolean
Standaardtrue
Activering van de veiligheidscontrole; true schakelt controle in.
safety_checker_versionoptioneel
Typeenum
Standaardv1
v1v2
Kies tussen een aangepaste ViT-veiligheidscontrole (`v2`) en de CompVis-controle (`v1`, de standaard).
expand_promptoptioneel
Typeboolean
Standaardfalse
Promptuitbreiding met extra prompts, ingeschakeld wanneer true.
formatoptioneel
Typeenum
Standaardjpeg
jpegpng
Bestandsindeling van de resulterende afbeelding.
request_idoptioneel
Typestring
Standaard
Request-ID om een response te correleren met de request die deze heeft geproduceerd.
verplicht Canonieke naam, ook geaccepteerd

Uitvoer

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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
images
array of object {url, width, height, content_type}Bestandsinformatie voor de gegenereerde afbeeldingen.
timings
object
seed
integerSeed voor afbeeldingsgeneratie, inclusief de willekeurig gekozen waarde als de invoer geen seed bevatte; anders wordt de opgegeven waarde herhaald.
has_nsfw_concepts
array of booleanGeeft aan of NSFW-concepten in de gegenereerde afbeeldingen voorkomen.
prompt
stringPrompt die tijdens afbeeldingsgeneratie wordt gebruikt.

Meer modellen: Tekst naar afbeelding

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/playground-v25.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt