Authentication

All LTX API requests require authentication using API keys. API keys are associated with your account and provide access to the API endpoints.

Getting Your API Key

Sign in to the Developer Console to create your API key.

Using Your API Key

Include your API key in the Authorization header of every request using the Bearer token format:

Authorization: Bearer YOUR_API_KEY

Example Request

curl -X POST https://api.ltx.io/v2/text-to-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A majestic eagle soaring through clouds",
    "model": "ltx-2-5-pro",
    "duration": 8,
    "resolution": "1920x1080"
  }'

import requests
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
response = requests.post(
    "https://api.ltx.io/v2/text-to-video",
    headers=headers,
    json={
        "prompt": "A majestic eagle soaring through clouds",
        "model": "ltx-2-5-pro",
        "duration": 8,
        "resolution": "1920x1080"
    }
)

The response contains a job ID that you use to check the status and download the video. See Async Jobs.

Security Best Practices

Environment Variables

Store your API key in environment variables:

Bash:

export LTXV_API_KEY="your_api_key_here"

Python:

import os
api_key = os.environ.get("LTXV_API_KEY")

Node.js:

const apiKey = process.env.LTXV_API_KEY;

Authentication Errors

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

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid API key"
  }
}

Common authentication issues:

Rate Limits

API keys are subject to rate limits based on your plan. If you exceed your rate limit, you’ll receive a 429 Too Many Requests response.

Contact our team to discuss rate limit increases for your use case.