DOCUMENTACIÓN · v2

Referencia de la API

devseek habla el protocolo OpenAI Chat Completions. Cualquier SDK de OpenAI funciona en cuanto cambias la URL base.

URL BASE

https://devseek.space/v1

AUTENTICACIÓN

Authorization: Bearer dsk-…

MODELO

deepseek-v4.1-flash-free

224K tokens · 64K de tokens

Inicio rápido

OPENAI SDK · SIN CAMBIOS

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

/v1/chat/completions compatible con OpenAIReferencia de la API

Puntos de acceso

Ruta	Qué hace	Notas
`GET /v1/models`	Listar modelos	Requiere clave
`POST /v1/chat/completions`	Chat, con o sin streaming, con herramientas	stream: true para SSE; el bloque de uso llega al final
`GET /api/status`	JSON de estado público	Sin clave
`GET /health`	Comprobación de vida	Sin clave

Límites

La entrada está limitada a 224K tokens y la salida a 64K tokens. Estimamos el tamaño de la entrada a partir de los bytes de la petición (unos 3,3 bytes por token) antes de llamar al modelo, así que una petición cerca del límite puede rechazarse un poco antes.

Una entrada por encima del límite devuelve 400 con el código context_length_exceeded. No se envía nada al modelo.
Un max_tokens superior a 64K tokens devuelve 400 con el código invalid_max_tokens. devseek nunca reduce ni reescribe tu max_tokens.
Los cuerpos de las peticiones están limitados a 4 MB.

Sesiones y niveles

Una sesión es una petición de chat completion que ha empezado y aún no ha terminado. Tu nivel fija cuántas sesiones pueden ejecutarse a la vez:

2L1–10Script
2–3L11–20Función
3–4L21–30Módulo
4–5L31–40Paquete
5L41–50Biblioteca
6L51–60Framework
6–7L61–70Entorno de ejecución
7–8L71–80Compilador
8–9L81–90Núcleo
9–10L91–100Arquitecto

Si superas tu límite recibes:

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}}

Agentes y editores

Sirve cualquier herramienta que acepte un proveedor compatible con OpenAI. Usa la URL base, tu clave y el ID de modelo de abajo. Mantén los procesos de herramientas en paralelo en tu límite de sesiones o por debajo.

Errores

Estado / código	Significado	Qué hacer
`401 missing_api_key / invalid_api_key`	Clave ausente o incorrecta	Envía Authorization: Bearer dsk-…
`400 invalid_json / invalid_messages`	Cuerpo o messages mal formados	Corrige la petición; no la reintentes tal cual
`400 context_length_exceeded`	Entrada de más de 224K tokens	Acorta o resume la conversación
`404 model_not_found`	Modelo desconocido	Usa deepseek-v4.1-flash-free
`413 body_too_large`	Cuerpo de más de 4 MB	Envía menos contexto
`429 session_limit_reached`	Demasiadas sesiones simultáneas	Espera a que termine una petición y reintenta
`503 upstream_saturated / upstream_busy`	devseek o el modelo están al máximo de capacidad	Reintenta después del tiempo indicado en la cabecera Retry-After
`502 upstream_error`	El backend del modelo falló	Es seguro reintentar