Bildgenerierung

POST /api/v1/images/generations erzeugt ein bis vier Bilder aus einer Textbeschreibung. Erforderlicher Scope: images:generate.

JSON-Body

Feld	Typ	Pflicht	Standard	Regeln
`prompt`	string	ja	—	getrimmt, 5–2.000 Zeichen
`aspect_ratio`	string	nein	`1:1`	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `5:4`, `4:5` oder `21:9`
`resolution`	string	nein	`2K`	`2K` oder `4K`
`count`	integer	nein	`1`	1–4

Unbekannte Felder werden abgelehnt. Die öffentliche Anfrage kennt keine Optionen für Capability-Routing.

Credits

Auflösung	Credits pro Bild
`2K`	5
`4K`	20

Reserviert wird der Preis pro Bild multipliziert mit count. Credits werden bei Annahme des Jobs atomar reserviert, bei Erfolg abgerechnet und bei endgültigem Fehlschlag freigegeben.

cURL

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: manuscript-42-panel-a' \
  -H 'Prefer: wait=10' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"A labeled plant cell diagram","aspect_ratio":"4:3","resolution":"2K","count":1}'

JavaScript

const response = await fetch('https://sci-draw.com/api/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SCIDRAW_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json'

Python

import os, uuid, requests

response = requests.post(
    "https://sci-draw.com/api/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['SCIDRAW_API_KEY']}"

Liefert 202, solange der Job wartet oder läuft, und 200, wenn das begrenzte Warten einen Endzustand erreicht. Antwortschema und Polling-Ablauf finden Sie unter Jobs.

JSON-Body

Credits

cURL

JavaScript

Python

Inhaltsverzeichnis