Scripts
Generate title
Generate a video concept title and hook angle for a topic category.
Requires an API key with the scripts:generate scope. Costs 0.05 credits per request.
Authorization
bearerAuth AuthorizationBearer <token>
API key authentication. Create a key in your Account settings.
Pass the full key in the Authorization header:
Authorization: Bearer vsl_...Keys are shown only once at creation. Treat them like passwords.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scripts/title" \ -H "Content-Type: application/json" \ -d '{ "topic": "INTERESTING_FACTS" }'{ "title": "A medieval doctor used live frogs as heart monitors — and it actually worked.", "hookAngle": "Open on a frog tied to a patient's wrist. Show the pulse moving through the webbed foot. Reveal the 16th-century logic that made this a real diagnostic tool."}{ "error": { "code": "missing_api_key", "message": "string" }}{ "error": { "code": "missing_api_key", "message": "string" }}{ "error": { "code": "insufficient_credits", "message": "Insufficient balance. Required 0.05 credits. Available 0 credits" }}{ "error": { "code": "missing_api_key", "message": "string" }}{ "error": { "code": "missing_api_key", "message": "string" }}{ "error": { "code": "missing_api_key", "message": "string" }}