NovaKitv1.0

API Reference

Complete reference for all NovaKit API endpoints

API Reference

Explore the complete NovaKit API. All endpoints use the base URL:

https://www.novakit.ai/api/v1

Endpoints

Common Patterns

Request Format

All requests should:

  • Use Content-Type: application/json
  • Include Authorization: Bearer sk_your_api_key header
  • Send JSON-encoded request bodies for POST requests

Response Format

All responses return JSON with consistent structure:

{
  "created": 1703123456,
  "data": { ... },
  "model": "model-id",
  "model_tier": "standard",
  "usage": {
    "credits_used": 10,
    "credits_remaining": 990
  }
}

Async Mode

Long-running operations support async mode with ?async=true:

# Start async job
POST /images/generations?async=true

# Response
{
  "id": "job_abc123",
  "status": "pending"
}

# Poll for completion
GET /jobs/job_abc123?poll=true

Error Format

All errors follow a consistent format:

{
  "error": "Error message describing what went wrong"
}

See Error Codes for a complete list.

On this page