Generate a Project

Generate the full project artifact after the draft and optional intake phases. This route is the final generation step in the staged Projects API lifecycle.

POST

/api/v1/projects/generate

Example request

curl https://api.vidbyte.ai/api/v1/projects/generate \
  -H "Authorization: Bearer vb_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "proj_Mx1q8Tt2",
    "prompt": "Design a backend observability project",
    "answers": [
      "Node.js + Postgres",
      "I want tracing, logs, and dashboards",
      "I can spend 15 hours on the project"
    ]
  }'

Example response

{
  "success": true,
  "id": "proj_Mx1q8Tt2",
  "data": {
    "id": "proj_Mx1q8Tt2",
    "item_type": "project",
    "title": "Backend observability project",
    "status": "active",
    "createdAt": "2026-04-10T18:00:00",
    "updatedAt": "2026-04-10T18:15:00",
    "project_data": {
      "generation_status": "project_completed",
      "project_output": { "title": "Backend observability project", "sections": [{ "title": "Telemetry architecture" }] }
    }
  },
  "token_stats": { "input_tokens": 1132, "output_tokens": 1544, "total_tokens": 2676 },
  "pricing": { "total_cost": 0.0392 }
}

Parameter information

These are the public parameters for /api/v1/projects/generate. Path parameters and request-body fields are shown together so the page stays focused on the live request contract you actually send.

promptstringRequired

The main topic, task, or learning objective you want Vidbyte to generate from. This is the core instruction the route uses.