Skip to main content

개요

TokenLab DeepSeek Harness bundle은 두 가지 통합 영역을 제공합니다.
  • OpenAI Responses, Anthropic Messages, OpenAI Chat Completions용 상호 배타적인 모델 경로 세 개
  • 모델 검색, 이미지, 비디오, 음악, 3D, 오디오, 파일, embeddings, rerank, 번역 및 비동기 작업을 포함하는 TokenLab MCP full profile
패키지 이름은 @tokenlabai/dsh-provider이며 DeepSeek Harness 0.1.1-rc.2와 호환되는 0.1.x 플러그인 계약을 대상으로 합니다.
이 페이지는 릴리스 준비 문서입니다. npm 패키지를 게시하고 다시 읽어 확인하기 전에는 이 페이지를 배포하거나 마켓에 제출하지 마세요.

설치

프로젝트 또는 Harness home의 .env에 key를 저장합니다.
사용할 profile에 설치한 후 다시 시작합니다.
일회성 작업은 headless profile을 사용할 수 있습니다.

네이티브 엔드포인트 라우팅

Harness는 provider route 수준에서 wire protocol을 선택하므로 bundle은 provider 세 개를 등록하고 각 공개 chat 모델을 정확히 하나에만 배치합니다. 스냅샷은 GET /v1/modelsGET /v1/models/{id}에서 생성되며 모델 이름 substring이나 내부 경로를 추측하지 않습니다.
현재 Harness custom provider는 openai-responses, anthropic-messages, openai-completions를 지원하지만 Gemini native는 구성할 수 없습니다. Harness의 Gemini 모델은 공개된 Chat fallback을 사용합니다. Gemini generateContent가 필요하면 호환 클라이언트에서 /v1beta/models/{model}:generateContent를 호출하세요.

멀티미디어 및 개발 도구

bundle은 공식 MCP bridge를 통해 고정된 @tokenlabai/mcp-server를 로컬 stdio에서 시작합니다. 기본 full profile은 mcp__tokenlab__... 이름으로 80개 도구를 등록하며 catalog/pricing, 네 가지 LLM API, 이미지, 비디오, 음악, 3D, 오디오, 파일, response lifecycle, batches, embeddings, rerank, 번역, worlds 및 미디어 자산을 포함합니다. 모델에는 portable schema를 제공하고 MCP server는 전체 OpenAPI contract로 실행 요청을 검증합니다.

비동기 미디어

비디오, 음악, 3D 생성은 비동기입니다. 이미지는 모델에 따라 동기 결과 또는 작업을 반환합니다.
  1. delivery.mode를 확인합니다.
  2. sync이면 결과를 바로 사용합니다.
  3. async이면 delivery.task_idtokenlab_wait_task에 전달합니다.
  4. status, 전체 response, result_urls를 사용합니다.
  5. timeout 시 최신 비종료 상태를 반환하므로 polling을 안전하게 이어갈 수 있습니다.
tokenlab_wait_task는 읽기 전용이며 호출자 취소를 모든 요청과 delay에 전달하고, 일시적 재시도를 제한하며, 선택적 progress가 아닌 status로 종료를 판단합니다.

설정

반복되는 tool schema 비용을 줄이는 것이 전체 개발 표면보다 중요하면 core를 사용하세요.

검증 및 보안

재시작 후 TokenLab provider 세 개, 모델 비중복, mcp__tokenlab__list_models의 비어 있지 않은 결과를 확인합니다. 테스트 key로 Responses, Messages, Chat 요청을 각각 실행해 로그의 endpoint를 대조하고, 저비용 비동기 미디어 작업이 종료 URL을 반환하는지 검증합니다. key는 신뢰할 수 있는 환경 또는 secret store에 보관하세요. MCP server는 Harness와 같은 Node로 로컬 stdio에서 실행되며 shell이나 호스팅 MCP를 통하지 않습니다. 과금 또는 파괴적 도구에는 Harness 승인을 유지하고 반환된 텍스트, URL, 파일 및 미디어를 신뢰하지 마세요. 기존 llm-pi-ai settings section은 bundle 기본값보다 우선합니다. 이미 사용 중이면 패키지 cordis.patch.ymltokenlab-* 경로 세 개를 providers map에 병합하세요.

제거

profile을 다시 시작합니다. TokenLab 계정이나 key는 삭제되지 않습니다.

관련 문서