API reference
Ideas API
2 operations · https://app.makeaivideo.ai/api/v1
What the ideas endpoints are for
The step before scripting. POST /ideas returns scored video concepts for a niche, which is what a content pipeline needs when the question is what to make rather than how to make it.
POST /ai/enhance-prompt does something narrower and more useful than it sounds: it rewrites a thin topic into a fuller brief. A weak brief produces a weak script and a weak video, and the failure only becomes obvious after credits are spent, so improving the brief first is the cheapest quality gain available.
Get scored ideas for a niche
curl -X POST https://app.makeaivideo.ai/api/v1/ideas \
-H "Authorization: Bearer $MAV_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"niche": "personal finance for freelancers",
"tone": "educational",
"count": 10
}'POST
/ideasaiScored video ideas for a niche
POST https://app.makeaivideo.ai/api/v1/ideas
Responses
200Ideas
POST
/ai/enhance-promptaiRewrite a rough topic into a stronger brief
POST https://app.makeaivideo.ai/api/v1/ai/enhance-prompt
Responses
200Enhanced
Ideas API questions
- How do I generate video ideas for a niche?
- POST /ideas returns scored concepts for the niche you give it, which suits a pipeline that needs a queue of topics rather than one at a time.
- Will a better prompt actually improve the video?
- It is the cheapest lever available. A thin brief produces a thin script, and you only find out after rendering, so POST /ai/enhance-prompt rewrites the brief before any credits are committed.
Related
- Quickstart — the create, poll and download loop end to end.
- Authentication — what the ai scope on this page mean.
- Agents — calling these endpoints from an autonomous agent.