API Documentation

Authorization: Bearer sk_live_YOUR_API_KEY

{
  "id": "a1b2c3d4-e5f6-...",
  "status": "queued",
  "model": "seedance-2.0",
  "duration": 5,
  "aspect_ratio": "16:9",
  "estimated_cost": 170,
  "credits_remaining": 10630,
  "created_at": "2026-04-02T12:00:00"
}

import requests
import time

API_KEY = "sk_live_YOUR_KEY"
BASE = "https://genray.ai/api/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}

# Step 1: Submit generation
resp = requests.post(f"{BASE}/videos", headers=headers, json={
    "prompt": "A cat wearing a tiny chef hat, cooking pasta in a sunlit kitchen",
    "duration": 10,
    "aspect_ratio": "16:9",
    "model": "seedance-2.0"
})
job = resp.json()
print(f"Job submitted: {job['id']}")

# Step 2: Poll for result
while True:
    status = requests.get(f"{BASE}/videos/{job['id']}", headers=headers).json()
    if status["status"] == "completed":
        print(f"Video ready: {status['video_url']}")
        break
    elif status["status"] == "failed":
        print(f"Failed: {status['error']}")
        break
    time.sleep(5)

const API_KEY = 'sk_live_YOUR_KEY';
const BASE = 'https://genray.ai/api/v1';

// Submit generation
const job = await fetch(`${BASE}/videos`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 5,
    aspect_ratio: '16:9',
  }),
}).then(r => r.json());

console.log('Job:', job.id);

// Poll for result
while (true) {
  const status = await fetch(`${BASE}/videos/${job.id}`, {
    headers: { 'Authorization': `Bearer ${API_KEY}` },
  }).then(r => r.json());
  if (status.status === 'completed') {
    console.log('Video URL:', status.video_url);
    break;
  }
  if (status.status === 'failed') throw new Error(status.error);
  await new Promise(r => setTimeout(r, 5000));
}

curl -X POST https://genray.ai/api/v1/videos/from-person \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "person_image_url": "https://your-host.com/photo.jpg",
    "prompt": "The character turns head slowly, soft daylight, cinematic close-up, subtle smile",
    "duration": 5,
    "aspect_ratio": "9:16"
  }'

{
  "id": "a1b2c3d4-...",
  "status": "queued",
  "model": "seedance-2.0",
  "duration": 5,
  "aspect_ratio": "9:16",
  "total_cost": 142,
  "credits_remaining": 9708,
  "created_at": "2026-04-21T10:23:21"
}

curl -X POST https://genray.ai/api/v1/upload \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -F "file=@/path/to/photo.jpg"

{
  "url": "/v1/files/upload_u42_abc123_xyz.jpg",
  "full_url": "https://genray.ai/v1/files/upload_u42_abc123_xyz.jpg",
  "size_bytes": 290150
}

{
  "id": "a1b2c3d4-e5f6-...",
  "status": "completed",
  "model": "seedance-2.0-pro",
  "duration": 5,
  "aspect_ratio": "16:9",
  "credits_spent": 170,
  "video_url": "https://genray.ai/videos/abc123.mp4",
  "width": 1280,
  "height": 720,
  "duration_ms": 5040,
  "cover_url": "https://genray.ai/videos/abc123_cover.jpg",
  "created_at": "2026-04-02T12:00:00"
}

curl -X POST https://genray.ai/api/v1/videos/42/upscale \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

{
  "plan": "standard",
  "plan_name": "Standard",
  "plan_expires_at": "2026-05-02T00:00:00",
  "credits_remaining": 8450,
  "credits_per_month": 4850,
  "api_rpm": 10,
  "api_concurrent": 2,
  "max_api_keys": 2
}

// POST to your webhook_url
// Header: X-Genray-Signature: sha256=abc123...
// Header: X-Genray-Event: video.completed

{
  "event": "video.completed",
  "data": {
    "id": "a1b2c3d4-e5f6-...",
    "status": "completed",
    "video_url": "https://genray.ai/videos/abc123.mp4",
    "width": 1280,
    "height": 720,
    "duration_ms": 5040
  },
  "timestamp": "2026-04-02T12:05:00"
}

import hmac, hashlib

def verify_webhook(payload_body, signature_header, webhook_secret):
    expected = hmac.new(
        webhook_secret.encode(),
        payload_body,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature_header)

{
  "detail": {
    "error": "insufficient_credits",
    "message": "Not enough credits. Need 170, have 50.",
    "credits_required": 170,
    "credits_available": 50
  }
}