Getting Started

Welcome to the AgentName API documentation. This guide will help you integrate our AI capabilities into your applications.

Base URL

Authentication

All API requests require an API key passed in the request headers.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Quick Start

Make your first API call to generate an image:

POST /api/generate
{
  "prompt": "A futuristic city at night",
  "type": "image",
  "aspect_ratio": "16:9"
}

Images API

Generate high-quality images from text descriptions using our advanced AI models.

Generate Image

Request Body

Response

{
  "jobId": "job_1234567890_abc123",
  "status": "queued"
}

Check Status

Videos API

Create short AI-generated videos from text prompts.

Generate Video

POST /api/generate
{
  "prompt": "Ocean waves at sunset",
  "type": "video",
  "duration": 10,
  "aspect_ratio": "16:9"
}

Chat API

Send messages and receive AI-powered responses in real-time.

Send Message

POST /api/chat
{
  "message": "What can you help me with?"
}

{
  "reply": "I can help you generate images, videos...",
  "timestamp": "2026-02-28T00:00:00.000Z"
}

Rate Limits

To ensure fair usage, the following rate limits apply per account tier.

Error Handling

All errors follow a consistent JSON format.

{
  "error": "Descriptive error message",
  "code": 400
}