models

MoonshotAI: Kimi K3 (batch)

Markdown · JSON

MoonshotAI: Kimi K3 (batch)

Kimi K3 es el modelo nativamente multimodal de razonamiento de Moonshot AI para tareas largas de programación y trabajo de conocimiento. Lee texto, imágenes y video, produce texto y admite flujos con herramientas con un contexto de 1,048,576 tokens e historial de razonamiento conservado entre pasos.

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.

Kimi K3 es el modelo multimodal de agentes de pesos abiertos de Moonshot AI para programación de largo alcance, trabajo de conocimiento y razonamiento. Combina texto con comprensión visual nativa de imágenes y video y produce una respuesta textual o una solicitud a herramienta. Su desarrollador destaca sesiones extensas de ingeniería, repositorios grandes y tareas que usan capturas de pantalla o retroalimentación visual junto con código. Un documento útil de instrucciones define el artefacto deseado, la evidencia que debe usar y la condición que marca el trabajo como terminado.

Arquitectura y contexto largo

La ficha del modelo describe una mezcla dispersa de expertos con 2.8 billones de parámetros totales y 104,000 millones de parámetros activados. Su diseño Stable LatentMoE selecciona 16 de 896 expertos por token y usa Kimi Delta Attention y Attention Residuals junto con atención con compuertas. La longitud exacta de contexto es de 1,048,576 tokens. Es espacio para un contexto extenso de tarea, no una razón para descartar los límites de las fuentes ni el espacio necesario para el resultado.

El artefacto nativo publicado usa entrenamiento consciente de cuantización con pesos MXFP4 y activaciones MXFP8. Es el formato de publicación de su desarrollador, distinto de una edición cuantizada proporcionada por separado o una afirmación sobre cómo una ruta particular sirve el modelo. Los pesos abiertos y una gran cantidad de parámetros no convierten la cifra de parámetros activos en el requisito total de almacenamiento o hardware.

Prepara una tarea extensa de programación

Proporciona el material relevante del repositorio, el comportamiento existente, el cambio solicitado y las restricciones de compatibilidad. Identifica los archivos o la interfaz que debe afectar el resultado, las comprobaciones que determinan el éxito y cualquier error o entrada proporcionados que revelen el problema. Un resultado útil puede ser un cambio enfocado de código con explicación y evidencia de las comprobaciones que realmente se ejecutaron, en lugar de una descripción de acciones que nunca se realizaron.

Para una tarea visual de desarrollo, incluye una captura de pantalla o una vista clara del resultado previsto con el código relevante y una discrepancia específica. Su desarrollador describe flujos que abarcan frontend, juegos y CAD que usan retroalimentación visual. Solicita el cambio que conecta el código con el resultado observado y conserva la referencia para que el artefacto entregado se pueda comprobar contra ella.

Imágenes, video y preparación del trabajo de conocimiento

La guía de inicio rápido de su desarrollador usa objetos de contenido tipados para mensajes visuales; content es un arreglo, no una representación serializada de ese arreglo. Su flujo de imágenes usa datos de imagen codificados o una referencia de archivo compatible, en lugar de una dirección pública de imagen. El ejemplo de video carga un archivo de video y proporciona la referencia resultante con una pregunta sobre su contenido. Da una fuente legible y especifica la observación, el intervalo o la relación que importan. El flujo visual de su desarrollador acepta imágenes JPEG, PNG, GIF, WebP, BMP, HEIC y HEIF, y videos MP4, MPEG, MOV, AVI, FLV, MPG, WebM, WMV y 3GPP. Un GIF o WebP animado se puede decodificar como video. Proporciona código fuente SVG como texto. Su desarrollador recomienda imágenes de hasta 4096 × 2160 y video de hasta 1920 × 1080; son recomendaciones de resolución, no umbrales de rechazo. Mantén el cuerpo de solicitud dentro del límite documentado de tamaño 100M y carga como archivos los medios grandes o usados repetidamente.

