DrawNew.comDrawNew.com

API संदर्भ

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

बैच और एजेंट एकीकरण के लिए सार्वजनिक एंडपॉइंट। आपके खाते को पहले से जारी API Key से प्रमाणित करें — अलग टोकन की आवश्यकता नहीं।

प्रमाणीकरण

अपनी API Key को Authorization हेडर में शामिल करें। कुंजी वही है जो आपके खाते को user_keys में नियुक्त की गई है (DrawNew द्वारा आपकी योजना सक्रिय होने के बाद प्रदान की गई)। गलत कुंजी 401 लौटाती है।

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

निर्माण कार्य बनाएँ

कार्य को अपस्ट्रीम छवि प्रदाता को प्रस्तुत करता है और तुरंत task_ids लौटाता है। परिणामी छवि प्राप्त करने के लिए आप (A) स्वयं GET /v1/tasks/:id पॉल कर सकते हैं, या (B) बस वेबसाइट खोलें — उसी खाते का Image Creation टैब कार्य को स्वचालित रूप से प्राप्त करेगा और "My Works" में परिणाम सहेजेगा।

अनुरोध

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
  }'

प्रतिक्रिया

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

बॉडी पैरामीटर

फ़ील्डप्रकारआवश्यकडिफ़ॉल्टविवरण
promptstring✓—निर्माण प्रॉम्प्ट
modelstringgpt-image-2मॉडल id (नीचे देखें)
modetext | edit | fusiontexttext=टेक्स्ट-टू-इमेज; edit=एकल-छवि संपादन; fusion=बहु-छवि मिश्रण
aspectstring1:1अनुपात: 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9, …
imageSize1K | 2K | 4K2Kआउटपुट रिज़ॉल्यूशन
countnumber1छवि गणना (मॉडल के अनुसार सीमित)
imageUrlsstring[][]edit / fusion के लिए संदर्भ छवि URLs

उपलब्ध मॉडल

modelनामसमर्थित मोड
gpt-image-2GPT Image 2text, edit
proNano Banana Protext, edit
flash2Nano Banana 2text, edit
flashNano Bananatext, edit

त्रुटियाँ

HTTPerror.typeकब
400invalid_requestबॉडी JSON नहीं है, प्रॉम्प्ट खाली है, मॉडल अज्ञात है, या मॉडल मोड का समर्थन नहीं करता
401unauthorizedAuthorization हेडर गायब है या गलत प्रारूप
401invalid_api_keyuser_keys में API Key नहीं मिली
403no_creditsमासिक कोटा समाप्त। https://drawnew.com/pricing पर अपना प्लान अपग्रेड करें
GET/api/v1/tasks/{task_id}

एकल कार्य पॉल करें

अपस्ट्रीम कार्य स्थिति लौटाता है। status queued / in_progress / completed / failed में से एक है। completed में imageUrl फ़ील्ड जुड़ता है; failed में error फ़ील्ड जुड़ता है।

अनुरोध

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

प्रतिक्रिया

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

बहु-कार्य पॉल करें

राउंड-ट्रिप और प्रमाणीकरण लुकअप बचाने के लिए एक कॉल में कई कार्य पॉल करता है। परिणाम इनपुट ids के उसी क्रम में लौटाए जाते हैं। प्रति अनुरोध अधिकतम 20 ids।

अनुरोध

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

प्रतिक्रिया

{
  "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" }
  ]
}

पॉलिंग त्रुटियाँ

HTTPerror.typeकब
400invalid_requestids पैरामीटर गायब है, या 20 से अधिक ids
401unauthorizedAuthorization हेडर गायब है या गलत प्रारूप
401invalid_api_keyuser_keys में API Key नहीं मिली
POST/api/v1/upload

संदर्भ छवि अपलोड करें (edit / fusion के लिए)

सर्वर-साइड एक सार्वजनिक URL से छवि प्राप्त करता है और अपस्ट्रीम CDN पर पुनः होस्ट करता है, एक स्थिर URL लौटाता है। परिणाम को generate_image के imageUrls में पास करें। प्रति छवि अधिकतम 25 MB; png / jpeg / webp / gif / bmp स्वीकार किए जाते हैं।

अनुरोध

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"}'

प्रतिक्रिया

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

खाते का निर्माण इतिहास सूचीबद्ध करें

इस API Key को दिए गए पिछले निर्माण लौटाता है, सबसे हाल का पहले। पृष्ठन page (1-आधारित) और limit (अधिकतम 50) के माध्यम से।

अनुरोध

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

प्रतिक्रिया

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

खाता टियर / स्थिति प्राप्त करें

ईमेल, टियर (trial / starter / standard / pro), और अपस्ट्रीम कुंजी कॉन्फ़िगर की गई है या नहीं, यह लौटाता है। एजेंटों के लिए उपयोगी — यह तय करने के लिए कि वे उच्च लागत वाले मॉडल को वहन कर सकते हैं या नहीं।

अनुरोध

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

प्रतिक्रिया

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

MCP के माध्यम से उपयोग करें (Claude Desktop / Cursor / Cline)

LLM एजेंटों के लिए, DrawNew का उपयोग करने का सबसे आसान तरीका npm पर @drawnew/mcp-server के रूप में प्रकाशित आधिकारिक MCP सर्वर है। यह stdio पर 6 टूल (generate_image, get_task, batch_get_tasks, upload_reference_image, list_my_generations, get_account_status) प्रकट करता है और किसी भी MCP-संगत क्लाइंट के साथ काम करता है। अपने क्लाइंट के MCP कॉन्फ़िग में नीचे दिया गया स्निपेट जोड़ें — बस।

npm · @drawnew/mcp-serverपूर्ण README और Cursor / Cline कॉन्फ़िग →

Claude Desktop कॉन्फ़िग

पथ: ~/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>"
      }
    }
  }
}

नोट्स

  • •परिणाम स्वचालित रूप से उस खाते को दिए जाते हैं जिसकी यह API Key है — प्रस्तुत कार्य pending_tasks में दर्ज होता है; जब उसी खाते में अगली बार वेबसाइट का Image Creation टैब खोला जाता है, तो फ़्रंटएंड पॉलिंग को संभालता है, generations / generation_images में परिणाम सहेजता है, और वे "My Works" और एसेट लाइब्रेरी में दिखाई देते हैं। यदि आप UI में दिखाई दिए बिना शुद्ध फ़ायर-एंड-फ़ोरगेट चाहते हैं, तो एक अलग कॉलर खाता समर्पित करें।
  • •सर्वर-साइड क्रेडिट जांच — यदि आपका मासिक कोटा समाप्त हो गया है, तो API HTTP 403 error.type=no_credits लौटाता है।
  • •अनुशंसित पॉलिंग अंतराल: 2-5 सेकंड। बैच एंडपॉइंट प्रति कॉल अधिकतम 20 ids स्वीकार करता है।
  • •अपनी API Key कभी क्लाइंट-साइड कोड में एम्बेड न करें। इसे केवल अपने बैकएंड से उपयोग करें।
© 2026 DrawNew.com. All rights reserved.