Docs menu

Docs / API

Coming soon endpoints

Video, audio and embeddings endpoints return 501 not_available_yet. They are not charged and no model is called.

Last updated


What is available now

Cent AI serves chat and image models. These endpoints are open:

MethodPath
POST/v1/chat/completions
POST/v1/responses
POST/v1/messages
POST/v1/messages/count_tokens
GET/v1/models
POST/v1/images/generations
POST/v1/images/edits
GET/v1/images/{id}

The image endpoints are described on Images.

Endpoints that return 501

The endpoints below are known paths that are not open yet. Each one returns HTTP 501 not_available_yet.

GroupPaths
Video/v1/videos, /v1/videos/{id}, /v1/videos/{id}/content
Audio/v1/audio/speech, /v1/audio/transcriptions, /v1/audio/translations
Embeddings/v1/embeddings

Models for these endpoints are not listed in GET /v1/models while the endpoint is closed. There is no date for when each endpoint opens.

Response

{"error": {"message": "This endpoint is not available yet.", "type": "invalid_request_error", "code": "not_available_yet"}}

A 501 response:

  • is not charged and does not touch your balance
  • does not call any model
  • carries the x-request-id header like every other response

Example

curl -i https://api.cent-ai.dev/v1/embeddings \
  -H "Authorization: Bearer $CENT_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"Hello"}'

The response status is 501 with the body shown above.

The key is checked first

Cent AI checks a request in this order before the 501:

#CheckResult when it fails
1Body shape and size400 invalid_request or 413 request_too_large
2API key401 invalid_api_key
3The key's project is not archived403 project_archived
4The endpoint is open501 not_available_yet

A wrong, revoked or missing key always gets 401, even on an endpoint that is not open yet. A 501 tells you the key was accepted.

What to do

Send chat and image requests to the endpoints in the first table. If your tool calls one of the closed endpoints, turn that feature off in the tool. See Errors.

Contract


POST/v1/embeddings

Embeddings (not available yet)

Auth · API key (Bearer or x-api-key)

Responses

  • 401Error in the OpenAI shape.
  • 501The endpoint is not open yet; not billed and the model is never called.

Response headers

x-request-id

POST/v1/audio/speech

Text to speech (not available yet)

Auth · API key (Bearer or x-api-key)

Responses

  • 401Error in the OpenAI shape.
  • 501The endpoint is not open yet; not billed and the model is never called.

Response headers

x-request-id

Generated from the OpenAPI contract.