DrawNew.comDrawNew.com

API-Referenz

POST /api/v1/generate · GET /api/v1/tasks

Öffentliche Endpunkte für Batch- und Agent-Integrationen. Authentifizieren Sie sich mit dem API-Key, der bereits Ihrem Konto zugewiesen wurde — kein separates Token erforderlich.

Authentifizierung

Fügen Sie Ihren API-Key im Authorization-Header bei. Der Key ist derselbe, der Ihrem Konto in user_keys zugewiesen wurde (von DrawNew nach Aktivierung Ihres Plans bereitgestellt). Ein falscher Key gibt 401 zurück.

HEADER
Authorization: Bearer <your_api_key>
401 RESPONSE
{ "error": { "type": "invalid_api_key", "message": "Invalid API key" } }
POST/api/v1/generate

Einen Generierungsauftrag erstellen

Sendet den Auftrag an den übergeordneten Bildanbieter und gibt sofort task_ids zurück. Um das resultierende Bild zu erhalten, können Sie entweder (A) selbst GET /v1/tasks/:id abfragen oder (B) einfach die Website öffnen — dieselbe Kontos Bildenerstellung-Registerkarte übernimmt den Auftrag automatisch und speichert die Ergebnisse in "Meine Werke".

Anfrage

curl -X POST https://www.drawnew.com/api/v1/generate \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene Japanese garden in autumn",
    "model": "flash",
    "mode": "text",
    "aspect": "16:9",
    "imageSize": "2K",
    "count": 1
  }'

Antwort

{
  "task_ids": ["task_abc123"],
  "email": "you@example.com"
}

Body-Parameter

FeldTypErforderlichStandardBeschreibung
promptstring✓—Generierungsprompt
modelstringgpt-image-2Modell-ID (siehe unten)
modetext | edit | fusiontexttext=Text-zu-Bild; edit=Einzelbild-Bearbeitung; fusion=Mehrbild-Mischung
aspectstring1:1Verhältnis: 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9, …
imageSize1K | 2K | 4K2KAusgabeauflösung
countnumber1Bildanzahl (pro Modell begrenzt)
imageUrlsstring[][]Referenzbild-URLs für edit / fusion

Verfügbare Modelle

modelNameUnterstützte Modi
gpt-image-2GPT Image 2text, edit
proNano Banana Protext, edit
flash2Nano Banana 2text, edit
flashNano Bananatext, edit

Fehler

HTTPerror.typeWann
400invalid_requestBody ist kein JSON, Prompt ist leer, Modell unbekannt oder Modell unterstützt den Modus nicht
401unauthorizedFehlender Authorization-Header oder falsches Format
401invalid_api_keyAPI-Key in user_keys nicht gefunden
403no_creditsMonatliches Kontingent erreicht. Upgrade unter https://drawnew.com/pricing
GET/api/v1/tasks/{task_id}

Einen einzelnen Auftrag abfragen

Gibt den übergeordneten Auftragsstatus zurück. status ist einer von queued / in_progress / completed / failed. completed fügt ein imageUrl-Feld hinzu; failed fügt ein error-Feld hinzu.

Anfrage

curl https://www.drawnew.com/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer <your_api_key>"

Antwort

{
  "task_id": "task_abc123",
  "status": "completed",
  "progress": 100,
  "imageUrl": "https://files.example.com/generated/xxx.png"
}
GET/api/v1/tasks?ids=t1,t2

Mehrere Aufträge abfragen

Fragt mehrere Aufträge in einem Aufruf ab, um Roundtrips und Auth-Abfragen zu sparen. Ergebnisse werden in derselben Reihenfolge wie die Eingabe-IDs zurückgegeben. Maximal 20 IDs pro Anfrage.

Anfrage

curl "https://www.drawnew.com/api/v1/tasks?ids=task_abc,task_def,task_ghi" \
  -H "Authorization: Bearer <your_api_key>"

Antwort

{
  "tasks": [
    { "task_id": "task_abc", "status": "completed", "progress": 100, "imageUrl": "https://..." },
    { "task_id": "task_def", "status": "in_progress", "progress": 60 },
    { "task_id": "task_ghi", "status": "failed", "progress": 0, "error": "model overloaded" }
  ]
}

Abfragefehler

