Průvodci
Protokoly a SDK
Používejte protokoly OpenAI-compatible, Responses a Anthropic Messages včetně streamování, volání nástrojů a migrace.
Model API mluví třemi síťovými protokoly. Zachovejte své stávající SDK a změňte základní URL, API klíč a ID modelu.
Matice koncových bodů
| Protokol | Konečný bod | Typický klient |
|---|---|---|
| OpenAI Chat Completions | POST https://openapi.felo.ai/api/v1/chat/completions | OpenAI SDK, většina nástrojů kompatibilních s OpenAI |
| OpenAI Responses | POST https://openapi.felo.ai/api/v1/responses | OpenAI SDK s funkcemi Responses API |
| Anthropic Messages | POST https://openapi.felo.ai/api/v1/messages | Anthropic SDK, Claude Code, nativní nástroje Claude |
Základní URL
| Klient | Základní URL | Proč |
|---|---|---|
| OpenAI SDK | https://openapi.felo.ai/api/v1 | SDK přidá /chat/completions nebo /responses |
| Anthropic SDK | https://openapi.felo.ai/api | SDK přidá /v1/messages; nepřidávejte /v1 sami |
Oba klienti používají váš Felo API klíč jako API klíč SDK.
import OpenAI from "openai";
import Anthropic from "@anthropic-ai/sdk";
const openai = new OpenAI({
apiKey: process.env.FELO_API_KEY,
baseURL: "https://openapi.felo.ai/api/v1",
});
const anthropic = new Anthropic({
apiKey: process.env.FELO_API_KEY,
baseURL: "https://openapi.felo.ai/api",
});Zvolte protokol
- Použijte Chat Completions, když váš nástroj nebo SDK očekává známé pole
messagesachoices[0].message.content. - Použijte Responses, když potřebujete objekt Responses od OpenAI,
input,instructionsnebooutput_text. - Použijte Messages, když používáte Anthropic SDK nebo nativní nástroj Claude.
Zkontrolujte model, než budete předpokládat, že každý protokol funguje. Katalog vystavuje supported_protocols, supported_parameters a recommended_protocol. recommended_protocol je doporučení klienta, nikoli omezení; model může stále přijímat jiný protokol.
Streamování
Nastavte stream: true pro příjem Server-Sent Events.
- Chat Completions vysílá chat chunk stylu OpenAI.
- Responses vysílá události Responses SSE a končí dokončeným objektem odpovědi.
- Messages vysílá stream události zpráv Anthropic.
Čtěte datový tok událostí průběžně a před uzavřením spojení zpracujte koncovou událost. Ztracené spojení není totéž co dokončená odpověď.
Volání nástrojů a strukturovaný výstup
Předávejte tools v nativní podobě daného protokolu. Podpora se liší podle modelu, proto před spoléháním na volání nástrojů, režim JSON nebo strukturovaný výstup zkontrolujte v katalogu supported_parameters. Model může pole přijmout a přitom ignorovat nepodporovanou možnost.
Nahrání souborů modelu
Nahrajte soubor jednou pomocí POST https://openapi.felo.ai/api/v1/files a pak na vrácené ID felo_file_ odkazujte v požadavcích Messages nebo Responses. Chat Completions ID souborů nepřijímá.
curl "https://openapi.felo.ai/api/v1/files" \
-H "Authorization: Bearer ${FELO_API_KEY}" \
-F "file=@./report.pdf"Tělo požadavku je multipart/form-data s právě jednou částí file. Multipart boundary nechte vygenerovat klienta a nepřidávejte další části, například purpose. Bloky obsahu, limity, podporu modelů a chybové kódy najdete v části Nahrávání souborů.
Chcete-li uložit materiál jako znalostní zdroj LiveDoc, použijte API pro nahrávání LiveDoc. Nahrávání souborů modelu a nahrávání prostředků LiveDoc mají vlastní identifikátory a navazující workflow.
Směrování kanálů
Všechny tři koncové body přijímají X-Felo-Channel, pokud potřebujete připnout poskytovatele. Viz Proč má stejný model různé ceny? pro pravidla hlaviček a příklady.
Migrace z oficiálního API
- Změňte základní URL na odpovídající Felo URL.
- Nahraďte API klíč za
FELO_API_KEY. - Nahraďte název modelu veřejným ID modelu Felo.
- Zachovejte zbytek tvaru požadavku.
| Příznak | Pravděpodobná příčina |
|---|---|
| 404 u každého požadavku | Základní URL už obsahuje /v1, nebo byla základní URL Anthropic ručně doplněna o /v1 |
| 401 | Felo klíč chybí nebo klient stále posílá starý klíč |
400 chyba model | ID modelu není veřejné nebo nepodporuje zvolený koncový bod |
| Požadavek Messages odmítnut | Protokol Messages vyžaduje max_tokens |
| Volání nástroje ignorováno | Model neoznamuje tuto schopnost |
Související
Potřebujete pomoc?
- S dotazy k API, fakturaci a účtu se obraťte na podporu.
- Popovídejte si s vývojáři Felo na Discord.
- Podívejte se na náš seznam změn.
- Potřebujete objemové ceny nebo pomoc s nákupem? Kontaktovat obchod.
- Vyvíjíte s LLM? Přečtěte si llms.txt.