API reference

Your credit balance, plan, projects and available avatars.

curl https://aitachyon.com/api/me \
  -H "Authorization: Bearer ait_your_token"

Every spend and refund, each linked to the job that caused it.

What you pay and what you owe, in your own prices: how the account pays, your price for every action and model, the period's usage by action and model (?period=this_month|last_month|30d, or unpaid for invoiced accounts), and your last 50 jobs.

Your library, newest first. Every item has a typed ref (img_, scn_, avt_, vo_, vjob_); page with ?before=next_before.

Your active API tokens (no secrets). Signed-in session only: a token cannot list or mint tokens.

Create a token; returned once. Signed-in session only. Optional: spend_cap_usd with cap_window day|month (jobs past it get a 402 KEY_SPEND_CAP), customer_ref (recorded on every charge), expires_in_days, can_mint (a platform key).

The MCP server over streamable HTTP. Point any MCP client here with your bearer token; nothing to install.

One item by its ref, in any status: poll a job and fetch its result with the same call.

curl https://aitachyon.com/api/generations/img_5fee6424-9a04-4f7c-8d82-5ece61c0d318 \
  -H "Authorization: Bearer ait_your_token"

Delete one item for good: its file, then its library entry (the charge stays on your ledger). 200 { deleted, ref, file_deleted }; 404 if it is not yours, or outside the project a project-bound key is tied to; 409 JOB_RUNNING while a job is still pending or processing.

With a platform key: create a key for one of your customers, with name, customer_ref, spend_cap_usd, cap_window (day|month) and expires_in_days. Returned once.

With a platform key: its active child keys, each with calls and billed USD over a range (?from=&to=, default this month), filterable by ?customer_ref=.

With a platform key: revoke one child key (?id=).

Whether this account can switch to prepaid, and at what rate.

Switch to prepaid. For an account with no subscription and no credits left.

Balance, spend today/7d/30d, burn per day, days left, spend by action, every charge with its cost.

GET https://aitachyon.com/api/wallet

{
  "ledger": [
    {
      "at": "2026-11-01T09:30:12.000Z",
      "kind": "charge",
      "amount_usd": -0.1008,
      "balance_after_usd": 9.9,
      "action": "image_generation",
      "model": "nanobanana",
      "credits": 4,
      "provider_cost_usd": 0.0336,
      "markup_pct": 200,
      "estimated": false,
      "note": null
    }
  ]
}

A Stripe checkout for the amount you choose. The card is kept for automatic top-ups.

Automatic top-up: recharge X when the balance falls under Y. Signed-in session only: a token cannot change when your card is charged.

Generate an image. Providers differ in price; a people shot may add a finishing pass.

curl https://aitachyon.com/api/images/generate \
  -H "Authorization: Bearer ait_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "<project id>",
    "prompt": "product on linen, soft daylight",
    "style": "Product Shot",
    "width": 1024,
    "height": 1280
  }'

Remove background, upscale, vectorize, replace background or inpaint.

See the art-directed prompt before spending anything.

Image concepts for a brand or product.

Generate a b-roll clip. Eight engines; flat-priced on the default tier, per-second on the others.

curl https://aitachyon.com/api/scenes/generate \
  -H "Authorization: Bearer ait_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "<project id>",
    "prompt": "the product turning slowly on a kitchen counter",
    "engine": "seedance-2.5",
    "duration": 5,
    "ratio": "16:9"
  }'

Poll a scene until the mp4 is ready.

curl https://aitachyon.com/api/scenes/status/<task id> \
  -H "Authorization: Bearer ait_your_token"

Preview the art-directed video prompt, free.

Upscale a finished video to 1080p or 4K.

Reframe to another aspect ratio, generatively.

Transfer the motion and camera of a driving clip onto a still.

Retrofit lipsync onto an existing clip.

Dub a video into another language.

Remove the background, green-screen output.

Score a finished video for virality before you post it.

Assemble clips, voiceover and captions into a finished mp4.

Avatar video from an avatar and a voiceover.

Poll an avatar render.

Create a reusable persona from a description.

Build a likeness of yourself from reference photos.

A presenter shot matched to your brand.

Plan a creator-style shoot, free.

Voiceover from a script.

Every voice you can use.

Hear a voice before committing, free.

Clone a voice from a sample; returns a reusable voice id.

Speak with a cloned voice.

A background track.

A short sound effect.

Read a URL for its logo, colours, fonts and usable imagery. Free, and nothing is created.

Analyse a website into a brand kit.

Create a brand kit by hand.

Generate a logo.

An ad script from a brief.

Headlines, CTAs and captions, free.

Platform-sized captions.

Distinct campaign angles for one product.

A code-rendered carousel on your real brand theme.

An image turned into a downloadable GLB.

Poll a 3D job.

Upload an image, video or audio file to your account. Returns path, a signed url and a ref (upl_...) to delete it with.

Delete for good one file POST /api/upload stored, by the ref it returned. 200 { deleted }; 404 if it is not yours, already gone, or outside the project a project-bound key is tied to. A pinned copy is a library image: delete it with DELETE /api/generations/img_<id>.

A signed URL for one of your assets.

Search reference imagery, free.