Skip to main content
All RunBlob API requests require authentication using Bearer tokens. Keep your API keys secure and never expose them in client-side code.

​
Getting Your API Key

1

Sign Up

Create your RunBlob account at our dashboard.
2

Generate API Key

Navigate to the API Keys section and generate a new key.
Copy your API key immediately - it won’t be shown again for security reasons.
3

Store Securely

Store your API key in environment variables or secure configuration.
export RUNBLOB_API_KEY="your-api-key-here"

​
Using Your API Key

​
Required Headers

Every API request must include these headers:
​
Authorization
string
required
Bearer token with your API key: Bearer YOUR_API_KEY
​
Content-Type
string
required
Always set to application/json for POST requests

​
Example Request

curl -X POST https://platform.runblob.io/v1/veo/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A beautiful sunset over mountains"
  }'

​
Security Best Practices

Never expose API keys in:
  • Frontend JavaScript code
  • Mobile app source code
  • Public repositories
  • URL parameters
Always use server-side requests for API calls.
Store API keys in environment variables:
# .env file
RUNBLOB_API_KEY=your-api-key-here

import os
api_key = os.getenv('RUNBLOB_API_KEY')
Regularly rotate your API keys:
  • Generate new keys periodically
  • Revoke old keys after updating your applications
  • Monitor key usage in your dashboard
Track your API usage:
  • Monitor request patterns in your dashboard
  • Set up alerts for unusual activity
  • Review logs regularly

​
Error Responses

​
Invalid API Key

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

​
Missing Authorization Header

{
  "error": "Unauthorized", 
  "message": "Authorization header required"
}

​
Malformed Authorization Header

{
  "error": "Unauthorized",
  "message": "Invalid authorization format. Use: Bearer YOUR_API_KEY"
}
Need help? Contact our support team via Telegram if you have issues with authentication.