API

Keys, endpoints, and code examples

Base URL
https://nova.hyppohq.io

API Keys

Loading keys...

Endpoints

POST/api/v1/media/generate

Generate an image or video from a text prompt. Supports reference images for Gemini models.

Request Body

{
  "prompt": "A cute quaker parrot",
  "model": "gemini-flash-image",
  "aspect_ratio": "1:1",
  "reference_image_urls": [
    "https://example.com/logo.png"
  ]
}

Response

{
  "data": {
    "job_id": "uuid",
    "status": "queued",
    "estimated_seconds": 5
  }
}
curl -X POST https://nova.hyppohq.io/api/v1/media/generate \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cute quaker parrot",
    "model": "gemini-flash-image",
    "aspect_ratio": "9:16"
  }'
GET/api/v1/media/:id

Poll for job status. Returns output_url when completed.

Response

{
  "data": {
    "job_id": "uuid",
    "status": "completed",
    "output_url": "https://...supabase.co/storage/...",
    "generation_time_ms": 6214
  }
}
curl https://nova.hyppohq.io/api/v1/media/JOB_ID \
  -H "x-api-key: YOUR_KEY"
POST/api/v1/media/remove-bg

Remove background from an image. Returns PNG with transparency.

Request Body

{
  "source_image_url": "https://example.com/photo.jpg"
}

Response

{
  "data": {
    "job_id": "uuid",
    "status": "queued",
    "estimated_seconds": 3
  }
}
curl -X POST https://nova.hyppohq.io/api/v1/media/remove-bg \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_image_url":"https://..."}'
POST/api/v1/media/upscale

Upscale an image up to 4x resolution using Real-ESRGAN.

Request Body

{
  "source_image_url": "https://example.com/photo.jpg",
  "scale": 4
}

Response

{
  "data": {
    "job_id": "uuid",
    "status": "queued",
    "estimated_seconds": 5
  }
}
curl -X POST https://nova.hyppohq.io/api/v1/media/upscale \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_image_url":"https://...","scale":4}'
GET/api/v1/media/jobs

List recent generation jobs, newest first. Supports limit and offset.

Response

{
  "data": [
    {
      "id": "uuid",
      "type": "image",
      "model": "gemini-flash-image",
      "status": "completed",
      "prompt": "...",
      "generation_time_ms": 6214,
      "created_at": "2026-03-21T..."
    }
  ]
}
curl "https://nova.hyppohq.io/api/v1/media/jobs?limit=50" \
  -H "x-api-key: YOUR_KEY"
GET/api/v1/media/models

List all available models and capabilities.

Response

{
  "data": [
    {
      "id": "gemini-flash-image",
      "name": "Gemini Flash Image",
      "type": "text-to-image",
      "available": true
    }
  ]
}
curl https://nova.hyppohq.io/api/v1/media/models \
  -H "x-api-key: YOUR_KEY"