1. Cree una clave API
Cree o inicie sesión en su cuenta IteraCompute, luego cree una clave en la consola.
Conecta un agente de terminal a IteraCompute.
Cree o inicie sesión en su cuenta IteraCompute, luego cree una clave en la consola.
Configura un proveedor personalizado con nombre y chat_completions. Python AIAgent y CLI usan perfiles independientes.
Utilice el ID de modelo API exacto para el modelo elegido.Verifique su contexto y capacidades antes de habilitar las funciones de agente o visión.
DeepSeek V4.1 Flash 1017 es el modelo de referencia de pago. Puedes sustituirlo por un modelo de conversación publicado que permita tu clave. Revisa permisos, precios, contexto y herramientas al cambiar. Los ejemplos siguen tu selección; los resultados conservados siguen correspondiendo a Qwen.
Usa un checkout aislado de Hermes Agent v0.23.0 y HERMES_HOME. Exporta ITERACOMPUTE_API_KEY en la terminal de inicio.
git clone --branch v0.23.0 --depth 1 \
https://github.com/NousResearch/hermes-agent.git hermes-agent-v0.23.0
cd hermes-agent-v0.23.0
test "$(git rev-parse HEAD)" = \
"2bd378ed1b8d6bf2192cb26e0a55ff3091e6bd19"
export HERMES_HOME="$PWD/.hermes-iteracompute-cli"
export HERMES_RUNTIME_DIR="$HERMES_HOME/tools"
umask 077
mkdir -p "$HERMES_HOME"
source ./activate
hermes --version
hermes pm doctorumask 077
read -rsp 'IteraCompute API key: ' ITERACOMPUTE_API_KEY
printf '\n'
export ITERACOMPUTE_API_KEYHermes CLI puede añadir reasoning_effort=medium para un modelo personalizado desconocido. Comprueba la solicitud real frente a los parámetros del modelo elegido. reasoning_config={} es una opción del constructor Python, no un ajuste YAML ni prueba de que CLI desactive el razonamiento.
Mantenga las claves API en su entorno de servidor o almacén de credenciales de herramientas.Reemplace el campo clave de ejemplo con su propia clave cuando corresponda.
providers:
iteracompute:
api: https://api.iteracompute.com/v1
key_env: ITERACOMPUTE_API_KEY
transport: chat_completions
default_model: deepseek/deepseek-v4.1-flash-1017
context_length: 1048576
discover_models: false
extra_body:
max_tokens: 512
model:
provider: custom:iteracompute
default: deepseek/deepseek-v4.1-flash-1017
context_length: 1048576
streaming: false
agent:
max_turns: 3
api_max_retries: 0
auto_recovery_cycles: 0
fallback_providers: []
toolsets: [todo]
tools:
tool_search:
enabled: off
approvals:
mode: manual
compression:
enabled: false
auxiliary:
title_generation:
enabled: false
model_upgrade_enabled: falseGuarda la configuración solo en el perfil aislado. Los ejemplos de Chat Completions empiezan con 512 tokens de salida y sin fallback. Los metadatos de contexto no conceden derechos de cuenta; OpenClaw usa un presupuesto de entrada menor y Qwen un contexto de cuenta de 128K. El razonamiento varía por modelo: Python y OpenClaw solo añaden reasoning: false para Qwen; no lo copies a otros modelos.
python3 - <<'PY'
import json
import os
import urllib.error
import urllib.request
payload = {
'model': 'deepseek/deepseek-v4.1-flash-1017',
'messages': [{'role': 'user', 'content': 'Reply with exactly: ITERACOMPUTE_API_OK'}],
'max_tokens': 512,
**{},
}
request = urllib.request.Request(
'https://api.iteracompute.com/v1/chat/completions',
data=json.dumps(payload).encode('utf-8'),
headers={'Authorization': 'Bearer ' + os.environ['ITERACOMPUTE_API_KEY'],
'Content-Type': 'application/json'}, method='POST',
)
try:
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
except urllib.error.HTTPError as exc:
raise SystemExit(f'HTTP {exc.code}; inspect redacted details privately') from None
except (urllib.error.URLError, TimeoutError):
raise SystemExit('Network or timeout failure; no automatic retry') from None
choice = result['choices'][0]
if ((choice.get('message', {}).get('content') or '').strip() != 'ITERACOMPUTE_API_OK'
or choice.get('finish_reason') != 'stop'):
raise SystemExit('FAIL: expected final marker and stop reason not returned')
print('Direct API text passed; test the agent separately')
PYAl ejecutarlo envía una solicitud real. Confirma el marcador visible exacto y finish_reason=stop; HTTP 200 sin texto no basta. Los modelos de pago consumen saldo API. No reintentes automáticamente un resultado desconocido.
hermes chat --oneshot --ignore-rules --toolsets todo --max-turns 2 \
--format stream-json \
-q 'Do not call tools. Reply with exactly: HERMES_ITERACOMPUTE_OK' \
> hermes-text.private.jsonl 2> hermes-text.private.stderrEjecuta primero la verificación directa de API de abajo. Exige un marcador final no vacío, el provider/model previsto y la salida correcta del agente. Validar configuración o ejecutar una sonda no demuestra un flujo de agente o herramientas.
El perfil CLI anterior es una referencia documental. Para Python, crea otro HERMES_HOME en el checkout activado, guarda allí config.yaml y el script como iteracompute_agent_smoke.py. No combines los perfiles.
export HERMES_HOME="$PWD/.hermes-iteracompute-python"
mkdir -p "$HERMES_HOME"model:
provider: custom
default: deepseek/deepseek-v4.1-flash-1017
base_url: https://api.iteracompute.com/v1
streaming: false
providers:
custom:
request_timeout_seconds: 240
stale_timeout_seconds: 240
tools:
tool_search:
enabled: off
agent:
api_max_retries: 0
auto_recovery_cycles: 0
fallback_providers: []
compression:
enabled: false
auxiliary:
title_generation:
enabled: false
model_upgrade_enabled: falseimport os
from run_agent import AIAgent
agent = AIAgent(
provider="custom",
api_mode="chat_completions",
base_url="https://api.iteracompute.com/v1",
api_key=os.environ["ITERACOMPUTE_API_KEY"],
model="deepseek/deepseek-v4.1-flash-1017",
enabled_toolsets=["todo"],
max_iterations=3,
max_tokens=512,
run_budget_seconds=600,
reasoning_config={},
request_overrides={"extra_body": {}},
skip_context_files=True,
skip_memory=True,
skip_background_review=True,
load_soul_identity=False,
save_trajectories=False,
quiet_mode=True,
fallback_model={},
)
try:
result = agent.run_conversation(
"Call todo_list exactly once to write one item with id smoke-1, "
"content API smoke test, and status completed. Then read the tool result "
"and reply with exactly HERMES_ITERACOMPUTE_TOOL_OK. Do not use other tools."
)
if not (result.get("completed") is True and
(result.get("final_response") or "").strip() == "HERMES_ITERACOMPUTE_TOOL_OK"):
raise SystemExit("FAIL: inspect redacted details privately")
print("Final marker passed; verify actual todo_list events separately")
finally:
agent.close()python iteracompute_agent_smoke.pyCriterio de éxito: inspecciona una llamada real a todo_list, el elemento smoke-1 completado, el resultado de herramienta devuelto y la respuesta final HERMES_ITERACOMPUTE_TOOL_OK. El script solo comprueba el marcador final; revisa aparte los eventos de herramientas. Tres iteraciones y cero reintentos configurados no limitan estrictamente las solicitudes HTTP ni el gasto.
La API del modelo es remota; no necesitas GPU local ni puerto público de Gateway. El agente sí necesita CPU, memoria y permisos locales. Mantén las claves en el entorno del proceso y los registros originales privados; activa solo las herramientas necesarias. Los servicios externos requieren configuración y costes propios.
# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
-H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek/deepseek-v4.1-flash-1017","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'Compruebe que choices[0].message.content contenga texto visible;HTTP 200 por sí solo es insuficiente.El razonamiento puede consumir el presupuesto de producción.Para Qwen gratis, utiliza el ejemplo de la primera llamada gratuita a la API para desactivar el pensamiento, luego envíe un mensaje dentro de su herramienta.
Las capacidades describen la API de IteraCompute. Su disponibilidad también depende de la herramienta y su configuración; los controles de razonamiento varían según el modelo.
Revisa la clave del proceso, los permisos del modelo y el saldo de pago. Incluye /v1 una sola vez en la URL base. Envía el Model ID original a la API; el prefijo iteracompute/ solo corresponde al enrutamiento de OpenClaw.
Revisa los parámetros de razonamiento del modelo, el presupuesto de salida y los límites de cuenta. Respeta Retry-After. No mezcles formatos de razonamiento, no deduzcas éxito de HTTP 200 ni cambies automáticamente a otro modelo de pago.
Hermes: desactiva tool_search para probar todo y separa los perfiles Python y CLI. OpenClaw: sustituye deny-all por solo lectura para probar herramientas; no uses --isolated ni --auth-env-only con esta configuración.
Conecte su clave, elija un modelo y envíe su primera solicitud.