Node / TypeScript SDK

@anthropic-ai/sdk ist der empfohlene Client. Auch das offizielle OpenAI-Paket funktioniert mit überschriebener baseURL.

Installation

npm i @anthropic-ai/sdk
# or
npm i openai
# pnpm / yarn / bun all work too:
# pnpm add @anthropic-ai/sdk
# bun add @anthropic-ai/sdk

TypeScript

import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: process.env.ONEPROVIDER_KEY!,
baseURL: "https://api.oneprovider.dev",
});
const msg = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Say hi." }],
});
if (msg.content[0].type === "text") {
console.log(msg.content[0].text);
}

OpenAI-kompatibel

import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.ONEPROVIDER_KEY!,
baseURL: "https://api.oneprovider.dev/v1",
});
const resp = await client.chat.completions.create({
model: "claude-sonnet-5-5",
messages: [{ role: "user", content: "Say hi." }],
});
console.log(resp.choices[0].message.content);

Streaming per Async-Iterator

const stream = client.messages.stream({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "stream me a poem" }],
});
for await (const event of stream) {
if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
process.stdout.write(event.delta.text);
}
}

Edge-Runtimes

Funktioniert in Vercel Edge und Cloudflare Workers ohne Zusatzaufwand. Das SDK nutzt das native fetch, das in beiden Runtimes verfügbar ist.

// Cloudflare Worker
export default {
async fetch(req: Request, env: Env) {
const client = new Anthropic({ apiKey: env.ONEPROVIDER_KEY, baseURL: "https://api.oneprovider.dev" });
const msg = await client.messages.create({
model: "claude-haiku-5-5",
max_tokens: 256,
messages: [{ role: "user", content: "ping" }],
});
return Response.json(msg);
},
};

Welches Modell wählen

Übergeben Sie die ID in model. claude-sonnet-5-5 ist der Standard für die meisten Anwendungen, claude-haiku-5-5 für schnelle Aufrufe mit hohem Volumen und claude-opus-5-5 für anspruchsvolles Schlussfolgern. Mit dem Paket openai können Sie auch GPT-IDs wie gpt-6.1-terra nutzen. Das Anthropic-SDK erhält baseURL: "https://api.oneprovider.dev", das OpenAI-SDK baseURL: "https://api.oneprovider.dev/v1". IDs stehen auf der Modellseite .

Häufige Fehler und Lösungen

404 NotFoundError

Anthropic-SDK: baseURL: "https://api.oneprovider.dev" ohne /v1. OpenAI-SDK: baseURL: "https://api.oneprovider.dev/v1" mit /v1.

401 AuthenticationError

process.env.ONEPROVIDER_KEY ist in diesem Prozess nicht definiert, zum Beispiel weil das Laden der .env fehlt. Protokollieren Sie die Länge, nie den Wert.

429 RateLimitError

„Insufficient balance“ bedeutet: Konto aufladen (nicht erneut versuchen). Jedes andere 429 ist ein Rate-Limit: Warten Sie ab und beachten Sie Retry-After.

Fetch failed oder Timeout

Deaktivieren Sie VPN oder Proxy-Einstellungen; nutzen Sie bei langen Antworten stream, denn eine Anfrage ohne Streaming muss innerhalb von 6 Minuten beginnen.

400 zu max_tokens

Das Anthropic-SDK verlangt max_tokens in jeder Anfrage.

FAQ

Läuft es in Edge-Runtimes?

Ja, Vercel Edge und Cloudflare Workers funktionieren, weil das SDK fetch nutzt.

Ist der Aufruf aus dem Browser sicher?

Nein. Der Schlüssel erlaubt Ausgaben; rufen Sie von Ihrem Backend aus auf.

Kann ich die offiziellen SDKs behalten?

Ja, nur Schlüssel und baseURL ändern sich, siehe Von Anthropic migrieren .

Kurze Antworten

Welche base URL verwende ich?

Claude Code und die Anthropic-SDKs verwenden https://api.oneprovider.dev. OpenAI-SDKs und OpenAI-kompatible Clients verwenden https://api.oneprovider.dev/v1. Ein Schlüssel funktioniert an beiden Adressen; die Modellliste finden Sie auf der Modellseite , die Preise auf der Preisseite .

Wie authentifiziere ich mich?

Senden Sie den unveränderten sk-…-Schlüssel in x-api-key oder Authorization: Bearer: nur eines von beiden, nie beide. Bewahren Sie den Schlüssel in einer Umgebungsvariable auf, nicht in einer Datei, die ins Repository committet wird. Mehr zur Authentifizierung .

Wo bekomme ich einen Schlüssel?

Öffnen Sie Ihr Konto im Telegram-Bot @oneprovider_robot oder auf app.oneprovider.dev, laden Sie das Guthaben auf und tippen Sie auf „Schlüssel ausstellen“. Jeder Schlüssel kann ein eigenes Ausgabenlimit haben. Konto & API-Schlüssel .

Was bedeuten 401, 404 und 429?

401: Der Schlüssel fehlt, ist falsch geschrieben oder steht im falschen Header; fügen Sie den ganzen Schlüssel ohne Anführungszeichen und Leerzeichen ein. 404: meist eine falsche base URL, zum Beispiel ein fehlendes oder doppeltes /v1. 429 mit „Insufficient balance“: Das Guthaben des Kontos oder das Ausgabenlimit des Schlüssels ist aufgebraucht – laden Sie auf, statt es erneut zu versuchen; jedes andere 429 ist ein Rate-Limit, warten Sie dann die Zeit aus Retry-After ab. Details: Fehlercodes und Fehlerbehebung .

Warum brechen Streams ab oder werden zurückgesetzt?

VPN- und VLESS-Proxys puffern SSE oft oder stören die HTTP/2-Aushandlung. OneProvider hat keine regionalen Beschränkungen und puffert keine Streams – schalten Sie den Proxy aus und versuchen Sie es erneut.

Wohin wende ich mich, wenn das nicht reicht?

Schreiben Sie @Oneproviderhelpbot auf Telegram oder öffnen Sie „Support“ im Web-Konto – mit HTTP-Statuscode und genauer Fehlermeldung. So arbeitet der Support .