API / 05

The public boundary.

Partner integrations use the CXN API, the public connection for other tools. Imaginary Tools stays the processing room behind it.

ABOUTThe room is here. CXN connects it outside.
   %@%  --*--  @@

How it works

Humans work in the studio origin. Signed-in studio calls go to /api/* on that origin and need a session. Generation and checkout are live. Unsigned generate, quote, account, character-pack, and assemble calls return 401.

How to use

  1. Humans: sign in at /login or /signup, then use /studio.
  2. Read /api/capabilities for what the studio can quote right now.
  3. Partner systems integrate through CXN, not by scraping this site.
  4. Do not send provider secrets to apps/web. The Worker holds them.
  5. If a route returns 401, sign in. That is the gate, not a missing product.

What this is not

  • Imaginary Tools is not the public partner API. CXN is.
  • Character pack and assemble routes exist for signed-in use. They are not studio instruments and not public unauthenticated APIs.
  • There is no Higgsfield Cinema Studio iframe on this origin.

Back to the notes