Felo API PlatformFelo API Platform

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ů

ProtokolKonečný bodTypický klient
OpenAI Chat CompletionsPOST https://openapi.felo.ai/api/v1/chat/completionsOpenAI SDK, většina nástrojů kompatibilních s OpenAI
OpenAI ResponsesPOST https://openapi.felo.ai/api/v1/responsesOpenAI SDK s funkcemi Responses API
Anthropic MessagesPOST https://openapi.felo.ai/api/v1/messagesAnthropic SDK, Claude Code, nativní nástroje Claude

Základní URL

KlientZákladní URLProč
OpenAI SDKhttps://openapi.felo.ai/api/v1SDK přidá /chat/completions nebo /responses
Anthropic SDKhttps://openapi.felo.ai/apiSDK 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 messages a choices[0].message.content.
  • Použijte Responses, když potřebujete objekt Responses od OpenAI, input, instructions nebo output_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

  1. Změňte základní URL na odpovídající Felo URL.
  2. Nahraďte API klíč za FELO_API_KEY.
  3. Nahraďte název modelu veřejným ID modelu Felo.
  4. Zachovejte zbytek tvaru požadavku.
PříznakPravděpodobná příčina
404 u každého požadavkuZákladní URL už obsahuje /v1, nebo byla základní URL Anthropic ručně doplněna o /v1
401Felo klíč chybí nebo klient stále posílá starý klíč
400 chyba modelID modelu není veřejné nebo nepodporuje zvolený koncový bod
Požadavek Messages odmítnutProtokol Messages vyžaduje max_tokens
Volání nástroje ignorovánoModel neoznamuje tuto schopnost

Související

Potřebujete pomoc?