DOKU · v2

API-Referenz

devseek spricht das Protokoll OpenAI Chat Completions. Jedes OpenAI SDK funktioniert, sobald Sie die Basis-URL ändern.

BASIS-URL

https://devseek.space/v1

AUTHENTIFIZIERUNG

Authorization: Bearer dsk-…

MODELL

deepseek-v4.1-flash-free

224K Tokens · 64K Tokens

Schnellstart

OPENAI SDK · UNVERÄNDERT

1curl https://devseek.space/v1/chat/completions \
2  -H "Authorization: Bearer $DEVSEEK_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "model": "deepseek-v4.1-flash-free",
6    "stream": true,
7    "messages": [{"role": "user", "content": "Write a binary search in Rust"}]
8  }'

1import os
2from openai import OpenAI
3 
4client = OpenAI(
5    api_key=os.environ["DEVSEEK_API_KEY"],
6    base_url="https://devseek.space/v1",
7)
8 
9stream = client.chat.completions.create(
10    model="deepseek-v4.1-flash-free",
11    messages=[{"role": "user", "content": "Write a binary search in Rust"}],
12    max_tokens=4096,
13    stream=True,
14)
15for chunk in stream:
16    if chunk.choices:
17        print(chunk.choices[0].delta.content or "", end="")

1import OpenAI from "openai";
2 
3const client = new OpenAI({
4  apiKey: process.env.DEVSEEK_API_KEY,
5  baseURL: "https://devseek.space/v1",
6});
7 
8const stream = await client.chat.completions.create({
9  model: "deepseek-v4.1-flash-free",
10  messages: [{ role: "user", content: "Review this diff for bugs" }],
11  stream: true,
12});
13for await (const c of stream) process.stdout.write(c.choices[0]?.delta?.content ?? "");

1from openai import OpenAI
2client = OpenAI(api_key=KEY, base_url="https://devseek.space/v1")
3 
4tools = [{"type": "function", "function": {
5    "name": "run_tests",
6    "description": "Run the test suite and return failures",
7    "parameters": {"type": "object",
8                   "properties": {"path": {"type": "string"}},
9                   "required": ["path"]}}}]
10 
11r = client.chat.completions.create(
12    model="deepseek-v4.1-flash-free", tools=tools,
13    messages=[{"role": "user", "content": "Tests in src/ fail. Investigate."}])
14print(r.choices[0].message.tool_calls)

1# opencode.json — add devseek as an OpenAI-compatible provider
2{
3  "provider": {
4    "devseek": {
5      "npm": "@ai-sdk/openai-compatible",
6      "options": { "baseURL": "https://devseek.space/v1", "apiKey": "{env:DEVSEEK_API_KEY}" },
7      "models": { "deepseek-v4.1-flash-free": { "limit": { "context": 224000, "output": 65536 } } }
8    }
9  }
10}
11 
12# aider
13export OPENAI_API_BASE=https://devseek.space/v1 OPENAI_API_KEY=$DEVSEEK_API_KEY
14aider --model openai/deepseek-v4.1-flash-free

OpenAI-kompatibles /v1/chat/completionsAPI-Referenz

Endpunkte

Pfad	Funktion	Hinweise
`GET /v1/models`	Modelle auflisten	Schlüssel nötig
`POST /v1/chat/completions`	Chat, mit oder ohne Streaming, mit Tools	stream: true für SSE; der Usage-Block kommt zuletzt
`GET /api/status`	Öffentliches Status-JSON	Ohne Schlüssel
`GET /health`	Lebendprüfung	Ohne Schlüssel

Grenzen

Die Eingabe ist auf 224K Tokens und die Ausgabe auf 64K Tokens begrenzt. Wir schätzen die Eingabegröße aus den Bytes der Anfrage (etwa 3,3 Bytes pro Token), bevor wir das Modell aufrufen, daher kann eine Anfrage nahe der Grenze etwas früh abgelehnt werden.

Eine Eingabe über der Grenze liefert 400 mit dem Code context_length_exceeded. An das Modell wird nichts gesendet.
max_tokens über 64K Tokens liefert 400 mit dem Code invalid_max_tokens. devseek senkt oder ändert Ihr max_tokens niemals.
Anfragekörper sind auf 4 MB begrenzt.

Sitzungen und Stufen

Eine Sitzung ist eine Chat-Completion-Anfrage, die begonnen und noch nicht beendet ist. Ihre Stufe legt fest, wie viele Sitzungen gleichzeitig laufen dürfen:

2L1–10Skript
2–3L11–20Funktion
3–4L21–30Modul
4–5L31–40Paket
5L41–50Bibliothek
6L51–60Framework
6–7L61–70Laufzeit
7–8L71–80Compiler
8–9L81–90Kernel
9–10L91–100Architekt

Über Ihrem Limit erhalten Sie:

HTTP/1.1 429 Too Many Requests
Retry-After: 1
{"error":{"message":"Level 1 allows 3 concurrent sessions; 3 are already running. …",
 "type":"rate_limit_error","code":"session_limit_reached",
 "level":1,"session_limit":3,"sessions_in_use":3}}

Agenten und Editoren

Jedes Tool, das einen OpenAI-kompatiblen Anbieter akzeptiert, funktioniert. Nutzen Sie die Basis-URL, Ihren Schlüssel und die Modell-ID unten. Halten Sie parallele Tool-Worker auf oder unter Ihrem Sitzungslimit.

Fehler

Status / Code	Bedeutung	Was zu tun ist
`401 missing_api_key / invalid_api_key`	Schlüssel fehlt oder ist falsch	Authorization: Bearer dsk-… senden
`400 invalid_json / invalid_messages`	Fehlerhafter Körper oder messages	Anfrage korrigieren; nicht unverändert wiederholen
`400 context_length_exceeded`	Eingabe über 224K Tokens	Gespräch kürzen oder zusammenfassen
`404 model_not_found`	Unbekanntes Modell	deepseek-v4.1-flash-free verwenden
`413 body_too_large`	Körper über 4 MB	Weniger Kontext senden
`429 session_limit_reached`	Zu viele gleichzeitige Sitzungen	Warten Sie, bis eine Anfrage endet, und wiederholen Sie dann
`503 upstream_saturated / upstream_busy`	devseek oder das Modell ist ausgelastet	Nach der Zeit im Header Retry-After erneut versuchen
`502 upstream_error`	Das Modell-Backend ist ausgefallen	Erneuter Versuch ist unbedenklich