POST /
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.