Quickstart
Cuybly gives you access to the world's best AI models through a single REST endpoint. You don't need any SDK — if you can make an HTTP request, you're ready to go.
In three steps
api.cuybly.xyz/v1/chat with your key and a prompt. That's it.Authenticating requests
All requests to the Cuybly API must include your API key in the Authorization header using the Bearer scheme.
Authorization: Bearer YOUR_API_KEY
Where to find your key
Your API key is shown in the Cuybly dashboard after you sign in. If you lose it or need to rotate it, you can generate a new one from the API Keys page.
API overview
The Cuybly API follows a simple REST design. All requests are made over HTTPS, and all request and response bodies use JSON.
| Base URL | Format | Auth |
|---|---|---|
| api.cuybly.xyz | JSON | Bearer token |
POST /v1/chat
Send a message to any supported model and receive a response. This is the only endpoint you need.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | The model to use, e.g. gpt-4o, claude-3-5-sonnet |
| messages | array | Yes | Array of message objects with role and content |
| stream | boolean | No | Stream the response token-by-token. Defaults to false |
Message object
| Field | Values | Description |
|---|---|---|
| role | user · assistant · system | Who sent the message |
| content | string | The text of the message |
Response
{
"choices": [
{
"message": {
"role": "assistant",
"content": "Hello! How can I help you?"
},
"finish_reason": "stop"
}
],
"model": "gpt-4o"
}
Supported models
| Model | Provider |
|---|---|
| gpt-4o | OpenAI |
| gpt-4o-mini | OpenAI |
| llama-4-scout | Meta |
| llama-4-maverick | Meta |
Errors
Cuybly uses standard HTTP status codes. Errors return a JSON body with a message field describing what went wrong.
| Status | Meaning |
|---|---|
| 400 | Bad request — missing or invalid fields |
| 401 | Unauthorized — missing or invalid API key |
| 429 | Rate limited — slow down your requests |
| 500 | Server error — try again shortly |
{
"error": "Invalid API key",
"status": 401
}
Code examples
Full code examples for Python, JavaScript, cURL, and more are on their way.
Quickstart code for every popular language and framework is being written. In the meantime, the API reference above has everything you need to get started.