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

Partner backend calls use the matching Project secret API key. Follow the integration guide to register a Client App, create a Link Session, and retrieve the approvedclientAccessId. The Link creation request optionally acceptssame-email association consent.

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

The opaque Link token allows the browser to read its request. The following verification and consent actions additionally require the signed-in HALO owner's platform 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 provider callbacks use a one-time OAuth state. The callback is not a partner-server credential exchange.

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