Skip to main content

Authentication

All requests to https://api.ecohash.com require an EcoLink API key, passed as a bearer token:

Authorization: Bearer eco_YOUR_KEY_HERE

Keys start with eco_. Create them in the console under API Keys. See API Keys for the full management guide.

Base URL

https://api.ecohash.com

All documented endpoints live under this host. The /v1 path prefix is used for OpenAI-compatible endpoints; a few EcoLink-specific management endpoints use other paths.

OpenAI SDK compatibility

Every /v1/* endpoint matches the OpenAI API shape, so any OpenAI SDK works if you override base_url:

from openai import OpenAI
client = OpenAI(
api_key="eco_YOUR_KEY",
base_url="https://api.ecohash.com/v1",
)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "eco_YOUR_KEY",
baseURL: "https://api.ecohash.com/v1",
});

Authentication errors

HTTPCondition
401 UnauthorizedMissing, malformed, or revoked API key
403 ForbiddenValid key but trying to access a resource that doesn't belong to your account (e.g. another account's inference instance)

Example 401 response:

{ "error": "unauthorized" }

A few endpoints (user management, billing, console-specific admin routes) use a JWT cookie set when you log in at console.ecohash.com. Those endpoints are not intended for programmatic use and aren't documented here — stick to the /v1/* OpenAI-compatible endpoints for API integrations.