API Reference Overview

Base URL

All API requests should be made to:

https://geoff.ai/api

All endpoints require a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

API keys can be created and managed in Settings > API Keys.

All responses are returned as JSON with the following general structure:

{
  "data": { ... },
  "trace_id": "04ede0ab069fb1ba8be5156a24b1e081",
  "extra_info": { ... }
}

Errors follow standard HTTP status codes:

Status Code	Description
`400`	Bad Request — Invalid parameters
`401`	Unauthorized — Invalid or missing API key
`403`	Forbidden — Insufficient permissions
`404`	Not Found — Endpoint or resource doesn’t exist
`429`	Too Many Requests — Rate limit exceeded
`500`	Internal Server Error

Error responses include a message:

{
  "error": {
    "code": "invalid_request",
    "message": "The 'model' field is required."
  }
}

Category	Description
Text	Chat completions via Anthropic, OpenAI, or AI SDK compatible APIs
Speech	Text-to-audio, async speech generation, voice cloning
Video	Text/image/frame-based video generation
Image	Text-to-image and image-to-image generation
Music	Music and lyrics generation
File	File upload, retrieval, and management