OA
OneAI API
Docs
POST /v1/generatetask typeLLM policyusage metadata
Reference: Generate
POST /v1/generate — the primary structured intelligence endpoint.
Request
Route by task type and choose a model mode or explicit provider/model.
{
"type": "agent_plan",
"input": { "goal": "Create a launch plan for OneAI API" },
"options": {
"debug": true,
"llm": {
"mode": "cheap",
"maxCostUsd": 0.02
}
}
}Model routing options
Use modes for cost-aware routing, or provider/model overrides when your plan allows explicit model selection.
{
"options": {
"llm": {
"mode": "cheap",
"provider": "openai",
"model": "gpt-5.2",
"maxCostUsd": 0.05
}
}
}Response metadata
Commercial callers should store requestId and usage for support and billing.
{
"success": true,
"requestId": "req_...",
"data": { "...": "..." },
"usage": {
"provider": "openai",
"model": "gpt-4o-mini",
"totalTokens": 699,
"estimatedCostUsd": 0.00027
}
}