API Reference Overview

Base URL

All API requests should be made to:

https://geoff.ai/api

Authentication

Endpoints require your API key and an explicit X-Stack-Id header identifying an authorized stack.

Authorization: Bearer YOUR_API_KEY
X-Stack-Id: stk_jmqog66ha0mugmro

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

Make a request

Open an endpoint and select Try it. Enter your own API key, fill in the request fields, and select Send. These are real requests charged to your account. Enter only the key in a bearer-token field, or Bearer YOUR_API_KEY in an Authorization header field. The playground supplies the Geoff stack automatically. API keys stay in page memory and are cleared when the page is reloaded.

Response Format

Generation endpoints return JSON results. Other endpoints may return streaming responses or binary content; see their response definitions.

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

Error Handling

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": "Check the request parameters."
  }
}

Available APIs

Category	Description
Text	Chat completions and streaming text
Speech	Speech generation, transcription, voice design, and audio editing
Training	Custom LoRA adapters for image / video / music, plus voice model training
Video	Video generation with optional reference media
Image	Image generation and editing
Music	Original music generation
File	File upload, retrieval, and management

​Base URL

​Authentication

​Make a request

​Response Format

​Error Handling

​Available APIs