Developer Docs

Identity Market API

Generate images using governed AI identities through a hosted API with authenticated access and usage tracking.

Authentication

Identity Market authenticates generate requests with Bearer API keys created from your account dashboard.

API Keys

  • API keys are created in Dashboard - API Access.
  • Keys are prefixed with aim_live_.
  • Each key is attached to one active access record.
  • A key created from a paid core-catalog plan can call any included founding catalog system.
  • Creator add-on identities still require access to that specific identity.
  • Keys can be revoked at any time and are only shown in full once.
Authorization Header
curl -H "Authorization: Bearer aim_live_your_key_here" https://identity-market.com/api/v1/generate

Security Best Practices

  • Never expose your API key in client-side code.
  • Store it in environment variables such as IDENTITY_MARKET_API_KEY=aim_live_....
  • Rotate keys regularly via the account dashboard.
  • Use one key per application or environment.

If a key is compromised

  • Revoke it immediately in Dashboard - API Access.
  • Generate a replacement key.
  • Update your application configuration and restart any workers using the old key.

Authentication Errors

  • 401 INVALID_API_KEY - key missing, invalid, expired, or revoked.
  • 401 IDENTITY_MISMATCH - key valid but not authorized for the requested identity.