Skip to main content

Authentication

Move API uses API key authentication to secure your requests. All API requests must include your API key in the request headers.

Getting your API key​

  1. Sign up for a Move AI account at dev.move.ai
  2. Navigate to the API section in your dashboard
  3. Generate a new API key
  4. Copy the key and keep it secure

Using your API key​

Include your API key in the Authorization header of all API requests:

curl -X POST https://api.move.ai/v1/files \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "example.mp4"}'

JavaScript/TypeScript example​

const response = await fetch('https://api.move.ai/v1/files', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'example.mp4'
  })
});

Python example​

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.post(
    'https://api.move.ai/v1/files',
    headers=headers,
    json={'name': 'example.mp4'}
)

Security best practices​

  • Never expose your API key in client-side code or public repositories
  • Rotate your API keys regularly
  • Use environment variables to store API keys securely
  • Monitor your API usage to detect any unauthorized access

Rate limits​

API requests are subject to rate limits based on your plan:

  • Free Tier: 100 requests per hour
  • Developer Plan: 1,000 requests per hour
  • Professional Plan: 10,000 requests per hour
  • Enterprise Plan: Custom limits

Error responses​

If authentication fails, you'll receive a 401 Unauthorized response:

{
  "error": "Invalid API key",
  "code": "AUTH_ERROR"
}

Next steps​