Skip to main content
The Verbosec API is a REST API that gives you programmatic access to the full Verbosec platform — from generating AI-powered text, images, and voice content through Nexus AI, to managing site deployments and custom domains through Starhost. Every request is made over HTTPS and all request and response bodies use JSON.
Base URL — All API endpoints are relative to:
https://api.verbosec.com/v1

​
What the API covers

Use the cards below to jump straight to any endpoint group.

Text Generation

Generate articles, summaries, paraphrases, and more with Nexus AI.

Image Generation

Create photorealistic or illustrated images from text prompts.

Voice Generation

Convert text to natural-sounding speech and download audio files.

File Chat

Upload documents and ask questions about their content.

Deployments

Create, monitor, and roll back Starhost site deployments.

Domains

Add custom domains to your sites and verify DNS records.

​
Getting your API key

Every request to the Verbosec API must include a valid API key. You generate your key from the Verbosec Cloud dashboard and pass it as a Bearer token in the Authorization header on every request. See the Authentication guide for full instructions on generating a key and using it safely.

​
Rate limits

Rate limits are enforced on a per-plan basis. If you exceed your plan’s request quota, the API returns a 429 Too Many Requests response. The response includes a Retry-After header indicating how many seconds you should wait before retrying. Upgrade your plan in the Verbosec Cloud dashboard if you consistently hit rate limits in production.

​
Error responses

All API errors return a JSON body with a top-level error object containing a machine-readable code and a human-readable message. Use the code field in your application logic to handle specific error conditions programmatically.
error-response.json
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}
Status codeMeaning
200 OKThe request succeeded and a response body is returned.
201 CreatedA new resource was created successfully.
400 Bad RequestThe request body is invalid or a required parameter is missing.
401 UnauthorizedYour API key is missing or invalid.
403 ForbiddenYour API key is valid but does not have permission to access this resource.
429 Too Many RequestsYou have exceeded your plan’s rate limit.
500 Internal Server ErrorAn unexpected error occurred on the Verbosec servers.