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:
| Method | Path |
|---|---|
| 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.
| Group | Paths |
|---|---|
| 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-idheader 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:
| # | Check | Result when it fails |
|---|---|---|
| 1 | Body shape and size | 400 invalid_request or 413 request_too_large |
| 2 | API key | 401 invalid_api_key |
| 3 | The key's project is not archived | 403 project_archived |
| 4 | The endpoint is open | 501 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.