NNexithDocs
상태대시보드 ↗
개요 및 빠른 시작모델 카탈로그가이드API 레퍼런스연동OAuth2 / OIDC

opencode에서 Nexith 사용하기

opencode는 표준 OpenAI 호환 프로토콜(POST /v1/chat/completions)을 사용합니다. 가장 범용적인 경로이며, 대부분의 서드파티 도구가 접속하는 방식입니다.

구성#

opencode는 provider 구성을 통해 OpenAI 호환 백엔드를 선언합니다:

{
  "provider": {
    "nexith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Nexith",
      "options": {
        "baseURL": "https://gateway.nexith.ai/v1",
        "apiKey": "nx-你的key"
      },
      "models": {
        "nexith-core": { "name": "Nexith Core" }
      }
    }
  }
}

구성 키 이름은 opencode 자체 문서를 기준으로 하세요. Nexith 측에서 필요한 것은 baseURL에 /v1 포함 + apiKey에 nx- key 사용입니다. https://api.nexith.ai/v1도 사용할 수 있습니다.

Nexith 측 지원 현황#

기능 상태
POST /v1/chat/completions(스트리밍/비스트리밍) ✅
tools / tool_choice / parallel_tool_calls ✅ 그대로 전달
tool_calls 스트리밍 조각(index + function.arguments 증분) ✅ 그대로 포워딩, 재정렬 없음
finish_reason: "tool_calls" ✅ 그대로 유지
assistant 메시지 재생(tool_calls + tool_call_id) ✅
GET /v1/models ✅
Anthropic / Responses 프로토콜 claude-code.md / codex.md 참고

tools가 비어 있지 않으면 게이트웨이는 업스트림의 reasoning_effort를 none으로 정규화합니다(도구가 있을 때 추론은 속도를 늦추고 token 예산을 소진하기 때문). 이는 의도된 동작입니다.

과금과 긴 작업#

  • 단일 요청 120초 상한(현재). opencode의 긴 agent 루프에서 단일 턴이 120s를 넘으면 잘립니다 — 처리 중입니다.
  • 스트리밍 응답은 현재 stream_options.include_usage를 포함하지 않으므로 업스트림이 스트리밍 사용량을 반환하지 않습니다: 과금은 추정치를 기반으로 하며 prompt cache 할인이 적용되지 않습니다. 반복 프리픽스가 많은 agent 루프에는 영향이 커서 이미 할 일 목록에 있습니다.
  • 32k 컨텍스트를 넘는 nexith-core 요청은 자동으로 더 강한 업스트림으로 업그레이드되고 업그레이드 등급으로 과금됩니다.

문제 해결#

스트리밍 응답이 멈춤 / 오랜 시간 출력 없음 업스트림의 긴 사고 동안 게이트웨이는 어떤 바이트도 보내지 않습니다(현재 SSE 하트비트 없음). 할 일 목록에 있습니다.

도구 이름 또는 파라미터 손실 업스트림이 규격과 다르게 name보다 arguments를 먼저 보내면 현재 구현은 이름을 빈 값으로 고정합니다. 표준 업스트림에는 이 문제가 없습니다.

401 key는 nx-로 시작해야 합니다. Authorization: Bearer와 x-api-key 두 헤더 모두 게이트웨이가 허용합니다.