DrawNew.comDrawNew.com

Referencia de API

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

Puntos de acceso públicos para integraciones por lotes y de agentes. Autentícate con la clave API ya emitida a tu cuenta — no se requiere token separado.

Autenticación

Incluye tu clave API en el encabezado Authorization. La clave es la misma asignada a tu cuenta en user_keys (proporcionada por DrawNew después de activar tu plan). Una clave incorrecta devuelve 401.

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

Crear una tarea de generación

Envía la tarea al proveedor de imágenes aguas arriba y devuelve inmediatamente task_ids. Para obtener la imagen resultante, puedes (A) consultar GET /v1/tasks/:id tú mismo, o (B) simplemente abrir el sitio web — la misma pestaña de Creación de imágenes de la cuenta tomará automáticamente la tarea y persistirá los resultados en "Mis Obras".

Solicitud

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

Respuesta

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

Parámetros del body

CampoTipoRequeridoPredeterminadoDescripción
promptstring✓—Prompt de generación
modelstringgpt-image-2ID del modelo (ver abajo)
modetext | edit | fusiontexttext=texto a imagen; edit=edición de imagen única; fusion=fusión de múltiples imágenes
aspectstring1:1Relación de aspecto: 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9, …
imageSize1K | 2K | 4K2KResolución de salida
countnumber1Cantidad de imágenes (limitado por modelo)
imageUrlsstring[][]URLs de imágenes de referencia para edit / fusion

Modelos disponibles

modelNombreModos compatibles
gpt-image-2GPT Image 2text, edit
proNano Banana Protext, edit
flash2Nano Banana 2text, edit
flashNano Bananatext, edit

Errores

HTTPerror.typeCuándo
400invalid_requestEl body no es JSON, el prompt está vacío, modelo desconocido o el modelo no soporta el modo
401unauthorizedFalta el encabezado Authorization o formato incorrecto
401invalid_api_keyClave API no encontrada en user_keys
403no_creditsCuota mensual agotada. Actualiza tu plan en https://drawnew.com/pricing
GET/api/v1/tasks/{task_id}

Consultar una tarea individual

Devuelve el estado de la tarea aguas arriba. status es uno de queued / in_progress / completed / failed. completed añade un campo imageUrl; failed añade un campo error.

Solicitud

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

Respuesta

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

Consultar múltiples tareas

Consulta muchas tareas en una llamada para ahorrar idas y vueltas y búsquedas de autenticación. Los resultados se devuelven en el mismo orden que los ids de entrada. Máximo 20 ids por solicitud.

Solicitud

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

Respuesta

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

Errores de consulta

HTTPerror.typeCuándo
400invalid_requestFalta el parámetro ids, o más de 20 ids
401unauthorizedFalta el encabezado Authorization o formato incorrecto
401invalid_api_keyClave API no encontrada en user_keys
POST/api/v1/upload

Subir una imagen de referencia (para edit / fusion)

El servidor obtiene una imagen de una URL pública y la aloja nuevamente en el CDN aguas arriba, devolviendo una URL estable. Pasa el resultado a generate_image's imageUrls. Máximo 25 MB por imagen; se aceptan png / jpeg / webp / gif / bmp.

Solicitud

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

Respuesta

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

Listar el historial de generación de la cuenta

Devuelve generaciones pasadas atribuidas a esta clave API, más recientes primero. Paginación vía page (indexada en 1) y limit (máximo 50).

Solicitud

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

Respuesta

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

Obtener nivel / estado de la cuenta

Devuelve el correo electrónico, el nivel (trial / starter / standard / pro) y si la clave aguas arriba está configurada. Útil para que los agentes decidan si pueden costear un modelo de alto costo.

Solicitud

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

Respuesta

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

Uso vía MCP (Claude Desktop / Cursor / Cline)

Para agentes LLM, la forma más fácil de usar DrawNew es a través del servidor MCP oficial publicado como @drawnew/mcp-server en npm. Expone 6 herramientas (generate_image, get_task, batch_get_tasks, upload_reference_image, list_my_generations, get_account_status) vía stdio y funciona con cualquier cliente compatible con MCP. Agrega el siguiente fragmento a la configuración MCP de tu cliente — eso es todo.

npm · @drawnew/mcp-serverREADME completo y configuraciones para Cursor / Cline →

Configuración de Claude Desktop

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

Notas

  • •Los resultados se atribuyen automáticamente a la cuenta que posee esta clave API — la tarea enviada se registra en pending_tasks; cuando la misma cuenta abra la pestaña de Creación de imágenes del sitio web, el frontend toma el control de la consulta, persiste los resultados en generations / generation_images, y aparecen en "Mis Obras" y la biblioteca de recursos. Si quieres un fire-and-forget puro sin aparecer en la UI, usa una cuenta de llamada separada.
  • •Control de créditos en el servidor — si agotaste tu cuota mensual, la API devuelve HTTP 403 con error.type=no_credits.
  • •Intervalo de consulta recomendado: 2-5 segundos. El endpoint por lotes acepta como máximo 20 ids por llamada.
  • •Nunca incrustes tu clave API en código del lado del cliente. Úsala solo desde tu propio backend.
© 2026 DrawNew.com. All rights reserved.