RESTful API

Standard HTTP JSON API. Works with any language or framework.

API key auth

Authenticate with a bearer token from your Settings page.

Streaming

Manifest and Insight endpoints support Server-Sent Events for real-time progress.

Authentication

# Add to all requests

Authorization: Bearer hk_your_api_key_here

Generate API keys in Settings → API Keys. API access requires the Agency plan.

Endpoints

MethodEndpointDescriptionPlan
POST/v1/insight/researchRun brand research pipelineAgency+
POST/v1/forge/runRun Forge production brief agentsAgency+
GET/v1/forge/:idRetrieve Forge output by run IDAgency+
POST/v1/manifest/generateGenerate strategy deck (streaming)Agency+
POST/v1/craft/imageGenerate images via fal.aiAgency+
POST/v1/craft/videoGenerate video (async)Agency+
GET/v1/modelsList available AI modelsPro+
GET/v1/projectsList your projectsPro+

Quick start

# Run Insight research

curl -X POST https://hypnotic.ai/api/v1/insight/research \

-H "Authorization: Bearer hk_..." \

-H "Content-Type: application/json" \

-d '{"subject": "Nike", "projectId": "proj_xxx"}'

Full API reference, SDKs, and code examples coming soon. Join the developer waitlist.