OpenAI 호환

Hermes Agent를 IteraCompute에 연결

터미널 에이전트를 IteraCompute에 연결하세요.

3단계로 연결

1. API 키 생성

IteraCompute 계정을 생성하거나 로그인한 다음 콘솔에서 키를 생성하세요.

2. 기본 URL 구성

chat_completions를 사용하는 명명된 사용자 지정 제공자를 설정하세요. Python AIAgent와 CLI 설정은 별도 프로필입니다.

3. 모델을 선택하세요

선택한 모델에 대한 정확한 API 모델 ID를 사용하세요.에이전트 또는 비전 기능을 활성화하기 전에 해당 컨텍스트와 기능을 확인하세요.

모델을 선택하세요

유료 DeepSeek V4.1 Flash 1017이 참조 모델입니다. 키로 이용 가능한 공개 대화 모델로 바꿀 수 있습니다. 변경 후 권한, 가격, 컨텍스트, 도구 지원을 다시 확인하세요. 예제는 선택에 따라 바뀌지만 보존된 테스트 결과는 Qwen에만 해당합니다.

격리 환경 준비

격리된 Hermes Agent v0.23.0 소스와 HERMES_HOME을 사용하세요. 시작 터미널에서 ITERACOMPUTE_API_KEY를 설정하세요.

Bash / macOS / Linux / WSL
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 doctor
Bash · 현재 터미널의 키
umask 077
read -rsp 'IteraCompute API key: ' ITERACOMPUTE_API_KEY
printf '\n'
export ITERACOMPUTE_API_KEY

Hermes CLI는 알 수 없는 사용자 지정 모델에 reasoning_effort=medium을 추가할 수 있습니다. 실제 요청을 선택한 모델의 매개변수와 대조하세요. 아래 reasoning_config={}는 Python 생성자 옵션이며 YAML 설정이나 CLI 추론이 꺼졌다는 증거가 아닙니다.

예시 구성

서버 환경이나 도구 자격 증명 저장소에 API 키를 보관하세요.해당하는 경우 예제 키 필드를 사용자 고유의 키로 바꿉니다.

CLI · $HERMES_HOME/config.yaml
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: false

위에서 만든 격리 프로필에만 저장하세요. Chat Completions 예제는 출력 512 tokens와 폴백 없이 시작합니다. 컨텍스트 메타데이터는 계정 사용 권한이 아닙니다. OpenClaw는 더 작은 입력 예산을, Qwen은 계정 컨텍스트 128K를 사용합니다. 추론 제어는 모델별로 다르며 Python과 OpenClaw의 reasoning: false는 Qwen에만 추가됩니다.

먼저 직접 API 검증

Python · 직접 텍스트 검증
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')
PY

실행하면 실제 요청 한 건을 보냅니다. 정확한 표시 마커와 finish_reason=stop을 확인하세요. 본문이 빈 HTTP 200은 미완료입니다. 유료 모델은 API 잔액을 사용합니다. 결과가 불확실하면 자동 재시도하지 마세요.

에이전트 텍스트 경로 검증

Bash · 텍스트 검증
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.stderr

먼저 아래 직접 API 검증을 실행한 뒤 비어 있지 않은 최종 마커, 지정 provider/model, 에이전트의 정상 종료를 확인하세요. 설정 검증이나 제공자 프로브만으로 에이전트 또는 도구 워크플로를 입증할 수 없습니다.

도구 왕복 한 번 검증

위 CLI 프로필은 문서 참고 설정입니다. Python 경로는 활성화한 소스 디렉터리에서 별도 HERMES_HOME을 만들고 아래 config.yaml과 iteracompute_agent_smoke.py를 저장하세요. 두 프로필을 합치지 마세요.

Bash · 별도 Python 프로필
export HERMES_HOME="$PWD/.hermes-iteracompute-python"
mkdir -p "$HERMES_HOME"
Python 프로필 · config.yaml
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: false
iteracompute_agent_smoke.py
import 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()
Bash · Python 에이전트 실행
python iteracompute_agent_smoke.py

성공 기준: 실제 todo_list 호출, 완료된 smoke-1 항목, 도구 결과 반환, 최종 HERMES_ITERACOMPUTE_TOOL_OK 응답을 확인하세요. 스크립트는 최종 마커만 확인하므로 도구 이벤트는 따로 점검해야 합니다. 반복 3회와 설정상 재시도 0회는 엄격한 HTTP 요청 수나 비용 상한이 아닙니다.

버전 및 검증

테스트 버전
Hermes Agent v0.23.0
테스트 결과
비스트리밍 Python 도구 호출 통과.

인증 정보, 도구 및 데이터

모델 API는 원격으로 실행되므로 로컬 GPU나 공개 Gateway 포트가 필요하지 않습니다. 에이전트에는 로컬 CPU, 메모리, 권한이 필요합니다. 키는 시작 프로세스 환경에 보관하고 원본 로그는 비공개로 유지하며 필요한 도구만 켜세요. 외부 서비스는 별도 설정과 비용이 적용됩니다.

연결 테스트

cURL · 채팅 완료
# 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}'

choices[0].message.content에 보이는 텍스트가 포함되어 있는지 확인하세요.HTTP 200만으로는 부족합니다.추론은 출력 예산을 소비할 수 있습니다.무료 Qwen을 사용하려면 다음을 사용하세요. 첫 무료 API 호출 예제 사고를 비활성화하려면 도구 내부에 메시지를 보내세요.

선택된 모델 기능

기능은 IteraCompute API의 지원 범위를 나타냅니다. 워크플로에서의 사용 가능 여부는 도구와 설정에도 달려 있으며, 추론 제어는 모델마다 다릅니다.

  • 채팅 완료지원됨
  • 도구 호출지원됨
  • 추론지원됨
  • 이미지 입력지원됨
  • 스트리밍지원됨

문제 해결

401 / 403 / 404

시작 프로세스의 키, 모델 권한, 유료 잔액을 확인하세요. Base URL에는 /v1을 한 번만 넣으세요. API에는 원래 Model ID를 보내고 iteracompute/ 접두사는 OpenClaw 내부 라우팅에만 사용하세요.

400 / 빈 응답 / 429

모델별 추론 매개변수, 출력 예산, 계정 한도를 확인하고 Retry-After를 따르세요. 추론 형식을 겹쳐 쓰거나 HTTP 200만으로 성공을 판단하거나 다른 유료 모델로 자동 전환하지 마세요.

도구 누락 / 잘못된 프로필

Hermes: todo 테스트에서 tool_search를 끄고 Python과 CLI 프로필을 분리하세요. OpenClaw: 도구 테스트에서 deny-all을 read 전용으로 바꾸세요. 이 사용자 지정 설정에 --isolated나 --auth-env-only를 사용하지 마세요.

Hermes Agent 설정 참고 문서 →

Hermes Agent로 개발을 시작하세요.

키를 연결하고 모델을 선택한 후 첫 번째 요청을 보내세요.