API Documentation

NadoAI is a unified REST API for AI video and image generation. Integrate once, access 15+ models through a single endpoint.

Authentication

All requests require an API key passed in the Authorization header. Get your key from the dashboard.

Authorization: Bearer sk_live_a1b2c3d4e5f6...

Quickstart

const res = await fetch('https://api.nadoai.ru/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'veo-3-fast',
    prompt: 'A cinematic drone shot over mountains'
  })
});
const { id, status } = await res.json();

POST/v1/generate

Submit a generation request. Returns a job ID for polling.

Parameter	Type	Description
model	string	Model ID, e.g. `veo-3-fast`, `nano-banana`
prompt	string	Text description of the desired output
aspect_ratio	string	Optional. `16:9`, `9:16`, `1:1`
refs	array	Optional. Up to 4 reference image URLs

GET/v1/jobs/:id

Poll job status. When status is completed, the response includes the output URL.

{
  "id": "job_a1b2c3",
  "status": "completed",
  "output": "https://cdn.nadoai.ru/media/a1b2c3.mp4"
}

Available Models

Model ID	Type	Price
`veo-3-fast`	Video	from $0.27/video
`kling-3`	Video	from $0.09/sec
`nano-banana`	Image	from $0.018/img
`chatgpt-image-1.5`	Image	from $0.018/img

Error Codes

Code	Meaning
401	Invalid or missing API key
402	Insufficient balance
429	Rate limit exceeded
500	Generation failed — not charged

Rate Limits

Default limit is 60 requests/minute per key. Contact support to increase limits for production workloads.