Spaces:
Paused
Paused
Commit ·
d48698a
1
Parent(s): 0d6fc69
Add Koyeb deployment configuration and update API documentation URLs
Browse files- API_DOCUMENTATION.md +49 -49
- koyeb.yaml +29 -0
API_DOCUMENTATION.md
CHANGED
|
@@ -7,13 +7,13 @@
|
|
| 7 |
## 🌐 API Endpoint
|
| 8 |
|
| 9 |
```
|
| 10 |
-
https://
|
| 11 |
```
|
| 12 |
## API Key
|
| 13 |
```
|
| 14 |
sk-cItvhSBsi7KWnTDZqfFX5gzuVURodOL8pPj1CbyJreAk3HYG
|
| 15 |
```
|
| 16 |
-
✅ **This is a permanent URL** - Your API is deployed to
|
| 17 |
|
| 18 |
**Local Endpoint (for development):**
|
| 19 |
```
|
|
@@ -53,7 +53,7 @@ Returns a list of all available models.
|
|
| 53 |
|
| 54 |
**Example:**
|
| 55 |
```bash
|
| 56 |
-
curl https://
|
| 57 |
-H "Authorization: Bearer test-api-key-1"
|
| 58 |
```
|
| 59 |
|
|
@@ -120,7 +120,7 @@ Create a chat completion with any available model.
|
|
| 120 |
The flagship Gemini 2.5 Pro model with advanced reasoning capabilities.
|
| 121 |
|
| 122 |
```bash
|
| 123 |
-
curl https://
|
| 124 |
-H "Authorization: Bearer test-api-key-1" \
|
| 125 |
-H "Content-Type: application/json" \
|
| 126 |
-d '{
|
|
@@ -135,7 +135,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 135 |
import requests
|
| 136 |
|
| 137 |
response = requests.post(
|
| 138 |
-
"https://
|
| 139 |
headers={
|
| 140 |
"Authorization": "Bearer test-api-key-1",
|
| 141 |
"Content-Type": "application/json"
|
|
@@ -159,7 +159,7 @@ print(response.json())
|
|
| 159 |
Fast and efficient Gemini 2.5 Flash model.
|
| 160 |
|
| 161 |
```bash
|
| 162 |
-
curl https://
|
| 163 |
-H "Authorization: Bearer test-api-key-1" \
|
| 164 |
-H "Content-Type: application/json" \
|
| 165 |
-d '{
|
|
@@ -177,7 +177,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 177 |
Lightweight version of Gemini 2.5 Flash for cost-effective usage.
|
| 178 |
|
| 179 |
```bash
|
| 180 |
-
curl https://
|
| 181 |
-H "Authorization: Bearer test-api-key-1" \
|
| 182 |
-H "Content-Type: application/json" \
|
| 183 |
-d '{
|
|
@@ -195,7 +195,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 195 |
Gemini model with computer use capabilities for automation tasks.
|
| 196 |
|
| 197 |
```bash
|
| 198 |
-
curl https://
|
| 199 |
-H "Authorization: Bearer test-api-key-1" \
|
| 200 |
-H "Content-Type: application/json" \
|
| 201 |
-d '{
|
|
@@ -215,7 +215,7 @@ Preview of the next-generation Gemini 3 Pro model with advanced reasoning capabi
|
|
| 215 |
**Default Reasoning Level:** `high` (valid options: `low`, `high`)
|
| 216 |
|
| 217 |
```bash
|
| 218 |
-
curl https://
|
| 219 |
-H "Authorization: Bearer test-api-key-1" \
|
| 220 |
-H "Content-Type: application/json" \
|
| 221 |
-d '{
|
|
@@ -235,7 +235,7 @@ Preview of the next-generation Gemini 3 Flash model with fast reasoning capabili
|
|
| 235 |
**Default Reasoning Level:** `high` (valid options: `minimal`, `low`, `medium`, `high`)
|
| 236 |
|
| 237 |
```bash
|
| 238 |
-
curl https://
|
| 239 |
-H "Authorization: Bearer test-api-key-1" \
|
| 240 |
-H "Content-Type: application/json" \
|
| 241 |
-d '{
|
|
@@ -255,7 +255,7 @@ Gemini 3 Pro with image generation and understanding capabilities.
|
|
| 255 |
**Default Reasoning Level:** `high` (valid options: `low`, `high`)
|
| 256 |
|
| 257 |
```bash
|
| 258 |
-
curl https://
|
| 259 |
-H "Authorization: Bearer test-api-key-1" \
|
| 260 |
-H "Content-Type: application/json" \
|
| 261 |
-d '{
|
|
@@ -273,7 +273,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 273 |
Hybrid model combining Gemini and Claude Sonnet 4.5 capabilities.
|
| 274 |
|
| 275 |
```bash
|
| 276 |
-
curl https://
|
| 277 |
-H "Authorization: Bearer test-api-key-1" \
|
| 278 |
-H "Content-Type: application/json" \
|
| 279 |
-d '{
|
|
@@ -291,7 +291,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 291 |
Hybrid model with extended thinking/reasoning capabilities.
|
| 292 |
|
| 293 |
```bash
|
| 294 |
-
curl https://
|
| 295 |
-H "Authorization: Bearer test-api-key-1" \
|
| 296 |
-H "Content-Type: application/json" \
|
| 297 |
-d '{
|
|
@@ -309,7 +309,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 309 |
Premium hybrid model with Opus-level reasoning capabilities.
|
| 310 |
|
| 311 |
```bash
|
| 312 |
-
curl https://
|
| 313 |
-H "Authorization: Bearer test-api-key-1" \
|
| 314 |
-H "Content-Type: application/json" \
|
| 315 |
-d '{
|
|
@@ -327,7 +327,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 327 |
120 billion parameter open-source style model.
|
| 328 |
|
| 329 |
```bash
|
| 330 |
-
curl https://
|
| 331 |
-H "Authorization: Bearer test-api-key-1" \
|
| 332 |
-H "Content-Type: application/json" \
|
| 333 |
-d '{
|
|
@@ -347,7 +347,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 347 |
Qwen 3 32B parameter model for general chat.
|
| 348 |
|
| 349 |
```bash
|
| 350 |
-
curl https://
|
| 351 |
-H "Authorization: Bearer test-api-key-1" \
|
| 352 |
-H "Content-Type: application/json" \
|
| 353 |
-d '{
|
|
@@ -365,7 +365,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 365 |
Qwen 3 235B parameter flagship model.
|
| 366 |
|
| 367 |
```bash
|
| 368 |
-
curl https://
|
| 369 |
-H "Authorization: Bearer test-api-key-1" \
|
| 370 |
-H "Content-Type: application/json" \
|
| 371 |
-d '{
|
|
@@ -383,7 +383,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 383 |
Qwen 3 235B with instruction tuning for better task following.
|
| 384 |
|
| 385 |
```bash
|
| 386 |
-
curl https://
|
| 387 |
-H "Authorization: Bearer test-api-key-1" \
|
| 388 |
-H "Content-Type: application/json" \
|
| 389 |
-d '{
|
|
@@ -404,7 +404,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 404 |
Qwen 3 235B with enhanced thinking/reasoning capabilities.
|
| 405 |
|
| 406 |
```bash
|
| 407 |
-
curl https://
|
| 408 |
-H "Authorization: Bearer test-api-key-1" \
|
| 409 |
-H "Content-Type: application/json" \
|
| 410 |
-d '{
|
|
@@ -422,7 +422,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 422 |
Qwen 3 Max - highest performance configuration.
|
| 423 |
|
| 424 |
```bash
|
| 425 |
-
curl https://
|
| 426 |
-H "Authorization: Bearer test-api-key-1" \
|
| 427 |
-H "Content-Type: application/json" \
|
| 428 |
-d '{
|
|
@@ -440,7 +440,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 440 |
Preview version of Qwen 3 Max with latest features.
|
| 441 |
|
| 442 |
```bash
|
| 443 |
-
curl https://
|
| 444 |
-H "Authorization: Bearer test-api-key-1" \
|
| 445 |
-H "Content-Type: application/json" \
|
| 446 |
-d '{
|
|
@@ -458,7 +458,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 458 |
Qwen 3 Vision-Language model for multimodal tasks.
|
| 459 |
|
| 460 |
```bash
|
| 461 |
-
curl https://
|
| 462 |
-H "Authorization: Bearer test-api-key-1" \
|
| 463 |
-H "Content-Type: application/json" \
|
| 464 |
-d '{
|
|
@@ -476,7 +476,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 476 |
Specialized coding model for advanced programming tasks.
|
| 477 |
|
| 478 |
```bash
|
| 479 |
-
curl https://
|
| 480 |
-H "Authorization: Bearer test-api-key-1" \
|
| 481 |
-H "Content-Type: application/json" \
|
| 482 |
-d '{
|
|
@@ -497,7 +497,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 497 |
Fast coding model for quick code generation tasks.
|
| 498 |
|
| 499 |
```bash
|
| 500 |
-
curl https://
|
| 501 |
-H "Authorization: Bearer test-api-key-1" \
|
| 502 |
-H "Content-Type: application/json" \
|
| 503 |
-d '{
|
|
@@ -515,7 +515,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 515 |
Dedicated vision model for image understanding.
|
| 516 |
|
| 517 |
```bash
|
| 518 |
-
curl https://
|
| 519 |
-H "Authorization: Bearer test-api-key-1" \
|
| 520 |
-H "Content-Type: application/json" \
|
| 521 |
-d '{
|
|
@@ -535,7 +535,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 535 |
DeepSeek R1 reasoning model for complex problem solving.
|
| 536 |
|
| 537 |
```bash
|
| 538 |
-
curl https://
|
| 539 |
-H "Authorization: Bearer test-api-key-1" \
|
| 540 |
-H "Content-Type: application/json" \
|
| 541 |
-d '{
|
|
@@ -553,7 +553,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 553 |
DeepSeek V3 general chat model.
|
| 554 |
|
| 555 |
```bash
|
| 556 |
-
curl https://
|
| 557 |
-H "Authorization: Bearer test-api-key-1" \
|
| 558 |
-H "Content-Type: application/json" \
|
| 559 |
-d '{
|
|
@@ -571,7 +571,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 571 |
DeepSeek V3.1 with improved capabilities.
|
| 572 |
|
| 573 |
```bash
|
| 574 |
-
curl https://
|
| 575 |
-H "Authorization: Bearer test-api-key-1" \
|
| 576 |
-H "Content-Type: application/json" \
|
| 577 |
-d '{
|
|
@@ -589,7 +589,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 589 |
DeepSeek V3.2 latest version with enhanced performance.
|
| 590 |
|
| 591 |
```bash
|
| 592 |
-
curl https://
|
| 593 |
-H "Authorization: Bearer test-api-key-1" \
|
| 594 |
-H "Content-Type: application/json" \
|
| 595 |
-d '{
|
|
@@ -607,7 +607,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 607 |
DeepSeek V3.2 optimized for conversational interactions.
|
| 608 |
|
| 609 |
```bash
|
| 610 |
-
curl https://
|
| 611 |
-H "Authorization: Bearer test-api-key-1" \
|
| 612 |
-H "Content-Type: application/json" \
|
| 613 |
-d '{
|
|
@@ -629,7 +629,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 629 |
DeepSeek V3.2 with specialized reasoning capabilities.
|
| 630 |
|
| 631 |
```bash
|
| 632 |
-
curl https://
|
| 633 |
-H "Authorization: Bearer test-api-key-1" \
|
| 634 |
-H "Content-Type: application/json" \
|
| 635 |
-d '{
|
|
@@ -649,7 +649,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 649 |
Kimi K2 general purpose model.
|
| 650 |
|
| 651 |
```bash
|
| 652 |
-
curl https://
|
| 653 |
-H "Authorization: Bearer test-api-key-1" \
|
| 654 |
-H "Content-Type: application/json" \
|
| 655 |
-d '{
|
|
@@ -667,7 +667,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 667 |
Kimi K2 September 2025 update with improvements.
|
| 668 |
|
| 669 |
```bash
|
| 670 |
-
curl https://
|
| 671 |
-H "Authorization: Bearer test-api-key-1" \
|
| 672 |
-H "Content-Type: application/json" \
|
| 673 |
-d '{
|
|
@@ -685,7 +685,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 685 |
Kimi K2 with extended thinking capabilities.
|
| 686 |
|
| 687 |
```bash
|
| 688 |
-
curl https://
|
| 689 |
-H "Authorization: Bearer test-api-key-1" \
|
| 690 |
-H "Content-Type: application/json" \
|
| 691 |
-d '{
|
|
@@ -705,7 +705,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 705 |
MiniMax M2 efficient chat model.
|
| 706 |
|
| 707 |
```bash
|
| 708 |
-
curl https://
|
| 709 |
-H "Authorization: Bearer test-api-key-1" \
|
| 710 |
-H "Content-Type: application/json" \
|
| 711 |
-d '{
|
|
@@ -723,7 +723,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 723 |
MiniMax M2.1 with enhanced capabilities.
|
| 724 |
|
| 725 |
```bash
|
| 726 |
-
curl https://
|
| 727 |
-H "Authorization: Bearer test-api-key-1" \
|
| 728 |
-H "Content-Type: application/json" \
|
| 729 |
-d '{
|
|
@@ -743,7 +743,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 743 |
GLM 4.6 chat model from Zhipu AI.
|
| 744 |
|
| 745 |
```bash
|
| 746 |
-
curl https://
|
| 747 |
-H "Authorization: Bearer test-api-key-1" \
|
| 748 |
-H "Content-Type: application/json" \
|
| 749 |
-d '{
|
|
@@ -761,7 +761,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 761 |
GLM 4.7 latest version with improved performance.
|
| 762 |
|
| 763 |
```bash
|
| 764 |
-
curl https://
|
| 765 |
-H "Authorization: Bearer test-api-key-1" \
|
| 766 |
-H "Content-Type: application/json" \
|
| 767 |
-d '{
|
|
@@ -781,7 +781,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 781 |
TStars 2.0 specialized model.
|
| 782 |
|
| 783 |
```bash
|
| 784 |
-
curl https://
|
| 785 |
-H "Authorization: Bearer test-api-key-1" \
|
| 786 |
-H "Content-Type: application/json" \
|
| 787 |
-d '{
|
|
@@ -798,7 +798,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 798 |
Enable streaming for real-time token-by-token responses:
|
| 799 |
|
| 800 |
```bash
|
| 801 |
-
curl https://
|
| 802 |
-H "Authorization: Bearer test-api-key-1" \
|
| 803 |
-H "Content-Type: application/json" \
|
| 804 |
-d '{
|
|
@@ -814,7 +814,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 814 |
import requests
|
| 815 |
|
| 816 |
response = requests.post(
|
| 817 |
-
"https://
|
| 818 |
headers={
|
| 819 |
"Authorization": "Bearer test-api-key-1",
|
| 820 |
"Content-Type": "application/json"
|
|
@@ -842,7 +842,7 @@ import openai
|
|
| 842 |
# Configure the client
|
| 843 |
client = openai.OpenAI(
|
| 844 |
api_key="test-api-key-1",
|
| 845 |
-
base_url="https://
|
| 846 |
)
|
| 847 |
|
| 848 |
# Chat completion
|
|
@@ -866,7 +866,7 @@ import OpenAI from 'openai';
|
|
| 866 |
|
| 867 |
const client = new OpenAI({
|
| 868 |
apiKey: 'test-api-key-1',
|
| 869 |
-
baseURL: 'https://
|
| 870 |
});
|
| 871 |
|
| 872 |
async function main() {
|
|
@@ -890,7 +890,7 @@ main();
|
|
| 890 |
|
| 891 |
### Basic Chat
|
| 892 |
```bash
|
| 893 |
-
curl -X POST https://
|
| 894 |
-H "Authorization: Bearer test-api-key-1" \
|
| 895 |
-H "Content-Type: application/json" \
|
| 896 |
-d '{"model": "MODEL_NAME", "messages": [{"role": "user", "content": "YOUR_MESSAGE"}]}'
|
|
@@ -898,7 +898,7 @@ curl -X POST https://creative-magic-production-22f0.up.railway.app/v1/chat/compl
|
|
| 898 |
|
| 899 |
### With System Prompt
|
| 900 |
```bash
|
| 901 |
-
curl -X POST https://
|
| 902 |
-H "Authorization: Bearer test-api-key-1" \
|
| 903 |
-H "Content-Type: application/json" \
|
| 904 |
-d '{
|
|
@@ -912,7 +912,7 @@ curl -X POST https://creative-magic-production-22f0.up.railway.app/v1/chat/compl
|
|
| 912 |
|
| 913 |
### With Temperature Control
|
| 914 |
```bash
|
| 915 |
-
curl -X POST https://
|
| 916 |
-H "Authorization: Bearer test-api-key-1" \
|
| 917 |
-H "Content-Type: application/json" \
|
| 918 |
-d '{
|
|
@@ -995,13 +995,13 @@ curl -X POST https://creative-magic-production-22f0.up.railway.app/v1/chat/compl
|
|
| 995 |
|
| 996 |
1. **Test the connection:**
|
| 997 |
```bash
|
| 998 |
-
curl https://
|
| 999 |
-H "Authorization: Bearer test-api-key-1"
|
| 1000 |
```
|
| 1001 |
|
| 1002 |
2. **Make your first chat:**
|
| 1003 |
```bash
|
| 1004 |
-
curl https://
|
| 1005 |
-H "Authorization: Bearer test-api-key-1" \
|
| 1006 |
-H "Content-Type: application/json" \
|
| 1007 |
-d '{"model": "gemini-2.5-flash", "messages": [{"role": "user", "content": "Hello!"}]}'
|
|
@@ -1009,7 +1009,7 @@ curl https://creative-magic-production-22f0.up.railway.app/v1/chat/completions \
|
|
| 1009 |
|
| 1010 |
3. **Try a coding model:**
|
| 1011 |
```bash
|
| 1012 |
-
curl https://
|
| 1013 |
-H "Authorization: Bearer test-api-key-1" \
|
| 1014 |
-H "Content-Type: application/json" \
|
| 1015 |
-d '{"model": "qwen3-coder-plus", "messages": [{"role": "user", "content": "Write hello world in 5 languages"}]}'
|
|
|
|
| 7 |
## 🌐 API Endpoint
|
| 8 |
|
| 9 |
```
|
| 10 |
+
https://cliproxy-api-YOUR_ORG.koyeb.app/v1
|
| 11 |
```
|
| 12 |
## API Key
|
| 13 |
```
|
| 14 |
sk-cItvhSBsi7KWnTDZqfFX5gzuVURodOL8pPj1CbyJreAk3HYG
|
| 15 |
```
|
| 16 |
+
✅ **This is a permanent URL** - Your API is deployed to Koyeb and runs 24/7!
|
| 17 |
|
| 18 |
**Local Endpoint (for development):**
|
| 19 |
```
|
|
|
|
| 53 |
|
| 54 |
**Example:**
|
| 55 |
```bash
|
| 56 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/models \
|
| 57 |
-H "Authorization: Bearer test-api-key-1"
|
| 58 |
```
|
| 59 |
|
|
|
|
| 120 |
The flagship Gemini 2.5 Pro model with advanced reasoning capabilities.
|
| 121 |
|
| 122 |
```bash
|
| 123 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 124 |
-H "Authorization: Bearer test-api-key-1" \
|
| 125 |
-H "Content-Type: application/json" \
|
| 126 |
-d '{
|
|
|
|
| 135 |
import requests
|
| 136 |
|
| 137 |
response = requests.post(
|
| 138 |
+
"https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions",
|
| 139 |
headers={
|
| 140 |
"Authorization": "Bearer test-api-key-1",
|
| 141 |
"Content-Type": "application/json"
|
|
|
|
| 159 |
Fast and efficient Gemini 2.5 Flash model.
|
| 160 |
|
| 161 |
```bash
|
| 162 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 163 |
-H "Authorization: Bearer test-api-key-1" \
|
| 164 |
-H "Content-Type: application/json" \
|
| 165 |
-d '{
|
|
|
|
| 177 |
Lightweight version of Gemini 2.5 Flash for cost-effective usage.
|
| 178 |
|
| 179 |
```bash
|
| 180 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 181 |
-H "Authorization: Bearer test-api-key-1" \
|
| 182 |
-H "Content-Type: application/json" \
|
| 183 |
-d '{
|
|
|
|
| 195 |
Gemini model with computer use capabilities for automation tasks.
|
| 196 |
|
| 197 |
```bash
|
| 198 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 199 |
-H "Authorization: Bearer test-api-key-1" \
|
| 200 |
-H "Content-Type: application/json" \
|
| 201 |
-d '{
|
|
|
|
| 215 |
**Default Reasoning Level:** `high` (valid options: `low`, `high`)
|
| 216 |
|
| 217 |
```bash
|
| 218 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 219 |
-H "Authorization: Bearer test-api-key-1" \
|
| 220 |
-H "Content-Type: application/json" \
|
| 221 |
-d '{
|
|
|
|
| 235 |
**Default Reasoning Level:** `high` (valid options: `minimal`, `low`, `medium`, `high`)
|
| 236 |
|
| 237 |
```bash
|
| 238 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 239 |
-H "Authorization: Bearer test-api-key-1" \
|
| 240 |
-H "Content-Type: application/json" \
|
| 241 |
-d '{
|
|
|
|
| 255 |
**Default Reasoning Level:** `high` (valid options: `low`, `high`)
|
| 256 |
|
| 257 |
```bash
|
| 258 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 259 |
-H "Authorization: Bearer test-api-key-1" \
|
| 260 |
-H "Content-Type: application/json" \
|
| 261 |
-d '{
|
|
|
|
| 273 |
Hybrid model combining Gemini and Claude Sonnet 4.5 capabilities.
|
| 274 |
|
| 275 |
```bash
|
| 276 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 277 |
-H "Authorization: Bearer test-api-key-1" \
|
| 278 |
-H "Content-Type: application/json" \
|
| 279 |
-d '{
|
|
|
|
| 291 |
Hybrid model with extended thinking/reasoning capabilities.
|
| 292 |
|
| 293 |
```bash
|
| 294 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 295 |
-H "Authorization: Bearer test-api-key-1" \
|
| 296 |
-H "Content-Type: application/json" \
|
| 297 |
-d '{
|
|
|
|
| 309 |
Premium hybrid model with Opus-level reasoning capabilities.
|
| 310 |
|
| 311 |
```bash
|
| 312 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 313 |
-H "Authorization: Bearer test-api-key-1" \
|
| 314 |
-H "Content-Type: application/json" \
|
| 315 |
-d '{
|
|
|
|
| 327 |
120 billion parameter open-source style model.
|
| 328 |
|
| 329 |
```bash
|
| 330 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 331 |
-H "Authorization: Bearer test-api-key-1" \
|
| 332 |
-H "Content-Type: application/json" \
|
| 333 |
-d '{
|
|
|
|
| 347 |
Qwen 3 32B parameter model for general chat.
|
| 348 |
|
| 349 |
```bash
|
| 350 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 351 |
-H "Authorization: Bearer test-api-key-1" \
|
| 352 |
-H "Content-Type: application/json" \
|
| 353 |
-d '{
|
|
|
|
| 365 |
Qwen 3 235B parameter flagship model.
|
| 366 |
|
| 367 |
```bash
|
| 368 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 369 |
-H "Authorization: Bearer test-api-key-1" \
|
| 370 |
-H "Content-Type: application/json" \
|
| 371 |
-d '{
|
|
|
|
| 383 |
Qwen 3 235B with instruction tuning for better task following.
|
| 384 |
|
| 385 |
```bash
|
| 386 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 387 |
-H "Authorization: Bearer test-api-key-1" \
|
| 388 |
-H "Content-Type: application/json" \
|
| 389 |
-d '{
|
|
|
|
| 404 |
Qwen 3 235B with enhanced thinking/reasoning capabilities.
|
| 405 |
|
| 406 |
```bash
|
| 407 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 408 |
-H "Authorization: Bearer test-api-key-1" \
|
| 409 |
-H "Content-Type: application/json" \
|
| 410 |
-d '{
|
|
|
|
| 422 |
Qwen 3 Max - highest performance configuration.
|
| 423 |
|
| 424 |
```bash
|
| 425 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 426 |
-H "Authorization: Bearer test-api-key-1" \
|
| 427 |
-H "Content-Type: application/json" \
|
| 428 |
-d '{
|
|
|
|
| 440 |
Preview version of Qwen 3 Max with latest features.
|
| 441 |
|
| 442 |
```bash
|
| 443 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 444 |
-H "Authorization: Bearer test-api-key-1" \
|
| 445 |
-H "Content-Type: application/json" \
|
| 446 |
-d '{
|
|
|
|
| 458 |
Qwen 3 Vision-Language model for multimodal tasks.
|
| 459 |
|
| 460 |
```bash
|
| 461 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 462 |
-H "Authorization: Bearer test-api-key-1" \
|
| 463 |
-H "Content-Type: application/json" \
|
| 464 |
-d '{
|
|
|
|
| 476 |
Specialized coding model for advanced programming tasks.
|
| 477 |
|
| 478 |
```bash
|
| 479 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 480 |
-H "Authorization: Bearer test-api-key-1" \
|
| 481 |
-H "Content-Type: application/json" \
|
| 482 |
-d '{
|
|
|
|
| 497 |
Fast coding model for quick code generation tasks.
|
| 498 |
|
| 499 |
```bash
|
| 500 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 501 |
-H "Authorization: Bearer test-api-key-1" \
|
| 502 |
-H "Content-Type: application/json" \
|
| 503 |
-d '{
|
|
|
|
| 515 |
Dedicated vision model for image understanding.
|
| 516 |
|
| 517 |
```bash
|
| 518 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 519 |
-H "Authorization: Bearer test-api-key-1" \
|
| 520 |
-H "Content-Type: application/json" \
|
| 521 |
-d '{
|
|
|
|
| 535 |
DeepSeek R1 reasoning model for complex problem solving.
|
| 536 |
|
| 537 |
```bash
|
| 538 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 539 |
-H "Authorization: Bearer test-api-key-1" \
|
| 540 |
-H "Content-Type: application/json" \
|
| 541 |
-d '{
|
|
|
|
| 553 |
DeepSeek V3 general chat model.
|
| 554 |
|
| 555 |
```bash
|
| 556 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 557 |
-H "Authorization: Bearer test-api-key-1" \
|
| 558 |
-H "Content-Type: application/json" \
|
| 559 |
-d '{
|
|
|
|
| 571 |
DeepSeek V3.1 with improved capabilities.
|
| 572 |
|
| 573 |
```bash
|
| 574 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 575 |
-H "Authorization: Bearer test-api-key-1" \
|
| 576 |
-H "Content-Type: application/json" \
|
| 577 |
-d '{
|
|
|
|
| 589 |
DeepSeek V3.2 latest version with enhanced performance.
|
| 590 |
|
| 591 |
```bash
|
| 592 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 593 |
-H "Authorization: Bearer test-api-key-1" \
|
| 594 |
-H "Content-Type: application/json" \
|
| 595 |
-d '{
|
|
|
|
| 607 |
DeepSeek V3.2 optimized for conversational interactions.
|
| 608 |
|
| 609 |
```bash
|
| 610 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 611 |
-H "Authorization: Bearer test-api-key-1" \
|
| 612 |
-H "Content-Type: application/json" \
|
| 613 |
-d '{
|
|
|
|
| 629 |
DeepSeek V3.2 with specialized reasoning capabilities.
|
| 630 |
|
| 631 |
```bash
|
| 632 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 633 |
-H "Authorization: Bearer test-api-key-1" \
|
| 634 |
-H "Content-Type: application/json" \
|
| 635 |
-d '{
|
|
|
|
| 649 |
Kimi K2 general purpose model.
|
| 650 |
|
| 651 |
```bash
|
| 652 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 653 |
-H "Authorization: Bearer test-api-key-1" \
|
| 654 |
-H "Content-Type: application/json" \
|
| 655 |
-d '{
|
|
|
|
| 667 |
Kimi K2 September 2025 update with improvements.
|
| 668 |
|
| 669 |
```bash
|
| 670 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 671 |
-H "Authorization: Bearer test-api-key-1" \
|
| 672 |
-H "Content-Type: application/json" \
|
| 673 |
-d '{
|
|
|
|
| 685 |
Kimi K2 with extended thinking capabilities.
|
| 686 |
|
| 687 |
```bash
|
| 688 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 689 |
-H "Authorization: Bearer test-api-key-1" \
|
| 690 |
-H "Content-Type: application/json" \
|
| 691 |
-d '{
|
|
|
|
| 705 |
MiniMax M2 efficient chat model.
|
| 706 |
|
| 707 |
```bash
|
| 708 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 709 |
-H "Authorization: Bearer test-api-key-1" \
|
| 710 |
-H "Content-Type: application/json" \
|
| 711 |
-d '{
|
|
|
|
| 723 |
MiniMax M2.1 with enhanced capabilities.
|
| 724 |
|
| 725 |
```bash
|
| 726 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 727 |
-H "Authorization: Bearer test-api-key-1" \
|
| 728 |
-H "Content-Type: application/json" \
|
| 729 |
-d '{
|
|
|
|
| 743 |
GLM 4.6 chat model from Zhipu AI.
|
| 744 |
|
| 745 |
```bash
|
| 746 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 747 |
-H "Authorization: Bearer test-api-key-1" \
|
| 748 |
-H "Content-Type: application/json" \
|
| 749 |
-d '{
|
|
|
|
| 761 |
GLM 4.7 latest version with improved performance.
|
| 762 |
|
| 763 |
```bash
|
| 764 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 765 |
-H "Authorization: Bearer test-api-key-1" \
|
| 766 |
-H "Content-Type: application/json" \
|
| 767 |
-d '{
|
|
|
|
| 781 |
TStars 2.0 specialized model.
|
| 782 |
|
| 783 |
```bash
|
| 784 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 785 |
-H "Authorization: Bearer test-api-key-1" \
|
| 786 |
-H "Content-Type: application/json" \
|
| 787 |
-d '{
|
|
|
|
| 798 |
Enable streaming for real-time token-by-token responses:
|
| 799 |
|
| 800 |
```bash
|
| 801 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 802 |
-H "Authorization: Bearer test-api-key-1" \
|
| 803 |
-H "Content-Type: application/json" \
|
| 804 |
-d '{
|
|
|
|
| 814 |
import requests
|
| 815 |
|
| 816 |
response = requests.post(
|
| 817 |
+
"https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions",
|
| 818 |
headers={
|
| 819 |
"Authorization": "Bearer test-api-key-1",
|
| 820 |
"Content-Type": "application/json"
|
|
|
|
| 842 |
# Configure the client
|
| 843 |
client = openai.OpenAI(
|
| 844 |
api_key="test-api-key-1",
|
| 845 |
+
base_url="https://cliproxy-api-YOUR_ORG.koyeb.app/v1"
|
| 846 |
)
|
| 847 |
|
| 848 |
# Chat completion
|
|
|
|
| 866 |
|
| 867 |
const client = new OpenAI({
|
| 868 |
apiKey: 'test-api-key-1',
|
| 869 |
+
baseURL: 'https://cliproxy-api-YOUR_ORG.koyeb.app/v1'
|
| 870 |
});
|
| 871 |
|
| 872 |
async function main() {
|
|
|
|
| 890 |
|
| 891 |
### Basic Chat
|
| 892 |
```bash
|
| 893 |
+
curl -X POST https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 894 |
-H "Authorization: Bearer test-api-key-1" \
|
| 895 |
-H "Content-Type: application/json" \
|
| 896 |
-d '{"model": "MODEL_NAME", "messages": [{"role": "user", "content": "YOUR_MESSAGE"}]}'
|
|
|
|
| 898 |
|
| 899 |
### With System Prompt
|
| 900 |
```bash
|
| 901 |
+
curl -X POST https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 902 |
-H "Authorization: Bearer test-api-key-1" \
|
| 903 |
-H "Content-Type: application/json" \
|
| 904 |
-d '{
|
|
|
|
| 912 |
|
| 913 |
### With Temperature Control
|
| 914 |
```bash
|
| 915 |
+
curl -X POST https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 916 |
-H "Authorization: Bearer test-api-key-1" \
|
| 917 |
-H "Content-Type: application/json" \
|
| 918 |
-d '{
|
|
|
|
| 995 |
|
| 996 |
1. **Test the connection:**
|
| 997 |
```bash
|
| 998 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/models \
|
| 999 |
-H "Authorization: Bearer test-api-key-1"
|
| 1000 |
```
|
| 1001 |
|
| 1002 |
2. **Make your first chat:**
|
| 1003 |
```bash
|
| 1004 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 1005 |
-H "Authorization: Bearer test-api-key-1" \
|
| 1006 |
-H "Content-Type: application/json" \
|
| 1007 |
-d '{"model": "gemini-2.5-flash", "messages": [{"role": "user", "content": "Hello!"}]}'
|
|
|
|
| 1009 |
|
| 1010 |
3. **Try a coding model:**
|
| 1011 |
```bash
|
| 1012 |
+
curl https://cliproxy-api-YOUR_ORG.koyeb.app/v1/chat/completions \
|
| 1013 |
-H "Authorization: Bearer test-api-key-1" \
|
| 1014 |
-H "Content-Type: application/json" \
|
| 1015 |
-d '{"model": "qwen3-coder-plus", "messages": [{"role": "user", "content": "Write hello world in 5 languages"}]}'
|
koyeb.yaml
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
name: cliproxy-api
|
| 2 |
+
type: web
|
| 3 |
+
definition:
|
| 4 |
+
docker:
|
| 5 |
+
dockerfile: Dockerfile
|
| 6 |
+
env:
|
| 7 |
+
- key: TZ
|
| 8 |
+
value: UTC
|
| 9 |
+
ports:
|
| 10 |
+
- port: 8317
|
| 11 |
+
protocol: http
|
| 12 |
+
routes:
|
| 13 |
+
- path: /
|
| 14 |
+
port: 8317
|
| 15 |
+
scaling:
|
| 16 |
+
min: 1
|
| 17 |
+
max: 1
|
| 18 |
+
instance_types:
|
| 19 |
+
- type: nano
|
| 20 |
+
regions:
|
| 21 |
+
- fra
|
| 22 |
+
health_checks:
|
| 23 |
+
- type: http
|
| 24 |
+
path: /v1/models
|
| 25 |
+
port: 8317
|
| 26 |
+
interval: 30
|
| 27 |
+
timeout: 10
|
| 28 |
+
healthy_threshold: 2
|
| 29 |
+
unhealthy_threshold: 3
|