DrawNew.comDrawNew.com

API Reference

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

Mga pampublikong endpoint para sa batch at agent integration. Mag-authenticate gamit ang API key na inilabas na sa iyong account — hindi na kailangan ng hiwalay na token.

Authentication

Isama ang iyong API key sa Authorization header. Ang key ay pareho sa itinalaga sa iyong account sa user_keys (ibinigay ng DrawNew pagkatapos ma-activate ang iyong plan). Ang maling key ay nagbabalik ng 401.

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

Lumikha ng generation task

Inihaharap ang task sa upstream image provider at agad na nagbabalik ng mga task_id. Upang makuha ang resultang larawan maaari kang (A) mag-poll ng GET /v1/tasks/:id mismo, o (B) buksan lamang ang website — ang Image Creation tab ng parehong account ay awtomatikong kukuha ng task at itatabi ang mga resulta sa "My Works".

Kahilingan

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

Tugon

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

Mga parameter ng body

FieldUriRequiredDefaultPaglalarawan
promptstring✓—Generation prompt
modelstringgpt-image-2Model id (tingnan sa ibaba)
modetext | edit | fusiontexttext=text-to-image; edit=single-image edit; fusion=multi-image blend
aspectstring1:1Ratio: 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9, …
imageSize1K | 2K | 4K2KOutput resolution
countnumber1Bilang ng larawan (capped per model)
imageUrlsstring[][]Mga reference image URL para sa edit / fusion

Mga available na model

modelPangalanMga suportadong mode
gpt-image-2GPT Image 2text, edit
proNano Banana Protext, edit
flash2Nano Banana 2text, edit
flashNano Bananatext, edit

Mga error

HTTPerror.typeKailan
400invalid_requestAng body ay hindi JSON, walang laman ang prompt, hindi kilala ang model, o hindi sinusuportahan ng model ang mode
401unauthorizedWalang Authorization header o mali ang format
401invalid_api_keyHindi nahanap ang API key sa user_keys
403no_creditsNaubos na ang buwanang quota. I-upgrade ang iyong plan sa https://drawnew.com/pricing
GET/api/v1/tasks/{task_id}

Mag-poll ng isang task

Nagbabalik ng status ng upstream task. Ang status ay isa sa queued / in_progress / completed / failed. Nagdadagdag ng imageUrl field ang completed; nagdadagdag ng error field ang failed.

Kahilingan

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

Tugon

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

Mag-poll ng maraming task

Nagpo-poll ng maraming task sa isang tawag upang makatipid ng round-trip at authentication lookup. Ang mga resulta ay ibinabalik sa parehong pagkakasunod-sunod ng input na mga id. Hanggang 20 id bawat kahilingan.

Kahilingan

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

Tugon

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

Mga error sa polling

HTTPerror.typeKailan
400invalid_requestWalang ids param, o mahigit sa 20 na id
401unauthorizedWalang Authorization header o mali ang format
401invalid_api_keyHindi nahanap ang API key sa user_keys
POST/api/v1/upload

Mag-upload ng reference image (para sa edit / fusion)

Sa server-side kumukuha ng larawan mula sa isang pampublikong URL at nagho-host muli sa upstream CDN, nagbabalik ng matatag na URL. Ipass ang resulta sa imageUrls ng generate_image. Hanggang 25 MB bawat larawan; tinatanggap ang png / jpeg / webp / gif / bmp.

Kahilingan

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

Tugon

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

Talahuluganan ang kasaysayan ng paglikha ng account

Nagbabalik ng mga nakaraang paglikha na naka-attribute sa API key na ito, ang pinakabago muna. Paginasyon sa pamamagitan ng page (1-indexed) at limit (hanggang 50).

Kahilingan

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

Tugon

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

Kunin ang tier / status ng account

Nagbabalik ng email, tier (trial / starter / standard / pro), at kung ang upstream key ay naka-configure. Kapaki-pakinabang para sa mga agent upang magpasya kung kaya nila ang isang high-cost model.

Kahilingan

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

Tugon

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

Gamitin sa pamamagitan ng MCP (Claude Desktop / Cursor / Cline)

Para sa mga LLM agent, ang pinakamadaling paraan upang gamitin ang DrawNew ay sa pamamagitan ng opisyal na MCP server na inilathala bilang @drawnew/mcp-server sa npm. Inilalantad nito ang 6 na tool (generate_image, get_task, batch_get_tasks, upload_reference_image, list_my_generations, get_account_status) sa pamamagitan ng stdio at gumagana sa anumang MCP-compatible na client. Magdagdag ng snippet sa ibaba sa MCP config ng iyong client — iyon lang.

npm · @drawnew/mcp-serverBuong README at mga config ng Cursor / Cline →

Claude Desktop config

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

Mga Tala

  • •Ang mga resulta ay awtomatikong naka-attribute sa account na nagmamay-ari ng API key na ito — ang na-submit na task ay naitala sa pending_tasks; kapag binuksan ng parehong account ang Image Creation tab ng website, ang frontend ay kumukuha ng polling, itatabi ang mga resulta sa generations / generation_images, at lilitaw ang mga ito sa "My Works" at asset library. Kung gusto mo ng purong fire-and-forget nang hindi lumalabas sa UI, maglaan ng hiwalay na caller account.
  • •Server-side credit check — kung naubos na ang iyong buwanang quota, ang API ay magbabalik ng HTTP 403 na may error.type=no_credits.
  • •Inirerekomendang polling interval: 2-5 segundo. Ang batch endpoint ay tumatanggap ng hanggang 20 id bawat tawag.
  • •Huwag kailanman i-embed ang iyong API key sa client-side code. Gamitin lamang ito mula sa iyong sariling backend.
© 2026 DrawNew.com. All rights reserved.