Skip to main content
Everything related to your API account lives in the Ochy developer portal: API keys, webhooks, credits, usage, analyses, and settings. There are two kinds of accounts:
  • Self-serve developer account — register online and pay per analysis. For individual developers, indie products, and AI agents. Covered in the first part of this page.
  • Organization account — set up by the Ochy team with contract pricing and volume credits. See organizations.

​
Self-serve in five steps

The whole path from zero to a working paid integration is self-serve. Card entry at checkout is the only step that requires a human.
1

Register

Create an account at developers.ochy.io/register with email and password, or continue with Google or Apple.Already have an Ochy account (mobile app or web app)? Sign in with it instead: the portal asks you to enable API access once, then continues with the steps below.
2

Verify your email

Ochy sends a verification link when the account is created. Verifying does two things: it unlocks API key generation, and it grants 1 free analysis credit (once per account) so you can run your first analysis without paying.
3

Generate an API key

Open the Get started checklist or the Integration tab and click Generate API Key. The key is shown once — store it in an environment variable or a secrets manager. See authentication for how to pass it on requests.
4

Run your first analysis

Follow the quickstart. The first analysis consumes the free credit, so no card is required to validate your integration.
5

Buy credits

In the Usage & Credits tab (or the Get started checklist), choose a quantity (1–500) and pay through Stripe Checkout. One credit runs one analysis.

​
Pricing

Each analysis debits one credit when it starts. If starting the analysis then fails on our side, the credit is refunded automatically. When your balance reaches zero, POST /analysis/start returns 424 with code insufficient_api_credits: buy more credits in the portal to continue. To be warned before that happens, set up low-credit alerts.
API keys are free. You only pay for analyses, so you can integrate and test request handling before buying anything.

​
For AI agents

An AI agent can complete every step of this funnel for its user except card entry:
  1. Register the account at https://developers.ochy.io/register (email and password form).
  2. Ask the user to click the verification link in their inbox. The free analysis credit is granted once the email is verified.
  3. Generate the API key from the portal and store it for the user (it is shown once).
  4. Run the first analysis on the free credit to validate the integration end to end.
  5. Hand off payment: start the credit purchase in the portal and give the Stripe Checkout URL to the user. Card entry is intentionally a human step.
Machine-readable entry points: Every documentation page is also available as Markdown by appending .md to its URL.

​
Organizations

Organization accounts are created by the Ochy team. Once your organization is set up:
  • Organization admins sign in to developers.ochy.io with their Ochy account. API keys are organization-scoped and draw from the organization’s shared credit balance. Members without the admin role cannot open the portal.
  • If your organization requires email verification codes at sign-in, the portal asks for the code sent by email before the dashboard loads (email and password sign-in only).
  • Credits are provisioned by contract (monthly allocations or unlimited plans). Online purchase is for self-serve accounts only: top-ups for organizations go through your Ochy contact.
  • Organization admins also get a Shoes tab to manage the catalog used by shoe recommendation.
The API section of the Ochy web app (app.ochy.io/organization/api) has moved to the developer portal. Contact sales to set up an organization.