HALODocs
대시보드
API 참조

엔드포인트 인덱스

프로덕션 기본 URL 및 공개 엔드포인트 제품군

모든 프로덕션 API는 https://api.agihalo.com을 사용합니다. 아래 경로는 호출자 및 자격 증명 경계별로 그룹화됩니다.

#모델 게이트웨이

POST/v1beta/models/:model:generateContent
POST/v1beta/models/:model:streamGenerateContent
POST/v1beta/models/:model:predictLongRunning
POST/openai/v1/chat/completions
POST/openai/v1/images/generations
POST/openai/v1/images/edits
POST/claude/v1/messages
POST/deepseek/v1/chat/completions
POST/fish-audio/v1/tts
POST/v1/chat/completions
POST/v1/images/generations
POST/v1/images/edits
POST/:family/v1/chat/completions

#메모리

POST/api/v1/memory/capture
POST/api/v1/memory/retrieve
POST/api/v1/memory/functions/halo_retrieve_end_user_memory
GET/api/v1/memory/projects
POST/api/v1/memory/projects
GET/api/v1/memory/projects/:projectKey
DELETE/api/v1/memory/projects/:projectKey

#프로젝트 인증

GET/api/v1/auth/settings
GET/api/v1/auth/.well-known/jwks.json
POST/api/v1/auth/signup
POST/api/v1/auth/token
GET/api/v1/auth/user
POST/api/v1/auth/logout
POST/api/v1/auth/recover
POST/api/v1/auth/password/reset
GET/api/v1/auth/providers/:provider/authorize
POST/api/v1/auth/providers/token
GET/api/v1/auth/oauth/authorize
POST/api/v1/auth/oauth/authorize
POST/api/v1/auth/oauth/token
GET/api/v1/auth/oauth/userinfo

#Agent Access

파트너 백엔드 호출은 해당 Project 비밀 API 키를 사용합니다. 다음 가이드를 참고하세요: 연동 가이드 에서 Client App 등록, Link Session 생성, 승인된 다음 ID 조회 방법을 확인할 수 있습니다:clientAccessId. Link 생성 요청에는 다음 동의를 선택적으로 포함할 수 있습니다:동일 이메일 연결 동의.

GET/api/v1/agent-access/projects/:projectKey/agents
POST/api/v1/agent-access/projects/:projectKey/link-sessions
GET/api/v1/agent-access/projects/:projectKey/link-sessions/:sessionId
GET/api/v1/agent-access/projects/:projectKey/client-accesses
DELETE/api/v1/agent-access/projects/:projectKey/client-accesses/:clientAccessId
POST/api/v1/agent-access/projects/:projectKey/approvals
POST/api/v1/agent-access/projects/:projectKey/executions
POST/api/v1/agent-access/projects/:projectKey/executions/query

브라우저는 불투명한 Link 토큰으로 해당 요청을 읽을 수 있습니다. 다음 확인 및 동의 작업에는 로그인한 HALO 소유자의 플랫폼 JWT도 필요합니다.

GET/api/v1/agent-access/link-sessions/:linkToken
POST/api/v1/agent-access/link-sessions/:linkToken/verify-owner
POST/api/v1/agent-access/link-sessions/:linkToken/review
POST/api/v1/agent-access/link-sessions/:linkToken/connected-accounts/authorize
POST/api/v1/agent-access/link-sessions/:linkToken/confirm
GET/api/v1/agent-access/access-identity
POST/api/v1/agent-access/access-identity/approvals/:approvalId/decision
DELETE/api/v1/agent-access/access-identity/client-accesses/:clientAccessId
DELETE/api/v1/agent-access/access-identity/connected-accounts/:connectedAccountId

Connected Account 공급자 콜백은 일회용 OAuth state를 사용합니다. 이 콜백에서 파트너 서버 자격 증명을 교환하지 않습니다.

GET/api/v1/agent-access/oauth/callback/:providerKey

#서비스 레지스트리

GET/api/v1/services
POST/api/v1/services
GET/api/v1/services/:id
GET/api/v1/services/:id/metadata.json
POST/api/v1/services/:id/dns/verify
POST/api/v1/services/:id/erc8004/prepare-register
POST/api/v1/services/:id/erc8004/confirm-register

#계정 및 Keeper

GET/api/user/projects
POST/api/user/projects
GET/api/user/keys
POST/api/user/keys
DELETE/api/user/keys/:key
GET/api/user/model-vendors
PUT/api/user/model-vendors
GET/api/user/model-providers
POST/api/user/model-providers
POST/api/user/model-providers/:id/test
POST/api/user/model-providers/payouts