Para investigación con muchos documentos, etiqueta las fuentes e indica las preguntas que debe responder el informe final. Para una explicación de video, identifica los eventos o la secuencia que se deben analizar en lugar de solicitar comentarios sin restricciones. K3 usa contenido visual como evidencia para razonar y devuelve texto o solicitudes a herramientas. Una aplicación puede pasar esas solicitudes a herramientas multimedia para crear artefactos separados de imagen o video.

El razonamiento siempre está activado

La interfaz de su desarrollador de K3 siempre tiene el razonamiento activado. El ajuste de nivel superior reasoning_effort acepta low, high y max, con max como valor predeterminado. Estas opciones son específicas del modelo; no debe asumirse un ajuste sin razonamiento ni un valor de esfuerzo de otra familia. La guía de migración de su desarrollador distingue K3 de K2.x al usar reasoning_effort en lugar de conservar la configuración thinking anterior.

Su desarrollador documenta reasoning_content y contenido de respuesta final separados en los resultados en streaming. Para una conversación de varios turnos o un flujo de herramientas, exige devolver sin cambios el mensaje completo del asistente recibido, incluidos reasoning_content y tool_calls. Conservar únicamente la respuesta final visible pierde información que el flujo de razonamiento conservado del modelo espera en el siguiente paso.

Respuestas finales estructuradas y continuación parcial

La guía de inicio rápido documenta salida estricta mediante esquema JSON para el contenido del mensaje final. Define los campos y su significado alrededor del artefacto que necesita la aplicación e interpreta ese contenido final en lugar de combinarlo con el campo de razonamiento. Un resultado estructurado puede representar información extraída de material proporcionado o un formato definido de informe; el esquema limita su forma, mientras que la evidencia de origen determina si sus valores son correctos.

El modo parcial puede continuar un prefijo de texto proporcionado. El ejemplo de su desarrollador coloca un mensaje parcial del asistente al final del historial y combina ese prefijo con la continuación devuelta para mostrarlo. Úsalo cuando el artefacto requerido tenga un inicio fijo significativo, y mantén el prefijo separado del resto generado.

Herramientas y continuidad de sus resultados

K3 admite herramientas de funciones personalizadas. El ejemplo de su desarrollador exige una herramienta en el primer turno, conserva el mensaje completo del asistente, ejecuta cada llamada devuelta y agrega un resultado de herramienta coincidente antes de solicitar la respuesta final. Una llamada propuesta no es evidencia de que la operación tuvo éxito; el resultado realmente devuelto se convierte en evidencia para el siguiente paso.

Su flujo de carga dinámica introduce una definición completa de herramienta en un punto específico del historial de mensajes. La definición necesita su nombre, propósito y parámetros, y debe permanecer en el historial posterior porque el servidor no conserva esa declaración de forma independiente. Mantén asociadas las capacidades de herramientas, los argumentos proporcionados y las observaciones reales para que una tarea larga continúe a partir del trabajo ya completado.

Controles de salida y contexto repetido

Su desarrollador documenta una asignación predeterminada de completado de 131,072 tokens, configurable hasta 1,048,576 dentro de las restricciones generales de contexto del modelo. Su API K3 actual fija temperature en 1.0, top_p en 0.95, un solo resultado y penalizaciones de presencia y frecuencia en cero, e indica a quienes la llaman omitir esos controles de muestreo. Son los ajustes del perfil exacto de su desarrollador, no una lista transferible de controles ajustables.

El almacenamiento en caché de contexto es automático para prefijos repetidos elegibles, con opciones documentadas de TTL de 5 minutos y 1 hora, y 5 minutos como valor predeterminado. Los bloques parciales de caché siguen contando como fallos de caché. Mantén estable el contexto reutilizable y comprueba el uso real en lugar de afirmar un acierto de caché solo por repetir texto. Para el artefacto final, conserva las fuentes proporcionadas, la evidencia real de herramientas y la estructura de salida requerida, y comprueba que una respuesta larga o un resultado de ingeniería cumplan los criterios de finalización indicados.