HTTPerror.typeWann
400invalid_requestFehlender ids-Parameter oder mehr als 20 IDs
401unauthorizedFehlender Authorization-Header oder falsches Format
401invalid_api_keyAPI-Key in user_keys nicht gefunden
POST/api/v1/upload

Ein Referenzbild hochladen (für edit / fusion)

Serverseitiger Abruf eines Bildes von einer öffentlichen URL und erneutes Hosting auf dem übergeordneten CDN, Rückgabe einer stabilen URL. Übergeben Sie das Ergebnis an generate_image's imageUrls. Maximal 25 MB pro Bild; png / jpeg / webp / gif / bmp akzeptiert.

Anfrage

curl -X POST https://www.drawnew.com/api/v1/upload \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"source_url": "https://example.com/cat.png"}'

Antwort

{
  "url": "https://files.example.com/uploads/abc123.png",
  "filename": "cat.png",
  "content_type": "image/png",
  "bytes": 524288
}
GET/api/v1/history?page=1&limit=20

Generierungsverlauf des Kontos auflisten

Gibt vergangene Generierungen zurück, die diesem API-Key zugeordnet sind, neueste zuerst. Paginierung über page (1-indiziert) und limit (maximal 50).

Anfrage

curl "https://www.drawnew.com/api/v1/history?page=1&limit=20" \
  -H "Authorization: Bearer <your_api_key>"

Antwort

{
  "items": [
    {
      "id": "tsk_img_xxx",
      "prompt": "a cat in autumn",
      "model": "flash",
      "mode": "text",
      "aspect": "16:9",
      "imageSize": "2K",
      "imageCount": 1,
      "images": ["https://..."],
      "refs": [],
      "createdAt": 1777461252000
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 20,
  "total_pages": 3
}
GET/api/v1/user/status

Kontostufe / Status abrufen

Gibt die E-Mail, die Stufe (trial / starter / standard / pro) und ob der übergeordnete Key konfiguriert ist, zurück. Nützlich für Agenten, um zu entscheiden, ob sie sich ein teures Modell leisten können.

Anfrage

curl https://www.drawnew.com/api/v1/user/status \
  -H "Authorization: Bearer <your_api_key>"

Antwort

{
  "email": "you@example.com",
  "tier": "pro",
  "has_key": true
}

Nutzung über MCP (Claude Desktop / Cursor / Cline)

Für LLM-Agenten ist der einfachste Weg, DrawNew zu nutzen, über den offiziellen MCP-Server, der als @drawnew/mcp-server auf npm veröffentlicht wird. Er stellt 6 Tools (generate_image, get_task, batch_get_tasks, upload_reference_image, list_my_generations, get_account_status) über stdio bereit und funktioniert mit jedem MCP-kompatiblen Client. Fügen Sie den folgenden Snippet zur MCP-Konfiguration Ihres Clients hinzu — das war's.

npm · @drawnew/mcp-serverVollständige README & Cursor / Cline-Konfigurationen →

Claude Desktop-Konfiguration

Pfad: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "drawnew": {
      "command": "npx",
      "args": ["-y", "@drawnew/mcp-server"],
      "env": {
        "DRAWNEW_API_KEY": "<your_api_key>"
      }
    }
  }
}

Hinweise

  • •Ergebnisse werden automatisch dem Konto zugeordnet, das diesen API-Key besitzt — der eingereichte Auftrag wird in pending_tasks erfasst; wenn dasselbe Konto als nächstes die Website-Bilderstellung-Registerkarte öffnet, übernimmt das Frontend die Abfrage, speichert die Ergebnisse in generations / generation_images, und sie erscheinen unter "Meine Werke" und der Ressourcenbibliothek. Wenn Sie reinen Fire-and-Forget ohne Anzeige in der UI wünschen, verwenden Sie ein separates Aufrufkonto.
  • •Serverseitige Prüfung — wenn das monatliche Kontingent erschöpft ist, gibt die API HTTP 403 mit error.type=no_credits zurück.
  • •Empfohlenes Abfrageintervall: 2–5 Sekunden. Batch-Endpunkt akzeptiert maximal 20 IDs pro Aufruf.
  • •Betten Sie Ihren API-Key niemals in clientseitigen Code ein. Verwenden Sie ihn nur von Ihrem eigenen Backend.
© 2026 DrawNew.com. All rights reserved.