API reference

Authentication

Authenticate VisionStory API requests with the X-API-Key header. Store the key in a server-side environment variable and never expose it in browser code, logs, or a public repository.

Request header

X-API-Key: $VISIONSTORY_API_KEY

Create or manage keys at visionstory.ai/openapi. A Pro plan or above is required.

Environment variable

The SDK, CLI, MCP server, and Agent Skill all read the same environment variable.

Shell

export VISIONSTORY_API_KEY="sk-vs-xxxxxxxxxxxxxxxxxxx"