Errors

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable error message",
    "request_id": "uuid"
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid input data",
    "details": [...],
    "request_id": "uuid"
  }
}

{
  "error": "Rate limit exceeded: 10 per 1 day"
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing authentication credentials",
    "request_id": "abc-123"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Video not found",
    "request_id": "abc-123"
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Request validation failed",
    "details": [
      {"loc": ["body", "prompt"], "msg": "Field required"}
    ],
    "request_id": "abc-123"
  }
}

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits. Required: 5, Available: 2",
    "request_id": "abc-123"
  }
}

{
  "error": {
    "code": "INVALID_STATE",
    "message": "Cannot modify scenes for a completed video",
    "request_id": "abc-123"
  }
}

{
  "error": "Rate limit exceeded: 10 per 1 day"
}

{
  "error": {
    "code": "MAX_CONCURRENT_VIDEOS",
    "message": "You have 3 videos processing. Wait for one to finish.",
    "request_id": "abc-123"
  }
}

async function createVideo(data) {
  const response = await fetch('/videos', {
    method: 'POST',
    headers: {
      'X-Api-Key': apiKey,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
  })

  if (!response.ok) {
    const error = await response.json()
    const message = error.error || error.detail || response.statusText
    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After')
      console.log(`Rate limited. Retry after ${retryAfter} seconds.`)
    }
    throw new Error(message)
  }

  return response.json()
}

import requests

def create_video(data, api_key):
    response = requests.post(
        "https://api.sketchpen.app/api/v1/videos",
        json=data,
        headers={"X-Api-Key": api_key}
    )
    
    if not response.ok:
        error = response.json()
        message = error.get("error") or error.get("detail") or response.status_text
        if response.status_code == 429:
            retry_after = response.headers.get("Retry-After")
            print(f"Rate limited. Retry after {retry_after} seconds.")
        response.raise_for_status()
    
    return response.json()

curl -X POST https://api.sketchpen.app/api/v1/videos/uuid/approve \
  -H "X-Api-Key: sk_live_..."

curl -X POST https://api.sketchpen.app/api/v1/videos/uuid/regenerate \
  -H "X-Api-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"feedback": ""}'