co/core
Developer docsDocs
Jump to
API reference

Inference API

OpenAI-compatible HTTP endpoints at https://console.cocore.dev/api/v1. Authenticated routes accept a co/core API key as Authorization: Bearer ….

Base URLhttps://console.cocore.dev/api/v1
/chat/completionspostauth: required

OpenAI-compatible chat completion. Routes to an attested provider serving the requested model.

ParamType
model*string
messages*array
streamboolean
max_tokensinteger
curl
API key
model
user message
max_tokens
curl -sS -X POST -H 'Authorization: Bearer $COCORE_API_KEY' 'https://console.cocore.dev/api/v1/chat/completions' -H 'Content-Type: application/json' -d '{"model":"stub","messages":[{"role":"user","content":"Hello"}],"stream":false,"max_tokens":256}'
response

Paste an API key above, then run the example.

/modelsgetauth: none

Public model directory. Default response matches OpenAI's list shape; use view for co/core-specific detail.

ParamType
viewstring
curl
view
curl -sS 'https://console.cocore.dev/api/v1/models'
response

Click Run example to fetch a live response.

/private/chat/completionspostauth: required

Same request shape as chat/completions, but routing is limited to providers run by DIDs on your friends list.

ParamType
model*string
messages*array
streamboolean
max_tokensinteger
curl
API key
model
user message
max_tokens
curl -sS -X POST -H 'Authorization: Bearer $COCORE_API_KEY' 'https://console.cocore.dev/api/v1/private/chat/completions' -H 'Content-Type: application/json' -d '{"model":"stub","messages":[{"role":"user","content":"Hello"}],"stream":false,"max_tokens":256}'
response

Paste an API key above, then run the example.

Dispatch errors

Returned when the exchange cannot place your request with a provider.

// 404 — no provider is serving this model
{ "error": { "type": "invalid_request_error", "code": "model_not_found", "message": "..." } }

// 503 — no providers are connected
{ "error": { "type": "service_unavailable_error", "code": "no_providers_connected", "message": "..." } }

// 503 — friends-only, but no friends are online
{ "error": { "type": "service_unavailable_error", "code": "no_friends_available", "message": "..." } }

// 404 — friends-only, but no friend serves this model
{ "error": { "type": "invalid_request_error", "code": "no_friends_for_model", "message": "..." } }

HTTP errors

Authentication, validation, and upstream failure responses.

{
  "error": {
    "message": "Missing Authorization: Bearer header",
    "type": "authentication_error",
    "code": null,
    "param": null
  }
}
  • 401 authentication_error — missing or invalid API key. Create a new key on /account.
  • 400 invalid_request_error — malformed body (missing model, messages, etc.).
  • 502 server_error — provider disconnected mid-stream. Retrying usually succeeds.