API integrace
Používejte AI modely od CoreSynth přímo ve svých oblíbených nástrojích — Claude Code, Cursor, VS Code, Windsurf, OpenCode a dalších. Naše API je plně kompatibilní s OpenAI i Anthropic formátem, takže funguje s jakýmkoliv klientem, který tyto protokoly podporuje.
Jak to funguje
CoreSynth provozuje AI API Proxy — jednotný endpoint, který překládá vaše požadavky do nativních formátů jednotlivých AI poskytovatelů (OpenAI, Anthropic, Google). Výsledkem je jedna URL a jeden API klíč pro přístup ke všem modelům.
Váš nástroj (Cursor, Claude Code, ...)
│
▼
https://coresynth.io/v1/ ← CoreSynth API Proxy
│
├─► Claude Sonnet / Opus (Anthropic)
├─► GPT-4o / o3 (OpenAI)
└─► Gemini 2.5 Pro (Google)Klíčové vlastnosti
| Vlastnost | Popis |
|---|---|
| OpenAI kompatibilní | POST /v1/chat/completions — funguje s jakýmkoliv OpenAI klientem |
| Anthropic kompatibilní | POST /v1/messages — nativní podpora Anthropic SDK |
| Streaming | Podpora SSE streaming pro oba formáty |
| Modely | Claude, GPT, Gemini a další — jeden klíč pro všechny |
| Rate limity | Flexibilní limity dle vašeho balíčku |
| Bezpečnost | Bearer token autentifikace, HTTPS, AES-256 šifrování klíčů |
Předpoklady
Než začnete, potřebujete:
- Aktivní Alex Code službu na coresynth.io
- API klíč ve formátu
cs-xxxxxxxxxxxxxxxxxxxxxxxx— vygenerujete v panelu - Nainstalovaný AI nástroj (Claude Code, Cursor, atd.)
:::tip[API klíč nemáte?] Přejděte na API klíče a vygenerujte si ho. Trvá to 30 sekund. :::
Endpointy
| Endpoint | Formát | Popis |
|---|---|---|
https://coresynth.io/v1/chat/completions | OpenAI | Chat completions (standard) |
https://coresynth.io/v1/messages | Anthropic | Messages API (nativní) |
https://coresynth.io/v1/models | OpenAI | Seznam dostupných modelů |
https://coresynth.io/v1/health | — | Stav API (veřejný) |
Autentifikace
Všechny požadavky vyžadují API klíč. Podporujeme dva způsoby:
# OpenAI styl (Bearer token)
Authorization: Bearer cs-your-key-here
# Anthropic styl (x-api-key hlavička)
x-api-key: cs-your-key-hereClaude Code
Claude Code je terminálový AI asistent od Anthropic. S CoreSynth API ho můžete používat s jakýmkoliv modelem.
Nastavení
Claude Code podporuje vlastní OpenAI-kompatibilní endpointy přes konfigurační soubor:
# Nastavte proměnné prostředí v ~/.bashrc nebo ~/.zshrc
export ANTHROPIC_API_KEY="cs-your-key-here"
export ANTHROPIC_BASE_URL="https://coresynth.io/v1"Nebo použijte konfigurační soubor .claude/settings.json:
{
"env": {
"ANTHROPIC_API_KEY": "cs-your-key-here",
"ANTHROPIC_BASE_URL": "https://coresynth.io/v1"
}
}Použití
# Spuštění Claude Code
claude
# S konkrétním modelem
claude --model claude-sonnet-4-20250514Co získáte
- AI pair programming přímo v terminálu
- Čtení a editace souborů na vašem serveru přes SSH
- Spouštění příkazů s AI asistencí
- Komplexní refaktoring a debugging
- Všechny AI modely — ne jen Claude, ale i GPT-4o, Gemini a další
Cursor
Cursor je IDE s integrovanou AI, založené na VS Code. Podporuje vlastní OpenAI endpointy.
Nastavení
- Otevřete Settings (
Ctrl+,/Cmd+,) - Vyhledejte “Models” nebo “OpenAI API Key”
- Nastavte:
| Pole | Hodnota |
|---|---|
| OpenAI API Key | cs-your-key-here |
| OpenAI Base URL | https://coresynth.io/v1 |
Případně upravte ~/.cursor/settings.json:
{
"cursor.general.openaiApiKey": "cs-your-key-here",
"cursor.general.openaiBaseUrl": "https://coresynth.io/v1"
}Použití modelů
V Cursoru můžete v Chat panelu vybrat ze všech dostupných modelů:
claude-sonnet-4-20250514— rychlý, levnýclaude-opus-4-20250514— nejinteligentnějšígpt-4o— univerzálnígemini-2.5-pro— dlouhý kontext
Výhody
- Tab completion s AI predikcí
- Chat s kontextem kódu — AI vidí celý projekt
- Inline editace — AI upravuje kód přímo v editoru
- Composer — generuje celé funkce z popisu
OpenCode
OpenCode je open-source AI coding asistent pro terminál.
Nastavení
Vytvořte nebo upravte ~/.opencode/config.json:
{
"provider": {
"name": "openai",
"apiKey": "cs-your-key-here",
"baseURL": "https://coresynth.io/v1"
},
"model": {
"name": "claude-sonnet-4-20250514"
}
}Použití
# Spuštění
opencode
# V chatu můžete přepínat modely
/model gpt-4o
/model claude-opus-4-20250514VS Code + Continue.dev
Continue je open-source AI asistent pro VS Code a JetBrains.
Nastavení
V souboru ~/.continue/config.json:
{
"models": [
{
"title": "CoreSynth Claude Sonnet",
"provider": "openai",
"model": "claude-sonnet-4-20250514",
"apiKey": "cs-your-key-here",
"apiBase": "https://coresynth.io/v1"
},
{
"title": "CoreSynth GPT-4o",
"provider": "openai",
"model": "gpt-4o",
"apiKey": "cs-your-key-here",
"apiBase": "https://coresynth.io/v1"
}
],
"tabAutocompleteModel": {
"title": "CoreSynth Autocomplete",
"provider": "openai",
"model": "claude-sonnet-4-20250514",
"apiKey": "cs-your-key-here",
"apiBase": "https://coresynth.io/v1"
}
}Windsurf (Codeium)
Windsurf je AI IDE od Codeium.
Nastavení
- Otevřete Settings → AI Providers
- Přidejte vlastní OpenAI kompatibilní provider:
| Pole | Hodnota |
|---|---|
| Provider Name | CoreSynth |
| API Key | cs-your-key-here |
| Base URL | https://coresynth.io/v1 |
Nebo v ~/.windsurf/settings.json:
{
"aiProviders": {
"coresynth": {
"apiKey": "cs-your-key-here",
"baseUrl": "https://coresynth.io/v1"
}
}
}JetBrains AI Assistant
JetBrains IDE (IntelliJ, PhpStorm, PyCharm, WebStorm, …) podporují vlastní AI providery.
Nastavení
- Otevřete Settings → Tools → AI Assistant
- Povolte Custom AI Provider
- Nastavte:
| Pole | Hodnota |
|---|---|
| API URL | https://coresynth.io/v1/chat/completions |
| API Key | cs-your-key-here |
| Model | claude-sonnet-4-20250514 |
Přímé API volání
Pokud používáte vlastní aplikaci nebo skript, můžete volat API přímo.
OpenAI formát
curl -X POST https://coresynth.io/v1/chat/completions \
-H "Authorization: Bearer cs-your-key-here" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-20250514",
"messages": [
{"role": "user", "content": "Ahoj, jak se máš?"}
],
"stream": true
}'Anthropic formát
curl -X POST https://coresynth.io/v1/messages \
-H "x-api-key: cs-your-key-here" \
-H "Content-Type: application/json" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-20250514",
"max_tokens": 4096,
"messages": [
{"role": "user", "content": "Ahoj, jak se máš?"}
],
"stream": true
}'Python (OpenAI SDK)
from openai import OpenAI
client = OpenAI(
api_key="cs-your-key-here",
base_url="https://coresynth.io/v1"
)
response = client.chat.completions.create(
model="claude-sonnet-4-20250514",
messages=[
{"role": "user", "content": "Napiš mi Python skript na zálohování."}
],
stream=True
)
for chunk in response:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")Python (Anthropic SDK)
from anthropic import Anthropic
client = Anthropic(
api_key="cs-your-key-here",
base_url="https://coresynth.io/v1"
)
message = client.messages.create(
model="claude-sonnet-4-20250514",
max_tokens=4096,
messages=[
{"role": "user", "content": "Napiš mi Python skript na zálohování."}
]
)
print(message.content[0].text)Node.js
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'cs-your-key-here',
baseURL: 'https://coresynth.io/v1',
});
const stream = await client.chat.completions.create({
model: 'claude-sonnet-4-20250514',
messages: [{ role: 'user', content: 'Napiš mi Express.js server.' }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content || '');
}PHP
<?php
$apiKey = 'cs-your-key-here';
$url = 'https://coresynth.io/v1/chat/completions';
$data = [
'model' => 'claude-sonnet-4-20250514',
'messages' => [
['role' => 'user', 'content' => 'Napiš mi PHP skript na odeslání emailu.']
],
'stream' => false,
];
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode($data),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 120,
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
echo $result['choices'][0]['message']['content'];Seznam modelů
Aktuální seznam modelů získáte přes API:
curl -H "Authorization: Bearer cs-your-key-here" \
https://coresynth.io/v1/modelsNebo se podívejte na přehled v Modely a limity.
Rate limity
| Parametr | Výchozí |
|---|---|
| Požadavky za minutu | 60 RPM |
| Maximální tokeny | 128 000 |
| Timeout | 300 sekund |
| Max API klíčů | 5 na službu |
Při překročení limitu API vrátí 429 Too Many Requests s hlavičkami:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1712505600Kódy chyb
| Kód | HTTP | Popis |
|---|---|---|
authentication_error | 401 | Neplatný nebo chybějící API klíč |
permission_error | 403 | Nedostatečná oprávnění (model vyžaduje Premium) |
invalid_request_error | 400 | Neplatný formát požadavku |
not_found_error | 404 | Model nenalezen nebo deaktivován |
insufficient_quota | 429 | Vyčerpaný limit požadavků |
upstream_error | 502 | Chyba upstream poskytovatele |
server_error | 500 | Interní chyba serveru |
Srovnání nástrojů
| Nástroj | Typ | OpenAI kompat. | Anthropic kompat. | Streaming | Autocomplete |
|---|---|---|---|---|---|
| Claude Code | Terminál | Ano | Ano | Ano | — |
| Cursor | IDE | Ano | — | Ano | Ano |
| OpenCode | Terminál | Ano | — | Ano | — |
| VS Code + Continue | IDE | Ano | — | Ano | Ano |
| Windsurf | IDE | Ano | — | Ano | Ano |
| JetBrains | IDE | Ano | — | Ano | Ano |
| Vlastní aplikace | — | Ano | Ano | Ano | — |
FAQ
Funguje to se všemi modely?
Ano. Všechny modely, které máte povolené na vašem API klíči, jsou dostupné přes oba endpointy (OpenAI i Anthropic formát). Některé modely vyžadují aktivní Premium předplatné.
Mohu použít streaming?
Ano, oba endpointy podporují SSE streaming. Nastavte "stream": true v požadavku.
Jaké knihovny mohu použít?
Jakoukoliv knihovnu kompatibilní s OpenAI nebo Anthropic API:
- Python:
openai,anthropic - Node.js:
openai,@anthropic-ai/sdk - PHP:
openai-php/client - Go:
sashabaranov/go-openai - Ruby:
ruby-openai
Je API klíč bezpečný?
Klíče jsou šifrovány AES-256-CBC, přenos je přes HTTPS. Nikdy neukládejte klíč do kódu — používejte proměnné prostředí.
Další kroky
- API klíče — Generování a správa klíčů
- Alex Code — Samostatná AI služba
- Modely a limity — Přehled dostupných modelů
Potřebujete pomoc? Otevřete support ticket .