Studio API

The Studio API provides endpoints for generating and manipulating media — images, videos, audio effects, voiceovers, dialogue, and music. All endpoints are accessed under /api/v1/studio/* and authenticated with your API key.

Authentication

Studio endpoints use the same API key authentication as the Chat API. Include your key in the Authorization header:

Authorization: Bearer sk-tm-YOUR_KEY_HERE

Base URL

https://terramind.com/api/v1/studio

Response Format

Most Studio endpoints return a JSON response with a consistent structure:

{
  "success": true,
  "data": {
    "url": "https://...",
    "model": "nano-banana",
    // ... endpoint-specific fields
  },
  "credits": {
    "used": 1,
    "cost": 5.0,
    "remaining": 9995.0
  }
}

Credits

Studio operations consume credits from your organization's balance. The credit cost varies by operation and model. The credits object in the response shows the amount deducted and your remaining balance.

Available Endpoints

Error Codes