Ailoot Ultra · Batch POST /v1/batches moonshotai/kimi-k3:batch

moonshotai/kimi-k3:batch

MoonshotAI /moonshotai/kimi-k3:batch

Inicio

Kimi K3 es el modelo nativamente multimodal de razonamiento de Moonshot AI para tareas largas de programación y trabajo de conocimiento. Lee texto, imágenes y video, produce texto y admite flujos con herramientas con un contexto de 1,048,576 tokens e historial de razonamiento conservado entre pasos.

Entradas aceptadas
Texto
Resultados
Texto

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Batch POST /v1/batches
Entrada
text
Salida
text
Formato de salida
JSON de results[].response.body en línea
CampoTipoRequisitoValores y límitesPredeterminado
CampoendpointTipostringRequisitoObligatorioValores y límites
/v1/chat/completions
Predeterminado—
CampomodelTipostringRequisitoObligatorioValores y límites
moonshotai/kimi-k3:batch
Predeterminado—
CamporequestsTipobatch_item[]RequisitoObligatorioValores y límites
Número mínimo de elementos: 1
Predeterminado—
Camporequests[].custom_idTipostringRequisitoObligatorioValores y límitesPredeterminado—
Camporequests[].body.messagesTipomessage[]RequisitoObligatorioValores y límitesPredeterminado—
Campocompletion_windowTipostringRequisitoOpcionalValores y límites
24h
Predeterminado—
CampoproviderTipoobject|nullRequisitoOpcionalValores y límitesPredeterminado—
Camporequests[].body.modelTipostringRequisitoOpcionalValores y límites
moonshotai/kimi-k3:batch, moonshotai/kimi-k3
Predeterminado—
Campoprovider.onlyTipostring[]RequisitoOpcionalValores y límites
deepinfra/bf16
Predeterminado—
Campoprovider.allow_fallbacksTipoboolean|nullRequisitoOpcionalValores y límites
false, null
Predeterminado—
Parámetros del método y ciclo de vida
ParámetroContrato
Parámetrocontent_typeContratoapplication/json
ParámetrorequiredContratoendpoint, model, requests
Parámetromaterial_typesContratotext
ParámetrorepresentationContratorequests[] en línea; cada elemento tiene custom_id y body
Parámetrorequest_endpoint_profileContrato/v1/chat/completions
Parámetrofile_materialContratoQuien realiza la llamada puede leer localmente el JSONL UTF-8 real e incorporarlo a requests[]. No se utiliza el campo purpose para cargas, ni input_file_id ni referencias a archivos. Si falta el material del cliente o está vacío, la preparación se detiene antes del POST.
Parámetroserialization_orderContratoendpoint, model, provider (si se proporciona), completion_window (si se proporciona), requests al final
Parámetrooptional_controlsContratoprovider.only, provider.allow_fallbacks, completion_window
Parámetroschema_scopeContratoCuerpos de solicitudes de texto de Chat Completions dentro de la estructura Batch en línea documentada.

Ciclo de vida: asynchronous

GET /v1/batches/{operation_id} · El response.id real de la respuesta de creación original; el mismo usuario, clave y grupo

Tarifas

Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.

Modo fast
Sin especificar Cuando se selecciona el modo fast
Modo flex
Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento
Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste default
Precios de caché explícita
No habilitado Cuando se solicita caché explícita

Tarifas de Ailoot

Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

