Skip to main content
Version: V2

Introduction

The Tengr.ai Public API gives you the Tengr.ai platform's image and language stack as a set of REST endpoints. The same models that drive Tengr.ai's apps are available here without a UI in the way.

What you can do​

Generate images from a prompt. Pick one of our trained model families. Selena is the workhorse for high-fidelity creative work. Quantum and Hamilton trade off speed and detail differently. Each family ships with its own catalogue of styles and aspect ratios.

Vary or edit images you already have. Drop in a reference image and ask for a variation through Selena Variete, or edit one directly with Photo Pilot. Face refiner cleans up portrait detail, Face swap replaces a face from a source image.

Run utilities on images. Upscale a small image, push fidelity further with Detailer Upscaler, remove the background, generate a segmentation mask, or pull a depth map out of a single picture.

Keep a consistent visual identity. Style-DNA lets you encode a style once and reuse it across generations, so a series of outputs feels like it came from the same place.

Use the Textcraft LLM. For text-only work, call into our LLM through a single endpoint. Useful for prompt rewriting, copy generation, or anything you'd reach for a chat model to do.

Authentication​

Every endpoint uses API-key auth via the standard Authorization: Bearer ... header. Your key carries two access dimensions: a scope and a list of domains.

Scope sets your tier of capability:

  • generator — submit artwork-generation requests and read your own results.
  • manager — everything a generator can do, plus rotate your organization's webhook secret.
  • admin — everything a manager can do, plus mint and revoke manager and generator sub-keys for your organization.

The levels are a strict hierarchy: admin includes manager which includes generator.

Domains set which feature areas the key can reach:

  • artworks-internal — artwork generation, editing, and utility endpoints.
  • style-dna — Style-DNA endpoints.
  • textcraft — the Textcraft LLM endpoint.

A key can hold any combination of domains. A generator-scope key with ["artworks-internal", "textcraft"] can call the artwork and Textcraft endpoints, but not Style-DNA — even though scope-wise all three are open to a generator.

Admin keys are provisioned manually by Tengr.ai. Once you have an admin, they can mint additional manager or generator keys for the organization via POST /v2/organizations/:orgId/api-keys. If you need a broader admin, contact Tengr.ai support.

Webhooks​

Artwork creation in V2 is asynchronous. When you POST to a generation endpoint you get a 202 back immediately with an artwork ID, and the result lands at the webhook URL you supplied with the request once generation finishes.

Outbound webhooks are signed with HMAC-SHA256 using your organization's webhook secret. Each delivery carries a Tengrai-Timestamp and Tengrai-Signature header. Verify against ${timestamp}.${rawBody} before trusting the payload. The secret is rotated through POST /v2/organizations/:orgId/webhook-secret.

Versioning​

V2 is the current surface. This reference describes V2 only.

V1 is frozen at v1.4.0. It stays available during the transition window but is not actively maintained. Its reference lives under V1 (deprecated) in the version dropdown at the top of this page. Use V2 for new work.

Contact​

Tengr.ai Support Team: support@tengrai.com