POST /api/v1/projects/create

Create a Project

Create and generate a complete project in a single call. Returns the finished project resource with token usage and pricing.

POST
https://api.vidbyte.pro/api/v1/projects/create

Example request

bash
curl https://api.vidbyte.pro/api/v1/projects/create \ -H "x-api-key: vb_live_your_api_key" \ -H "Idempotency-Key: project-create-001" \ -H "Content-Type: application/json" \ -d '{ "prompt": "Design a portfolio-ready backend observability project for an intermediate engineer. Keep it deep but practical." }'

Example response

JSON
{ "success": true, "encrypted_id": "7d444840-9dc0-41a2-b7f3-0c3b6a5e4f21", "message": "Project created successfully.", "data": { "encrypted_id": "7d444840-9dc0-41a2-b7f3-0c3b6a5e4f21", "title": "Design a portfolio-ready backend observability project for an intermediate engineer. Keep it deep but practical.", "description": null, "project_data": { "generation_status": "project_completed", "project_output": { "title": "Backend observability project", "project_brief": "Build and ship an observability stack for a small backend service.", "sections": [] } }, "status": "active", "tags": [], "version": null, "actions_applied": [], "created_at": "2026-04-10T18:00:00", "updated_at": "2026-04-10T18:00:00" }, "token_stats": { "input_tokens": 902, "output_tokens": 1488, "total_tokens": 2390 }, "pricing": { "total_cost": 0.0352 }, "object": "project" }

Parameter information

These are the public parameters for /api/v1/projects/create. Path, query, and request-body parameters 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.