ConfiguraciónTabla de tarifasTokens de contexto, más deTokens de contexto, hasta inclusiveCargo
ConfiguraciónTarifas base por tokenTabla de tarifasTarifa baseTokens de contexto, más de—Tokens de contexto, hasta inclusiveSin límite superiorCargo
Entrada · Tokens de entrada $0.00456 / 1K tokens
Salida · Tokens de salida $0.0228 / 1K tokens
Entrada · Lectura de caché $0.000456 / 1K tokens
Entrada · Escritura en caché — / 1K tokens
Entrada · Escritura en caché, 1 hora — / 1K tokens
ConfiguraciónNivel 1 por longitud de la solicitudTabla de tarifas—Tokens de contexto, más de0Tokens de contexto, hasta inclusiveSin límite superiorCargo
Entrada · Tokens de entrada $0.00456 / 1K tokens
Salida · Tokens de salida $0.0228 / 1K tokens
Entrada · Lectura de caché $0.000456 / 1K tokens
Entrada · Escritura en caché — / 1K tokens
Entrada · Escritura en caché, 1 hora — / 1K tokens

Ailoot reserva un monto 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 · Batch

curl · ejemplo de prueba conservadoPython HTTP · JSONL real del clientePython · guarda cada resultado completado
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json
from pathlib import Path
body=json.loads('{"endpoint":"/v1/chat/completions","model":"moonshotai/kimi-k3:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')
Path("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json
import json, os
from pathlib import Path
from urllib.request import Request, urlopen

def prepare_requests(customer_path):
    path = Path(customer_path)
    if not path.is_file(): raise ValueError("Customer JSONL file is missing")
    items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
    if not items: raise ValueError("Customer JSONL contains no requests")
    ids = set()
    for item in items:
        if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")
        cid = item["custom_id"]
        if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")
        ids.add(cid)
        if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")
        supplied_model = item["body"].get("model")
        if supplied_model is not None and supplied_model not in ['moonshotai/kimi-k3:batch', 'moonshotai/kimi-k3']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"moonshotai/kimi-k3:batch", "requests":items}

if __name__ == "__main__":
    material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")
    if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")
    body = prepare_requests(material)
    key = os.environ.get("AILOOT_API_KEY", "")
    if not key: raise SystemExit("Set AILOOT_API_KEY")
    request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")
    with urlopen(request) as response:
        raw = response.read()
        Path("batch-create-response.json").write_bytes(raw)
        print(raw.decode("utf-8"))
import json
from pathlib import Path
raw = Path("batch-status-response.json").read_bytes()
response = json.loads(raw)
if response.get("status") != "completed":
    raise SystemExit("Keep the original operation; read its status without resubmitting")
results = response.get("results")
if not isinstance(results, list) or not results:
    raise SystemExit("Preserve the original response; completed results are missing")
Path("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\n" for item in results), encoding="utf-8")
# Preserve batch-status-response.json with aggregate usage and every result/error.

Recibir y guardar resultados

Ailoot Ultra · Batch

JSON de results[].response.body en línea

  • GET /v1/batches/{operation_id}
Consultar el estado de la tarea
curl · estado de la operación original
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
BATCH_OPERATION_ID="$(python3 - <<'PY_ID'
import json
from pathlib import Path
from urllib.parse import quote
response = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))
operation = response.get("id")
if not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")
print(quote(operation, safe=""))
PY_ID
)"
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json
Conserva todos los resultados completados

Conserva todas las respuestas, archivos y partes de contenido completos recibidos.

Conserva el JSON completo del estado original, cada result/custom_id y el cuerpo completo de la respuesta o del error. Guarda results[] completados como JSONL sin filtrar.

Si es necesario revisar la respuesta original

Conserva el ID de la operación original. La respuesta 503 result_pending_check incluye X-Should-Retry:false; nunca vuelvas a enviar un lote original cuyo resultado sea desconocido.

