Creatorline API

Creatorline runs AI creators: a persona with a consistent face, voice and audience, posting on a schedule. The API gives you every piece of that pipeline except the human judgement — generate media as a specific creator, then publish it to their connected accounts. Three surfaces, one implementation. They share the same key, the same validation, and the same credit accounting.

REST

Your backend, your scripts, anything that speaks HTTP.

CLI

crl — terminals, CI, and coding agents.

MCP

Claude Code, Cursor, any MCP client.

Quickstart

Create a key

In the studio, go to Settings → API and create a key with the write scope. The key is shown once — copy it now.

export CREATORLINE_API_KEY="crl_sk_live_…"

Check it works

curl https://api.creatorline.io/v1/me \
  -H "Authorization: Bearer $CREATORLINE_API_KEY"

{
  "object": "account_info",
  "workspace": { "id": "…", "name": "Studio", "plan": "plus", "credit_balance": 4433 },
  "api_key": { "id": "oyYv4L5qhJlH", "name": "Backend", "scope": "write" }
}

Generate something

curl https://api.creatorline.io/v1/generations \
  -H "Authorization: Bearer $CREATORLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "text-to-photo",
    "prompt": "matcha latte flatlay on linen, morning light",
    "params": { "aspect_ratio": "4:5" }
  }'

Returns immediately with a job handle and the credits it charged:

{ "object": "generation", "id": "3f6c1a2b-…", "status": "queued",
  "model": "nano-banana-2-text-to-image", "credits_charged": 2, "credit_balance": 4431 }

Poll until it's done

curl https://api.creatorline.io/v1/generations/3f6c1a2b-… \
  -H "Authorization: Bearer $CREATORLINE_API_KEY"

queued → processing → succeeded, then output[0].url is your image.

Result URLs are time-limited. Download the bytes rather than storing the link.

The shape of the thing

Generation is asynchronous, always

A photo takes ~30 seconds and a video several minutes, so no endpoint blocks on a run. You get a job handle and poll it. The run is durable: it survives your process dying, and you can rejoin it by id at any time.

The catalog is the source of truth

Do not hardcode model ids or parameter names. GET /v1/models returns every tool, every model, and the exact inputs and parameters each accepts — so a model added to the platform is usable from your code with no change on your side.

Prices are visible before you pay

POST /v1/generations/cost prices a run without starting it, using the same function the debit uses. A failed or moderation-blocked run is refunded automatically.

Publishing goes through the review gate

A post is created at pending_review and publishing is a separate, explicit call. If you want a human to approve, simply never call publish — the post waits in the studio’s review queue. See Publishing.

What you can do


Video	UGC video, short clips from a long source, scene replacement, motion sync, burned-in hook captions
Photo	text to photo, character-consistent photo editing
Audio	text to speech, lipsync, voice change, dialogue, audio over video
Creators	list the workspace’s AI creators and generate as one of them
Media	browse the library, upload your own images, video and audio
Publishing	build a post from media and send it to TikTok, Instagram, YouTube or Telegram
Billing	live credit balance and the full consumption ledger

Get started

Guides

API reference

REST

CLI

MCP

Quickstart

The shape of the thing

What you can do

REST

CLI

MCP

​Quickstart

​The shape of the thing

​What you can do

Quickstart

The shape of the thing

What you can do