curl — works by changing the base URL and
the API key.
Access requires a verified community account, and the service is
region-locked. If you don’t have an account yet, start with the
Quickstart.
What you get
Chat completions
OpenAI-compatible
POST /v1/chat/completions with streaming, tool
calling, vision input, and a reasoning_effort extension.Embeddings
POST /v1/embeddings with fixed 1024-dimension output.Live model catalog
GET /v1/models reflects exactly what your key can call right now,
including live input ceilings and rate limits.Quota introspection
Every completion carries a quota receipt, and
GET /v1/usage reports
your session and weekly standing.How it differs from OpenAI’s API
Square1 keeps the OpenAI wire format but is a shared community pool, so a few things work differently:- Quotas are pooled and weighted. You draw from a rolling session budget and a weekly budget, and each model has a shared daily cap. See Quotas.
- Responses carry a quota receipt. The
wellspringblock and a set ofx-session-*/x-weekly-*headers tell you where you stand after every request. See Quota feedback. - The request schema is a strict subset. Fields like
n,presence_penalty,logprobs,seed, andresponse_formatare not accepted. The API Reference lists exactly what is. - Model routing is opaque by design. The API never reveals which
infrastructure serves a given model —
owned_bynames the model’s maker, nothing more.
Bring your own key
If you have your own account with a model provider, you can register that credential in the dashboard and route requests through it with the@provider/model syntax — see BYOK.