Ninja API - Molin AI

The Ninja API is currently in beta. Email hey@molin.ai to request access and receive your API key.

The Ninja API lets you submit prompts to Ninja, optionally define a structured output schema, and retrieve results — all over HTTP.

Base URL

https://ninja.new

All requests require a Bearer token in the Authorization header. API keys are prefixed with nsk_.

Authorization: Bearer nsk_your_api_key_here

POST /v0/api/task — submit a prompt and start execution.

GET /v0/api/task/result — retrieve status and result.

Create a task — POST /v0/api/task — save the returned taskId.
Poll for result — GET /v0/api/task/result?taskId=...&wait=1.
If status is pending — the task hasn’t started yet. wait=1 has no effect for pending tasks. Wait a short moment and poll again.
If status is in_progress — the long-poll is active and the request will block until the task completes. Poll again if the request times out.
When status is completed or failed — read the result or error field and stop polling.

Status	Description
`pending`	Task created, hasn’t started yet.
`in_progress`	Task is currently executing.
`completed`	Task finished successfully. `result` is available.
`failed`	Task encountered an error. `error` contains the message.
`cancelled`	Task was cancelled.
`paused`	Task is paused, waiting for user input.
`stopped`	Task was stopped.
`impossible`	Task cannot be completed.
`out_of_credits`	User ran out of credits during execution.

Both endpoints share a limit of 10 requests per minute per user. Exceeding the rate limit returns 429 Too Many Requests.

Status code	Description
`400`	Invalid request body or query parameters (e.g. prompt too long, invalid `resultSchema`, malformed `taskId`).
`401`	Missing or invalid API key.
`404`	Task not found or not owned by the authenticated user.
`429`	Rate limit exceeded (10 req/min) or free-plan task quota exhausted.