# Creatorline

> Generate AI influencer photos and videos, and publish them to social platforms, from your own code.

## Docs

- [Who am I](https://docs.creatorline.io/api-reference/account/who-am-i.md): The workspace this key belongs to, its plan, the live credit balance, and the key's own name and scope. The cheapest way to verify a key works.
- [Finish an upload](https://docs.creatorline.io/api-reference/assets/finish-an-upload.md): Tell us the bytes landed. Flips the asset to `ready` and kicks off thumbnailing/transcoding. Idempotent: completing a finished asset returns it again.
- [Get one asset](https://docs.creatorline.io/api-reference/assets/get-one-asset.md)
- [List media](https://docs.creatorline.io/api-reference/assets/list-media.md): Generated creations, uploads and references. URLs are resolved on read and are time-limited for stored objects.
- [Start an upload](https://docs.creatorline.io/api-reference/assets/start-an-upload.md): Uploads are two-step and the bytes never pass through this API:
- [List tools and models](https://docs.creatorline.io/api-reference/catalog/list-tools-and-models.md): The live capability catalog: which tools exist, which models each can run, and the exact inputs and parameters those models accept.
- [List AI creators](https://docs.creatorline.io/api-reference/creators/list-ai-creators.md): Pass an account id as `account_id` on a generation and the run inherits that creator's look, voice and persona, and the output lands on their wall. Posts go to that creator's connected channels.
- [Balance and ledger](https://docs.creatorline.io/api-reference/credits/balance-and-ledger.md): The ledger is the source of truth for spend: one row per debit (a generation), grant (a top-up or plan renewal) and refund (a failed run).
- [Estimate a generation's cost](https://docs.creatorline.io/api-reference/generations/estimate-a-generations-cost.md): Price a run in credits WITHOUT starting it. Takes the same body as the create call and runs it through the same function the debit uses, so an estimate can never disagree with the charge. Free, and available to `read` keys.
- [List generations](https://docs.creatorline.io/api-reference/generations/list-generations.md)
- [Poll a generation](https://docs.creatorline.io/api-reference/generations/poll-a-generation.md): `queued` → `processing` → `succeeded` | `failed`.
- [Start a generation](https://docs.creatorline.io/api-reference/generations/start-a-generation.md): Start an image or video run. **This is the API's one paid operation** and it is asynchronous by design: a video takes minutes, so the call returns a job handle immediately and you poll `GET /v1/generations/{id}`.
- [Create a post](https://docs.creatorline.io/api-reference/posts/create-a-post.md): Turn finished media into a post for one creator. It is created at **`pending_review`** — the review gate's entry state. Nothing is public yet; it appears in the studio's review queue like any other post.
- [Get one post](https://docs.creatorline.io/api-reference/posts/get-one-post.md): After publishing, `channel_posts[]` carries each platform's status and the live URL once that platform confirms.
- [List posts](https://docs.creatorline.io/api-reference/posts/list-posts.md)
- [Publish a post](https://docs.creatorline.io/api-reference/posts/publish-a-post.md): **This is the one endpoint that reaches a real audience.** It moves the post `pending_review → scheduled` — the only legal transition — and hands it to the publisher. `published` is written only after the platform confirms, and a failed hand-off leaves the post scheduled and retryable rather than fa…
- [Authentication](https://docs.creatorline.io/authentication.md): Organization-scoped API keys: how they work, what they can do, and how to keep them safe.
- [CLI](https://docs.creatorline.io/cli.md): crl — generate and publish from your terminal, your CI, and your coding agent.
- [Errors and idempotency](https://docs.creatorline.io/errors.md): One error shape everywhere, what each status means, and how to retry safely.
- [Generating media](https://docs.creatorline.io/generations.md): Tools, models, inputs and parameters — and how a run actually flows.
- [Creatorline API](https://docs.creatorline.io/index.md): Generate AI influencer photos and videos, and publish them to social platforms, from your own code.
- [MCP server](https://docs.creatorline.io/mcp.md): Give Claude Code, Cursor, or any MCP client the ability to generate and publish.
- [Publishing](https://docs.creatorline.io/publishing.md): Turn finished media into a post and send it to your creator's connected accounts.

## OpenAPI Specs

- [openapi](https://docs.creatorline.io/openapi.json)