API Documentation

Complete reference for the AI402 REST API. Generate assets with simple HTTP requests.

Introduction

The AI402 API is organized around REST. It accepts JSON-encoded request bodies and returns JSON-encoded responses. All responses are compressed for performance.

Base URL

https://ai402.net

Quick Start

# Generate an image example
curl -X POST https://ai402.net/v1/image \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A sunset over mountains"}'

Authentication

All API requests require authentication using an API key. Include your key in the X-API-Key header.

X-API-Key: ai402_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Error Handling

We use standard HTTP status codes. Errors include a descriptive JSON body.

{
  "error": "Insufficient credits",
  "required": 50,
  "available": 10
}

Image Generation

Generate images from text prompts or edit existing images. Cost: 1 credit.

const response = await fetch('https://ai402.net/v1/image', {
  method: 'POST',
  headers: {
    'X-API-Key': 'your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'A futuristic city with flying cars'
  })
});

const data = await response.json();
console.log(data.url);

Video Generation

Generate 8-second videos. Cost: 50 credits.

{
  "success": true,
  "url": "https://ai402.net/video/...",
  "credits_used": 50
}

Voice Synthesis

Convert text to natural speech. Cost: 0.5 credits.