Campos de respuesta
CampoTipo
Camporesults[].custom_idTipostring
Camporesults[].response.body.choices[].message.contentTipostring|null
Camporesults[].errorTipoobject|null
CampousageTipoobject|null
CampoidTipostring
CampomodelTipostring
CampoendpointTipostring
CampostatusTipostring
Camporequest_countsTipoobject
Camporesults[].idTipostring
Camporesults[].response.status_codeTipointeger
Camporesults[].response.request_idTipostring
Errores y siguientes pasos
RespuestaCondiciónSiguiente paso
Respuesta400 · invalid_request_errorCondiciónLa estructura en línea documentada no es válida, hay claves duplicadas, existe un problema con la identidad de los elementos o hay un conflicto entre las capacidades configuradas del modelo.Siguiente pasoCorrige los campos indicados antes de realizar cualquier nuevo envío.
Respuesta401 · authentication_errorCondiciónClave de API no válida.Siguiente pasoUsa la clave de Ailoot autorizada.
Respuesta403 · permission_errorCondiciónGrupo de Batch no disponible.Siguiente pasoVerifica los permisos de la clave y el grupo.
Respuesta422 · invalid_request_errorCondiciónBatch usa facturación contra saldo; se rechazan las solicitudes de creación con una suscripción.Siguiente pasoUsa el grupo autorizado con facturación contra saldo.
Respuesta422 · price_unavailableCondiciónNo se puede cotizar la entrada de Batch.Siguiente pasoConserva la respuesta; usa la entrada documentada para la familia.
Respuesta402 · billing_errorCondiciónReserva de Batch no disponible.Siguiente pasoResuelve los requisitos de admisión antes de realizar una nueva solicitud.
Respuesta503 · price_unavailableCondiciónPrecio del método Batch o tarifas nativas no disponibles.Siguiente pasoConserva la respuesta; no sustituyas los precios.
Respuesta503 · api_errorCondiciónLa ruta exacta del proveedor no está disponible.Siguiente pasoConserva la respuesta para reparar la ruta.
Respuesta503 · result_pending_checkCondiciónEl resultado original requiere una revisión; X-Should-Retry:false.Siguiente pasoConserva el operation_id/id original y consulta su estado; nunca repitas el POST original.
Respuesta404 · not_foundCondiciónLa operación de consulta de estado de Batch no existe o pertenece a otra identidad.Siguiente pasoUsa el id original exacto y el mismo usuario, clave y grupo.

Alias

Alias del modelo

Ailoot Ultra moonshotai/kimi-k3:batch

Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

ID de modelo relacionados

moonshotai/kimi-k3:batch

FAQ · MoonshotAI: Kimi K3 (batch)
¿Qué entradas y resultados están disponibles?

POST /v1/batches · moonshotai/kimi-k3:batch: text → text

¿Qué campos utiliza la solicitud?

POST /v1/batches · moonshotai/kimi-k3:batch: endpoint, model, requests, completion_window, provider

¿Qué límites se aplican?

POST /v1/batches · moonshotai/kimi-k3:batch: requests.min_items: 1

Más detalles

Conecta Ailoot a Claude Code, OpenCode, Hermes o tu aplicación.

La empresa y su cartera de proyectos

La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.

Compra tokens con descuento.

Ahorro por suscripción para trabajo habitual. Códigos promocionales: hasta el 50% al comprar tokens.

Suscripción
Elige un plan con descuento para tus peticiones habituales.
Código de hasta el 50%
Introduce el código al comprar. El precio se recalcula según la promoción vigente.
Gasto en el historial
Modelo, tokens e importe quedan guardados por cada petición.

Elegir suscripción · Consultar precios de modelos

Conecta la API al producto que vendes.

SaaS, aplicaciones y bots bajo la oferta y el acuerdo de licencia Ailoot. Solicita una licencia de reventa para redistribuir el acceso.

Aplicación comercial
Integra generación de texto, imágenes, vídeo y sonido en funciones de pago de tu servicio.
Licencia para revendedores
Envía descripción del proyecto y esquema de acceso. Solicita condiciones escritas de uso y reventa.
Documentos en la web
La oferta, el acuerdo de licencia y la política de datos están disponibles antes de conectar.

Solicitar licencia de reventa · Oferta y acuerdo de licencia