API Documentation

Everything you need to integrate COALS services into your applications. Send SMS, convert files, generate images and video — all through a single API key.

Quick Start

All COALS APIs use the same authentication pattern. Get an API key, then pass it in the Authorization header.

curl -X POST https://coals.ai/api/v1/{service}/{endpoint} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Authentication guide

Services

GraphiCoal

/api/v1/graphicoal

Generate, edit, and analyze images with FLUX. Convert rasters to SVG with vtracer vectorization.

POST /generate POST /edit POST /svg/generate

MagiCoal

/api/v1/magicoal

Generate video from images or text prompts using Wan2.2. Async workflow with progress polling.

POST /generate/i2v POST /generate/t2v GET /status/{uuid}

ConvertaCoal

/api/v1/convertacoal

Convert files between CSV, Excel, HTML, PDF, and JSON formats programmatically.

POST /convert GET /formats GET /download/{id}

SimCoal

/api/v1/simcoal

Send SMS messages via carrier gateways. Single and bulk send, delivery logs, and carrier management.

POST /send POST /send-bulk GET /logs

Platform

Authentication

API keys, scopes, and authorization headers

Errors

HTTP status codes and error response format

Rate Limits

Request limits, headers, and retry strategies