DeepSeek: DeepSeek V3.1
DeepSeek V3.1 es un modelo textual híbrido con modos de razonamiento y respuesta directa en una misma edición. Su contexto de 128K y su perfil mejorado de uso de herramientas admiten programación, análisis documental y búsqueda proporcionada por la aplicación, con texto o llamadas a herramientas propuestas como resultado.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
DeepSeek V3.1 es el modelo textual híbrido de DeepSeek: la misma edición identificada admite respuestas con y sin razonamiento mediante distintos ajustes de plantilla de chat. El productor destaca mejoras en el uso de herramientas, las tareas de agentes y la eficiencia de razonamiento respecto a su modelo anterior. Acepta instrucciones escritas y contexto textual y genera una respuesta, código o contenido de llamadas a herramientas. La identidad original V3.1 es independiente de Terminus, V3.2 y la familia V4.
La ficha del modelo enumera 671 mil millones de parámetros totales, 37 mil millones de parámetros activos y un contexto de 128K tanto para la edición base como para la ajustada posteriormente. V3.1 se construye sobre la base original V3 con entrenamiento ampliado en documentos largos antes del ajuste posterior. Su estructura de mezcla de expertos y atención latente sigue la arquitectura V3. Estos hechos de diseño explican el perfil textual de contexto largo sin convertir la cifra de contexto en una especificación independiente de salida máxima.
El modo sin razonamiento prepara una respuesta directa, mientras que el modo con razonamiento inicia una fase de razonamiento antes de responder. La plantilla del productor utiliza un marcador de cierre de razonamiento para respuestas directas y un marcador de apertura de razonamiento para el turno actual de razonamiento. En una conversación de varios turnos, el contenido de razonamiento anterior se descarta mientras que las respuestas finales y el marcador de cierre permanecen en el contexto. Esta es la regla original de historial de V3.1, distinta de la regla posterior V3.2 que conserva el razonamiento entre mensajes relacionados con herramientas.
Las llamadas estándar a herramientas están documentadas en modo sin razonamiento. La aplicación proporciona nombres de funciones, descripciones y esquemas de parámetros; el modelo devuelve el nombre de una herramienta seleccionada y argumentos JSON en la representación de llamadas a herramientas del productor. La aplicación ejecuta la operación y devuelve su resultado. Asigna finalidades específicas a las herramientas y mantén la observación devuelta vinculada a la llamada, para que el siguiente paso del modelo tenga pruebas en lugar de un supuesto de que una acción ocurrió.
La búsqueda en modo de razonamiento utiliza un formato especializado e independiente de agente de búsqueda. DeepSeek documenta una herramienta de búsqueda proporcionada por el usuario para preguntas que requieren información externa o actual, con llamadas y observaciones repetidas a lo largo de varios turnos. Por tanto, la búsqueda forma parte del flujo que lo integra, no es una afirmación de que una respuesta textual haya navegado por la web de forma independiente. Define la pregunta, los criterios de fuentes y la respuesta final que necesitas antes de que comience la tarea de búsqueda.
Para programación, proporciona el fragmento o los archivos pertinentes, el comportamiento observado, el esperado y las restricciones que deben conservarse. Un ejemplo de encargo es: «Identifica la causa de este fallo para la entrada proporcionada, propone una corrección enfocada y explica la condición que maneja la modificación». Para una tarea documental, etiqueta las secciones de origen y pide una comparación frente a requisitos explícitos. Exige que la respuesta final distinga la conclusión respaldada por fuentes de una siguiente acción propuesta.
El productor entrena V3.1 utilizando el formato de escala UE8M0 FP8 para pesos y activaciones. Sus recomendaciones locales también identifican parámetros sensibles a la precisión que deben manejarse correctamente. Son características de la referencia publicada del productor, no una afirmación sobre la precisión o implementación seleccionadas por todas las aplicaciones. Un derivado, una variante cuantizada y el punto de control posterior Terminus siguen siendo opciones independientes de la edición identificada original V3.1.
Prepara el trabajo más extenso con una pregunta clara, etiquetas de origen y un entregable final definido. Distribuye la conversación, el texto de origen, el razonamiento y la salida dentro del contexto documentado y conserva solo las pruebas pertinentes a medida que crezca la tarea. Para un agente, especifica las acciones permitidas y el criterio que marca el resultado como completo. El entregable útil es una respuesta textual, una propuesta de código o un análisis respaldado por fuentes, revisables y vinculados a la entrada y las observaciones que la aplicación devolvió realmente.
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions deepseek-v3.1-thinking
deepseek-v3.1-thinkingPrimeros pasos
DeepSeek V3.1 es un modelo textual híbrido con modos de razonamiento y respuesta directa en una misma edición. Su contexto de 128K y su perfil mejorado de uso de herramientas admiten programación, análisis documental y búsqueda proporcionada por la aplicación, con texto o llamadas a herramientas propuestas como resultado.
- Entradas aceptadas
- Texto
- Resultados
- Texto
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions
- Tipos de entrada
text- Tipos de salida
text- Formato de salida
- json o SSE
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites deepseek-v3.1-thinking | Predeterminado— |
Campomessages | Tipomessage[] | RequisitoObligatorio | Valores y límites Número mínimo de elementos: 1 | Predeterminado— |
Campomessages[].role | Tipostring | RequisitoObligatorio | Valores y límites Depende del modelo | Predeterminado— |
Campomessages[].content | Tipostring | RequisitoOpcional | Valores y límites Se aplica cuando: Conversación textual | Predeterminado— |
Campostream | Tipoboolean | RequisitoOpcional | Valores y límites | Predeterminadofalse |
Combinaciones de materiales de entrada
Texto · Texto UTF8
messages[].content
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, messages |
Parámetromaterial_types | Contratotext |
Parámetromessages | Contratomatriz de mensajes con estructura role/content |
Parámetrofile_material | Contratodocumento real en UTF-8 insertado como texto literal; no se deduce ningún ID de archivo |
Parámetrooptional_controls | Contratostream |
Parámetrocontrol_scope | ContratoConversación textual; stream es un booleano y su valor predeterminado es false. |
Parámetrooutput_modalities | Contratotext |
Parámetrohosted_operations | Contratofalse |
Parámetromultimodal_input_binding | Contratonull |
Alias de método: /chat/completions
Ciclo de vida: synchronous_or_streamed
Envía el ID exacto del modelo junto con messages.
La longitud del contexto no es un límite máximo de salida.
Un archivo de texto puede aportar texto literal; las entradas de imagen, audio u objetos de archivo requieren una vinculación exacta.
Planes
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo rápido
- Sin especificar Cuando se selecciona el modo rápido
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)
Tarifas de Ailoot
Precios por configuración
| Configuración | Tabla de tarifas | Cargo |
|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cargo Entrada · Tokens de entrada $0.000572 / 1K tokens Salida · Tokens de salida $0.0023 / 1K tokens Entrada · Lectura de caché $0 / 1K tokens Entrada · Escritura en caché $0 / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
Ailoot Ultra · OpenAI Chat
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model":"deepseek-v3.1-thinking","messages":[{"role":"user","content":"hello"}],"stream":false}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("choices",[]):
if x.get("message",{}).get("content"): print(x["message"]["content"])
PY_RESULT
from openai import OpenAI
import os
if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.chat.completions.create(model="deepseek-v3.1-thinking", messages=[{"role":"user","content":"hello"}], stream=False)
import base64, json
from pathlib import Path
def save_result(data, stem="result"):
# Keep every field, including usage, IDs, reasoning and tool requests.
Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
print(json.dumps(data, ensure_ascii=False, indent=2))
def save_blob(encoded, suffix, label):
raw = base64.b64decode(encoded, altchars=b"-_", validate=True)
ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix
file = Path(stem + "-" + label + "." + ext)
file.write_bytes(raw)
print("Saved", file)
for index, block in enumerate(data.get("content") or []):
print("Content", index, json.dumps(block, ensure_ascii=False))
for choice in data.get("choices") or []:
print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))
for index, item in enumerate(data.get("output") or []):
print("Output", index, json.dumps(item, ensure_ascii=False))
if item.get("type") == "image_generation_call" and item.get("result"):
save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))
for ci, candidate in enumerate(data.get("candidates") or []):
for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):
print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))
blob = part.get("inlineData") or part.get("inline_data")
if blob and blob.get("data"):
mime = blob.get("mimeType") or blob.get("mime_type")
suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")
save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))
save_result(result.to_dict(mode="json"))
Recibir y guardar resultados
Ailoot Ultra · OpenAI Chat
json o SSE
Conserva todos los resultados completados
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
Conserva cada alternativa y su contenido, llamadas de herramientas y razonamiento. En SSE, ensambla los fragmentos incrementales por índice de alternativa/herramienta y conserva el motivo final de terminación y el uso.
Si es necesario revisar la respuesta original
Conserva los ID de solicitud y respuesta y las cabeceras. No se proporciona una URL genérica para recuperar tareas de texto.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campochoices[].index | Tipointeger |
Campochoices[].message.content | Tipostring|null |
Campochoices[].message.tool_calls | Tipotool_call[] |
Campochoices[].message.reasoning_content | Tipostring |
Campochoices[].message.reasoning_details | Tipoobject|array |
Campochoices[].finish_reason | Tipostring|null |
Campousage | Tipoobject |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampos obligatorios, representación del material o valor del parámetro no válidos | Siguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación. |
Alias
Alias del modelo
Ailoot Ultra deepseek-v3.1-thinking
Alias de rutas de métodos
/chat/completions
ID de modelo relacionados
FAQ · DeepSeek: DeepSeek V3.1
- ¿Qué entradas y resultados están disponibles?
POST /v1/chat/completions·deepseek-v3.1-thinking:text→text- ¿Qué campos utiliza la solicitud?
POST /v1/chat/completions·deepseek-v3.1-thinking:model,messages,stream- ¿Qué límites se aplican?
POST /v1/chat/completions·deepseek-v3.1-thinking:messages.min_items:1