# ZeroCat 文档

> ZeroCat 文档：用户指南、API 参考、管理接口、场景示例、常见问题与条款政策。

## Docs

- [首页](/index): 一个 API 密钥，通过 OpenAI、Claude、Gemini 兼容接口调用多家大模型，并接入 Claude Code、Codex 等 AI 工具。
- [接入地址速查](/guide/endpoints): ZeroCat 的两个接入端点，以及各客户端、各协议的地址写法
- [模型说明](/user/models): 如何查看可用模型、分组对模型的影响，以及不同模型该用哪种协议调用。
- [注册与登录](/user/auth): 注册 ZeroCat 账号，使用账号密码、Passkey 或第三方账号登录，以及找回密码。
- [概览与数据看板](/user/dashboard): 通过概览页和数据看板查看余额、用量、模型调用情况和服务状态。
- [API 密钥](/user/token): API 密钥是调用 ZeroCat 的凭证。可以为每个密钥单独设置额度、模型、分组和来源限制。
- [钱包与充值](/user/wallet): 查看余额与用量，在线充值、使用兑换码、购买订阅、领取邀请奖励和查看订单历史。
- [日志与异步任务](/user/log): 查看 API 请求明细、绘图记录和异步任务，按条件筛选并跟踪任务状态、结果与退款。
- [个人资料与安全](/user/profile): 管理账户信息、通知与偏好、密码、账户绑定、登录会话、访问令牌、两步验证和 Passkey。
- [模型广场和排行榜](/user/pricing): 在模型广场查看可用模型的价格和状态，在排行榜查看模型与供应商的使用量排名。
- [使用 API 与游乐场](/user/playground): 在游乐场在线测试模型，或通过 OpenAI、Claude、Gemini 兼容接口调用 ZeroCat。
- [聊天应用集成](/user/chat-apps): 把 ZeroCat 一键导入或手动配置到各类 AI 聊天应用中。
- [概述](/api/overview): ZeroCat 的 AI 模型接口，兼容 OpenAI、Anthropic Claude 和 Google Gemini 格式。
- [列出模型](/api/models/list): 获取当前可用的模型列表。

根据请求头自动识别返回格式：
- 包含 `x-api-key` 和 `anthropic-version` 头时返回 Anthropic 格式
- 包含 `x-goog-api-key` 头或 `key` 查询参数时返回 Gemini 格式
- 其他情况返回 OpenAI 格式
- [列出模型（Gemini 格式）](/api/models/list-gemini): 以 Gemini API 格式返回可用模型列表
- [Chat Completions](/api/chat/chat-completions): 根据对话历史创建模型响应。支持流式和非流式响应。

兼容 OpenAI Chat Completions API。
- [Responses](/api/chat/responses): OpenAI Responses API，用于创建模型响应。
支持多轮对话、工具调用、推理等功能。
- [Messages（Claude 格式）](/api/chat/messages): Anthropic Claude Messages API 格式的请求。
需要在请求头中包含 `anthropic-version`。
- [Gemini 文本聊天](/api/chat/gemini): 代理 Gemini API 请求。
路径格式: `/v1beta/models/{model_name}:{action}`

例如:
- `/v1beta/models/gemini-2.5-pro:generateContent`
- `/v1beta/models/gemini-2.5-pro:streamGenerateContent?alt=sse`
- [Gemini 媒体识别](/api/chat/gemini-media): Gemini图像、PDF、音频、视频识别请求

⚠️注意：原生 Gemini 格式请求支持通过 inlineData（base64）或 fileData.fileUri（可公开访问的 URL，支持 YouTube 链接）传递媒体。通过 Gemini File API 上传的文件 URI 能否访问，取决于上游渠道 Key 的权限，建议优先使用可公开访问的 URL。OpenAI 格式（chat/completions）请求转换为 Gemini 时，媒体将统一下载并转换为 inlineData（base64）传递。
- [Completions](/api/completions): 基于给定提示创建文本补全
- [Embeddings](/api/embeddings/openai): 将文本转换为向量嵌入
- [Embeddings（Gemini 格式）](/api/embeddings/gemini): 使用指定引擎/模型创建嵌入
- [文档重排序](/api/rerank): 根据查询对文档列表进行相关性重排序
- [Moderations](/api/moderations): 检查文本内容是否违反使用政策
- [生成图像](/api/images/generations): 在给定提示的情况下创建图像。[了解更多](https://platform.openai.com/docs/guides/images)。
- [编辑图像](/api/images/edits): 在给定原始图像和提示的情况下创建编辑或扩展图像。
- [Gemini 原生格式生图](/api/images/gemini): Gemini 图片生成
- [Gemini 生图（Chat 格式）](/api/images/gemini-chat): Gemini 图片生成
- [通义千问生成图像](/api/images/qwen-generations): 百炼qwen-image系列图片生成
- [通义千问编辑图像](/api/images/qwen-edits): 百炼qwen-image系列图片编辑
- [文本转语音](/api/audio/speech): 将文本转换为音频
- [音频转录](/api/audio/transcriptions): 将音频转换为文本
- [音频翻译](/api/audio/translations): 将音频翻译为英文文本
- [Gemini 音频理解](/api/audio/gemini): Gemini 音频生成接口。
可使用gemini-2.5-flash-preview-tts等模型
- [Realtime](/api/realtime): 建立 WebSocket 连接用于实时对话。

**注意**: 这是一个 WebSocket 端点，需要使用 WebSocket 协议连接。

连接 URL 示例: `wss://api.example.com/v1/realtime?model=gpt-4o-realtime`
- [创建视频生成任务](/api/videos/create): 提交视频生成任务，支持文生视频和图生视频。

返回任务 ID，可通过 GET 接口查询任务状态。
- [查询视频生成任务](/api/videos/get): 查询视频生成任务的状态和结果。

任务状态：
- `queued`: 排队中
- `in_progress`: 生成中
- `completed`: 已完成
- `failed`: 失败
- [Sora 创建视频](/api/videos/sora-create): OpenAI 兼容的视频生成接口。

参考文档: https://platform.openai.com/docs/api-reference/videos/create
- [Sora 查询任务](/api/videos/sora-get): OpenAI 兼容的视频任务状态查询接口。

返回视频任务的详细状态信息。
- [Sora 获取视频内容](/api/videos/sora-content): 获取已完成视频任务的视频文件内容。

此接口会代理返回视频文件流。
- [可灵文生视频](/api/videos/kling-text2video): 使用 Kling 模型从文本描述生成视频。

支持的模型：kling-v1, kling-v1-5 等
- [可灵文生视频查询](/api/videos/kling-text2video-get): 查询 Kling 文生视频任务的状态和结果。
- [可灵图生视频](/api/videos/kling-image2video): 使用 Kling 模型从图片生成视频。

支持通过 image 参数传入图片 URL 或 Base64 编码的图片数据。
- [可灵图生视频查询](/api/videos/kling-image2video-get): 查询 Kling 图生视频任务的状态和结果。
- [即梦视频生成](/api/videos/jimeng): 即梦官方 API 格式的视频生成接口。

支持通过 Action 参数指定操作类型：
- `CVSync2AsyncSubmitTask`: 提交视频生成任务
- `CVSync2AsyncGetResult`: 获取任务结果

需要在查询参数中指定 Action 和 Version。
- [概述与鉴权](/manage/overview): 用个人访问令牌在自己的系统中管理 ZeroCat 账户：查询余额、管理 API 密钥、查看日志等。
- [获取当前用户信息](/manage/user/self): 需要个人访问令牌，作用域：`profile:read`（个人资料 → 查看）。
- [更新当前用户信息](/manage/user/self-update): 需要个人访问令牌，作用域：`profile:write`（个人资料 → 编辑）。

只用于修改显示名称。修改密码需要安全验证，请在控制台操作。
- [获取当前用户分组](/manage/user/groups): 需要个人访问令牌，作用域：`profile:read`（个人资料 → 查看）。
- [获取可用模型](/manage/user/models): 需要个人访问令牌，作用域：`profile:read`（个人资料 → 查看）。
- [更新用户设置](/manage/user/setting): 需要个人访问令牌，作用域：`profile:write`（个人资料 → 编辑）。

会用请求体整体覆盖通知与偏好设置，未提交的字段会恢复为默认值。
- [获取 API 密钥列表](/manage/token/list): 需要个人访问令牌，作用域：`api_key:read`（API 密钥 → 查看）。

返回的 `key` 是打码后的密钥。需要完整密钥时调用 [获取完整 API 密钥](/manage/token/key)。
- [搜索 API 密钥](/manage/token/search): 需要个人访问令牌，作用域：`api_key:read`（API 密钥 → 查看）。
- [获取指定 API 密钥](/manage/token/get): 需要个人访问令牌，作用域：`api_key:read`（API 密钥 → 查看）。
- [获取完整 API 密钥](/manage/token/key): 需要个人访问令牌，作用域：`api_key:reveal`（API 密钥 → 查看完整密钥）。

返回的密钥不含 `sk-` 前缀，调用模型时请写成 `sk-` + `key`。
- [创建 API 密钥](/manage/token/create): 需要个人访问令牌，作用域：`api_key:write`（API 密钥 → 编辑）。

创建成功只返回 `success`，不返回密钥。请随后用 [获取 API 密钥列表](/manage/token/list) 找到新密钥的 ID，再调用 [获取完整 API 密钥](/manage/token/key)。
- [更新 API 密钥](/manage/token/update): 需要个人访问令牌，作用域：`api_key:write`（API 密钥 → 编辑）。

不带 `status_only` 时会用请求体覆盖密钥的全部设置，请先用 [获取指定 API 密钥](/manage/token/get) 取到当前设置，修改后再完整提交。
- [删除 API 密钥](/manage/token/delete): 需要个人访问令牌，作用域：`api_key:write`（API 密钥 → 编辑）。
- [批量删除 API 密钥](/manage/token/batch-delete): 需要个人访问令牌，作用域：`api_key:write`（API 密钥 → 编辑）。
- [查询 API 密钥用量](/manage/token/usage): 用要查询的 API 密钥本身鉴权，不需要个人访问令牌。
- [获取个人日志](/manage/log/self): 需要个人访问令牌，作用域：`usage:read`（用量 → 查看）。

普通用户单次查询的时间范围有上限，超出时会返回错误。
- [个人日志统计](/manage/log/self-stat): 需要个人访问令牌，作用域：`usage:read`（用量 → 查看）。

只统计消费类日志。`rpm`、`tpm` 是最近 60 秒的统计，不受时间范围参数影响。
- [通过 API 密钥查询日志](/manage/log/by-token): 用要查询的 API 密钥本身鉴权，不需要个人访问令牌。

返回这个 API 密钥最近的调用日志，最多 1000 条。
- [获取个人额度数据](/manage/log/data-self): 需要个人访问令牌，作用域：`usage:read`（用量 → 查看）。
- [获取充值记录](/manage/topup/self): 需要个人访问令牌，作用域：`wallet:read`（钱包 → 查看）。
- [使用兑换码](/manage/topup/redeem): 需要个人访问令牌，作用域：`wallet:write`（钱包 → 编辑）。

兑换成功后，额度直接计入账户余额。
- [获取个人任务](/manage/task/self): 需要个人访问令牌，作用域：`usage:read`（用量 → 查看）。
- [获取个人 Midjourney 任务](/manage/task/mj-self): 需要个人访问令牌，作用域：`usage:read`（用量 → 查看）。
- [获取系统状态](/manage/public/status): 公开接口，不需要鉴权。
- [获取定价信息](/manage/public/pricing): 公开接口，不需要鉴权。
- [获取公告](/manage/public/notice): 公开接口，不需要鉴权。
- [安装 CC Switch](/guide/cc-switch): CC Switch 是一款开源的桌面工具，支持 Windows、macOS、Linux，用图形界面统一管理 Claude Code、Codex、Gemini CLI 等 AI 编程工具的「供应商」配置。
- [Claude Code](/guide/claude-code): 用 CC Switch 把 ZeroCat 配置到 Claude Code，全程图形界面操作，不用手动修改配置文件。
- [Codex](/guide/codex): 用 CC Switch 把 ZeroCat 配置到 Codex，同时适用于 Codex CLI、桌面版和编辑器插件。
- [DeepSeek Harness](/guide/deepseek-harness): DeepSeek Harness 是 DeepSeek 官方推出的 AI Agent 桌面客户端。它支持通过「自定义模型 API」接入中转站，可以使用 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 三种协议。
- [Factory Droid CLI](/apps/factory-droid-cli): 安装 AI 软件工程助手 Factory Droid CLI，并通过自定义模型接入 ZeroCat。
- [Cherry Studio](/apps/cherry-studio): 把桌面 AI 客户端 Cherry Studio 接入 ZeroCat，内置 30+ 专业 AI 助手，覆盖多种工作场景。
- [DeepChat](/apps/deepchat): 把全功能 AI Agent 客户端 DeepChat 接入 ZeroCat，支持一键导入配置。
- [AionUi](/apps/aionui): 把免费开源的桌面办公 Agent AionUi 接入 ZeroCat，支持 Gemini CLI、Claude Code、Codex 等多种 AI 代理。
- [AQBot](/apps/aqbot): 把本地优先的桌面 AI 工作台 AQBot 接入 ZeroCat，支持 OpenAI、Claude、Gemini 三种协议。
- [OpenClaw](/apps/openclaw): 安装自托管 AI 助手平台 OpenClaw，并把 ZeroCat 配置为模型提供商。支持 Telegram、Discord、WhatsApp 等多渠道。
- [LangBot](/apps/langbot): 把即时通信机器人开发平台 LangBot 接入 ZeroCat，为飞书、钉钉、Telegram、Discord 等平台的机器人提供 AI 能力。
- [AstrBot](/apps/astrbot): 把开源 Agent 聊天机器人平台 AstrBot 接入 ZeroCat，为 QQ、飞书、钉钉、企业微信等即时通讯提供 AI 能力。
- [Memoh](/apps/memoh): 把自托管容器化 AI 智能体平台 Memoh 接入 ZeroCat，为 Telegram、Discord、飞书、QQ、微信等渠道创建有长期记忆的 AI 机器人。
- [流畅阅读 FluentRead](/apps/fluent-read): 把开源浏览器翻译插件流畅阅读接入 ZeroCat，用大模型实现沉浸式双语阅读。
- [LunaTranslator](/apps/luna-translator): 把开源 GalGame / 视觉小说翻译器 LunaTranslator 接入 ZeroCat，用大模型提升翻译质量。
- [常见问题](/faq): 额度、计费、报错排查、充值退款和联系方式等常见问题。
- [服务条款](/legal/terms): 您与 ZeroCat LLC 之间关于使用 ZeroCat 服务的协议。
- [隐私政策](/legal/privacy): ZeroCat LLC 如何收集、使用、存储、披露及以其他方式处理个人信息。
- [退款政策](/legal/refund): 预付额度、退款、账单异议与拒付规则。
- [使用须知](/legal/usage): 使用资格、受限制地区、账户与 API 凭据、可接受使用规范及 AI 输出免责声明。
- [首頁](/zh-Hant/index): 一個 API 金鑰，透過 OpenAI、Claude、Gemini 相容介面呼叫多家大模型，並接入 Claude Code、Codex 等 AI 工具。
- [接入地址速查](/zh-Hant/guide/endpoints): ZeroCat 的兩個接入端點，以及各客戶端、各協議的地址寫法
- [模型說明](/zh-Hant/user/models): 如何檢視可用模型、分組對模型的影響，以及不同模型該用哪種協議呼叫。
- [註冊與登入](/zh-Hant/user/auth): 註冊 ZeroCat 賬號，使用賬號密碼、Passkey 或第三方賬號登入，以及找回密碼。
- [概覽與資料看板](/zh-Hant/user/dashboard): 透過概覽頁和資料看板檢視餘額、用量、模型呼叫情況和服務狀態。
- [API 金鑰](/zh-Hant/user/token): API 金鑰是呼叫 ZeroCat 的憑證。可以為每個金鑰單獨設定額度、模型、分組和來源限制。
- [錢包與充值](/zh-Hant/user/wallet): 檢視餘額與用量，線上充值、使用兌換碼、購買訂閱、領取邀請獎勵和檢視訂單歷史。
- [日誌與非同步任務](/zh-Hant/user/log): 檢視 API 請求明細、繪圖記錄和非同步任務，按條件篩選並跟蹤任務狀態、結果與退款。
- [個人資料與安全](/zh-Hant/user/profile): 管理賬戶資訊、通知與偏好、密碼、賬戶繫結、登入會話、訪問令牌、兩步驗證和 Passkey。
- [模型廣場和排行榜](/zh-Hant/user/pricing): 在模型廣場檢視可用模型的價格和狀態，在排行榜檢視模型與供應商的使用量排名。
- [使用 API 與遊樂場](/zh-Hant/user/playground): 在遊樂場線上測試模型，或透過 OpenAI、Claude、Gemini 相容介面呼叫 ZeroCat。
- [聊天應用整合](/zh-Hant/user/chat-apps): 把 ZeroCat 一鍵匯入或手動配置到各類 AI 聊天應用中。
- [概述](/zh-Hant/api/overview): ZeroCat 的 AI 模型介面，相容 OpenAI、Anthropic Claude 和 Google Gemini 格式。
- [列出模型](/zh-Hant/api/models/list): 獲取當前可用的模型列表。

根據請求頭自動識別返回格式：
- 包含 `x-api-key` 和 `anthropic-version` 頭時返回 Anthropic 格式
- 包含 `x-goog-api-key` 頭或 `key` 查詢引數時返回 Gemini 格式
- 其他情況返回 OpenAI 格式
- [列出模型（Gemini 格式）](/zh-Hant/api/models/list-gemini): 以 Gemini API 格式返回可用模型列表
- [Chat Completions](/zh-Hant/api/chat/chat-completions): 根據對話歷史建立模型響應。支援流式和非流式響應。

相容 OpenAI Chat Completions API。
- [Responses](/zh-Hant/api/chat/responses): OpenAI Responses API，用於建立模型響應。
支援多輪對話、工具呼叫、推理等功能。
- [Messages（Claude 格式）](/zh-Hant/api/chat/messages): Anthropic Claude Messages API 格式的請求。
需要在請求頭中包含 `anthropic-version`。
- [Gemini 文字聊天](/zh-Hant/api/chat/gemini): 代理 Gemini API 請求。
路徑格式: `/v1beta/models/{model_name}:{action}`

例如:
- `/v1beta/models/gemini-2.5-pro:generateContent`
- `/v1beta/models/gemini-2.5-pro:streamGenerateContent?alt=sse`
- [Gemini 媒體識別](/zh-Hant/api/chat/gemini-media): Gemini影象、PDF、音訊、影片識別請求

⚠️注意：原生 Gemini 格式請求支援透過 inlineData（base64）或 fileData.fileUri（可公開訪問的 URL，支援 YouTube 連結）傳遞媒體。透過 Gemini File API 上傳的檔案 URI 能否訪問，取決於上游渠道 Key 的許可權，建議優先使用可公開訪問的 URL。OpenAI 格式（chat/completions）請求轉換為 Gemini 時，媒體將統一下載並轉換為 inlineData（base64）傳遞。
- [Completions](/zh-Hant/api/completions): 基於給定提示建立文字補全
- [Embeddings](/zh-Hant/api/embeddings/openai): 將文字轉換為向量嵌入
- [Embeddings（Gemini 格式）](/zh-Hant/api/embeddings/gemini): 使用指定引擎/模型建立嵌入
- [文件重排序](/zh-Hant/api/rerank): 根據查詢對文件列表進行相關性重排序
- [Moderations](/zh-Hant/api/moderations): 檢查文字內容是否違反使用政策
- [生成影象](/zh-Hant/api/images/generations): 在給定提示的情況下建立影象。[瞭解更多](https://platform.openai.com/docs/guides/images)。
- [編輯影象](/zh-Hant/api/images/edits): 在給定原始影象和提示的情況下建立編輯或擴充套件影象。
- [Gemini 原生格式生圖](/zh-Hant/api/images/gemini): Gemini 圖片生成
- [Gemini 生圖（Chat 格式）](/zh-Hant/api/images/gemini-chat): Gemini 圖片生成
- [通義千問生成影象](/zh-Hant/api/images/qwen-generations): 百鍊qwen-image系列圖片生成
- [通義千問編輯影象](/zh-Hant/api/images/qwen-edits): 百鍊qwen-image系列圖片編輯
- [文字轉語音](/zh-Hant/api/audio/speech): 將文字轉換為音訊
- [音訊轉錄](/zh-Hant/api/audio/transcriptions): 將音訊轉換為文字
- [音訊翻譯](/zh-Hant/api/audio/translations): 將音訊翻譯為英文文字
- [Gemini 音訊理解](/zh-Hant/api/audio/gemini): Gemini 音訊生成介面。
可使用gemini-2.5-flash-preview-tts等模型
- [Realtime](/zh-Hant/api/realtime): 建立 WebSocket 連線用於實時對話。

**注意**: 這是一個 WebSocket 端點，需要使用 WebSocket 協議連線。

連線 URL 示例: `wss://api.example.com/v1/realtime?model=gpt-4o-realtime`
- [建立影片生成任務](/zh-Hant/api/videos/create): 提交影片生成任務，支援文生影片和圖生影片。

返回任務 ID，可透過 GET 介面查詢任務狀態。
- [查詢影片生成任務](/zh-Hant/api/videos/get): 查詢影片生成任務的狀態和結果。

任務狀態：
- `queued`: 排隊中
- `in_progress`: 生成中
- `completed`: 已完成
- `failed`: 失敗
- [Sora 建立影片](/zh-Hant/api/videos/sora-create): OpenAI 相容的影片生成介面。

參考文件: https://platform.openai.com/docs/api-reference/videos/create
- [Sora 查詢任務](/zh-Hant/api/videos/sora-get): OpenAI 相容的影片任務狀態查詢介面。

返回影片任務的詳細狀態資訊。
- [Sora 獲取影片內容](/zh-Hant/api/videos/sora-content): 獲取已完成影片任務的影片檔案內容。

此介面會代理返回影片檔案流。
- [可靈文生影片](/zh-Hant/api/videos/kling-text2video): 使用 Kling 模型從文字描述生成影片。

支援的模型：kling-v1, kling-v1-5 等
- [可靈文生影片查詢](/zh-Hant/api/videos/kling-text2video-get): 查詢 Kling 文生影片任務的狀態和結果。
- [可靈圖生影片](/zh-Hant/api/videos/kling-image2video): 使用 Kling 模型從圖片生成影片。

支援透過 image 引數傳入圖片 URL 或 Base64 編碼的圖片資料。
- [可靈圖生影片查詢](/zh-Hant/api/videos/kling-image2video-get): 查詢 Kling 圖生影片任務的狀態和結果。
- [即夢影片生成](/zh-Hant/api/videos/jimeng): 即夢官方 API 格式的影片生成介面。

支援透過 Action 引數指定操作型別：
- `CVSync2AsyncSubmitTask`: 提交影片生成任務
- `CVSync2AsyncGetResult`: 獲取任務結果

需要在查詢引數中指定 Action 和 Version。
- [概述與鑑權](/zh-Hant/manage/overview): 用個人訪問令牌在自己的系統中管理 ZeroCat 賬戶：查詢餘額、管理 API 金鑰、檢視日誌等。
- [獲取當前使用者資訊](/zh-Hant/manage/user/self): 需要個人訪問令牌，作用域：`profile:read`（個人資料 → 檢視）。
- [更新當前使用者資訊](/zh-Hant/manage/user/self-update): 需要個人訪問令牌，作用域：`profile:write`（個人資料 → 編輯）。

只用於修改顯示名稱。修改密碼需要安全驗證，請在控制檯操作。
- [獲取當前使用者分組](/zh-Hant/manage/user/groups): 需要個人訪問令牌，作用域：`profile:read`（個人資料 → 檢視）。
- [獲取可用模型](/zh-Hant/manage/user/models): 需要個人訪問令牌，作用域：`profile:read`（個人資料 → 檢視）。
- [更新使用者設定](/zh-Hant/manage/user/setting): 需要個人訪問令牌，作用域：`profile:write`（個人資料 → 編輯）。

會用請求體整體覆蓋通知與偏好設定，未提交的欄位會恢復為預設值。
- [獲取 API 金鑰列表](/zh-Hant/manage/token/list): 需要個人訪問令牌，作用域：`api_key:read`（API 金鑰 → 檢視）。

返回的 `key` 是打碼後的金鑰。需要完整金鑰時呼叫 [獲取完整 API 金鑰](/zh-Hant/manage/token/key)。
- [搜尋 API 金鑰](/zh-Hant/manage/token/search): 需要個人訪問令牌，作用域：`api_key:read`（API 金鑰 → 檢視）。
- [獲取指定 API 金鑰](/zh-Hant/manage/token/get): 需要個人訪問令牌，作用域：`api_key:read`（API 金鑰 → 檢視）。
- [獲取完整 API 金鑰](/zh-Hant/manage/token/key): 需要個人訪問令牌，作用域：`api_key:reveal`（API 金鑰 → 檢視完整金鑰）。

返回的金鑰不含 `sk-` 字首，呼叫模型時請寫成 `sk-` + `key`。
- [建立 API 金鑰](/zh-Hant/manage/token/create): 需要個人訪問令牌，作用域：`api_key:write`（API 金鑰 → 編輯）。

建立成功只返回 `success`，不返回金鑰。請隨後用 [獲取 API 金鑰列表](/zh-Hant/manage/token/list) 找到新金鑰的 ID，再呼叫 [獲取完整 API 金鑰](/zh-Hant/manage/token/key)。
- [更新 API 金鑰](/zh-Hant/manage/token/update): 需要個人訪問令牌，作用域：`api_key:write`（API 金鑰 → 編輯）。

不帶 `status_only` 時會用請求體覆蓋金鑰的全部設定，請先用 [獲取指定 API 金鑰](/zh-Hant/manage/token/get) 取到當前設定，修改後再完整提交。
- [刪除 API 金鑰](/zh-Hant/manage/token/delete): 需要個人訪問令牌，作用域：`api_key:write`（API 金鑰 → 編輯）。
- [批次刪除 API 金鑰](/zh-Hant/manage/token/batch-delete): 需要個人訪問令牌，作用域：`api_key:write`（API 金鑰 → 編輯）。
- [查詢 API 金鑰用量](/zh-Hant/manage/token/usage): 用要查詢的 API 金鑰本身鑑權，不需要個人訪問令牌。
- [獲取個人日誌](/zh-Hant/manage/log/self): 需要個人訪問令牌，作用域：`usage:read`（用量 → 檢視）。

普通使用者單次查詢的時間範圍有上限，超出時會返回錯誤。
- [個人日誌統計](/zh-Hant/manage/log/self-stat): 需要個人訪問令牌，作用域：`usage:read`（用量 → 檢視）。

只統計消費類日誌。`rpm`、`tpm` 是最近 60 秒的統計，不受時間範圍引數影響。
- [透過 API 金鑰查詢日誌](/zh-Hant/manage/log/by-token): 用要查詢的 API 金鑰本身鑑權，不需要個人訪問令牌。

返回這個 API 金鑰最近的呼叫日誌，最多 1000 條。
- [獲取個人額度資料](/zh-Hant/manage/log/data-self): 需要個人訪問令牌，作用域：`usage:read`（用量 → 檢視）。
- [獲取充值記錄](/zh-Hant/manage/topup/self): 需要個人訪問令牌，作用域：`wallet:read`（錢包 → 檢視）。
- [使用兌換碼](/zh-Hant/manage/topup/redeem): 需要個人訪問令牌，作用域：`wallet:write`（錢包 → 編輯）。

兌換成功後，額度直接計入賬戶餘額。
- [獲取個人任務](/zh-Hant/manage/task/self): 需要個人訪問令牌，作用域：`usage:read`（用量 → 檢視）。
- [獲取個人 Midjourney 任務](/zh-Hant/manage/task/mj-self): 需要個人訪問令牌，作用域：`usage:read`（用量 → 檢視）。
- [獲取系統狀態](/zh-Hant/manage/public/status): 公開介面，不需要鑑權。
- [獲取定價資訊](/zh-Hant/manage/public/pricing): 公開介面，不需要鑑權。
- [獲取公告](/zh-Hant/manage/public/notice): 公開介面，不需要鑑權。
- [安裝 CC Switch](/zh-Hant/guide/cc-switch): CC Switch 是一款開源的桌面工具，支援 Windows、macOS、Linux，用圖形介面統一管理 Claude Code、Codex、Gemini CLI 等 AI 程式設計工具的「供應商」配置。
- [Claude Code](/zh-Hant/guide/claude-code): 用 CC Switch 把 ZeroCat 配置到 Claude Code，全程圖形介面操作，不用手動修改配置檔案。
- [Codex](/zh-Hant/guide/codex): 用 CC Switch 把 ZeroCat 配置到 Codex，同時適用於 Codex CLI、桌面版和編輯器外掛。
- [DeepSeek Harness](/zh-Hant/guide/deepseek-harness): DeepSeek Harness 是 DeepSeek 官方推出的 AI Agent 桌面客戶端。它支援透過「自定義模型 API」接入中轉站，可以使用 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 三種協議。
- [Factory Droid CLI](/zh-Hant/apps/factory-droid-cli): 安裝 AI 軟體工程助手 Factory Droid CLI，並透過自定義模型接入 ZeroCat。
- [Cherry Studio](/zh-Hant/apps/cherry-studio): 把桌面 AI 客戶端 Cherry Studio 接入 ZeroCat，內建 30+ 專業 AI 助手，覆蓋多種工作場景。
- [DeepChat](/zh-Hant/apps/deepchat): 把全功能 AI Agent 客戶端 DeepChat 接入 ZeroCat，支援一鍵匯入配置。
- [AionUi](/zh-Hant/apps/aionui): 把免費開源的桌面辦公 Agent AionUi 接入 ZeroCat，支援 Gemini CLI、Claude Code、Codex 等多種 AI 代理。
- [AQBot](/zh-Hant/apps/aqbot): 把本地優先的桌面 AI 工作臺 AQBot 接入 ZeroCat，支援 OpenAI、Claude、Gemini 三種協議。
- [OpenClaw](/zh-Hant/apps/openclaw): 安裝自託管 AI 助手平臺 OpenClaw，並把 ZeroCat 配置為模型提供商。支援 Telegram、Discord、WhatsApp 等多渠道。
- [LangBot](/zh-Hant/apps/langbot): 把即時通訊機器人開發平臺 LangBot 接入 ZeroCat，為飛書、釘釘、Telegram、Discord 等平臺的機器人提供 AI 能力。
- [AstrBot](/zh-Hant/apps/astrbot): 把開源 Agent 聊天機器人平臺 AstrBot 接入 ZeroCat，為 QQ、飛書、釘釘、企業微信等即時通訊提供 AI 能力。
- [Memoh](/zh-Hant/apps/memoh): 把自託管容器化 AI 智慧體平臺 Memoh 接入 ZeroCat，為 Telegram、Discord、飛書、QQ、微信等渠道建立有長期記憶的 AI 機器人。
- [流暢閱讀 FluentRead](/zh-Hant/apps/fluent-read): 把開源瀏覽器翻譯外掛流暢閱讀接入 ZeroCat，用大模型實現沉浸式雙語閱讀。
- [LunaTranslator](/zh-Hant/apps/luna-translator): 把開源 GalGame / 視覺小說翻譯器 LunaTranslator 接入 ZeroCat，用大模型提升翻譯質量。
- [常見問題](/zh-Hant/faq): 額度、計費、報錯排查、充值退款和聯絡方式等常見問題。
- [服務條款](/zh-Hant/legal/terms): 您與 ZeroCat LLC 之間關於使用 ZeroCat 服務的協議。
- [隱私政策](/zh-Hant/legal/privacy): ZeroCat LLC 如何收集、使用、儲存、披露及以其他方式處理個人資訊。
- [退款政策](/zh-Hant/legal/refund): 預付額度、退款、賬單異議與拒付規則。
- [使用須知](/zh-Hant/legal/usage): 使用資格、受限制地區、賬戶與 API 憑據、可接受使用規範及 AI 輸出免責宣告。
- [Home](/en/index): Use one API key to call models from multiple providers through OpenAI-, Claude-, and Gemini-compatible interfaces, and connect AI tools such as Claude Code and Codex.
- [Endpoint quick reference](/en/guide/endpoints): ZeroCat's two endpoints and the addresses to use with each client and protocol.
- [Models](/en/user/models): How to view available models, how groups affect models, and which protocol to use.
- [Registration and Sign-in](/en/user/auth): Register a ZeroCat account, sign in with a password, passkey, or third-party account, and reset a forgotten password.
- [Overview and Dashboard](/en/user/dashboard): View your balance, usage, model calls, and service status on the overview and dashboard pages.
- [API Keys](/en/user/token): API keys are credentials for calling ZeroCat. Set credits, models, groups, and source restrictions separately for each key.
- [Wallet and Top-ups](/en/user/wallet): View balance and usage, top up online, redeem codes, buy subscriptions, collect referral rewards, and view order history.
- [Logs and Asynchronous Tasks](/en/user/log): View API request details, drawing records, and asynchronous tasks; filter records and track task status, results, and refunds.
- [Profile and Security](/en/user/profile): Manage account information, notifications and preferences, password, linked accounts, sessions, access tokens, two-factor authentication, and passkeys.
- [Model Marketplace and Leaderboard](/en/user/pricing): View available model prices and status in the Model Marketplace, and model and provider usage rankings on the leaderboard.
- [Using the API and Playground](/en/user/playground): Test models online in the playground or call ZeroCat through OpenAI-, Claude-, and Gemini-compatible interfaces.
- [Chat App Integration](/en/user/chat-apps): Import ZeroCat configuration or configure it manually in AI chat apps.
- [Overview](/en/api/overview): ZeroCat AI model APIs compatible with OpenAI, Anthropic Claude, and Google Gemini formats.
- [列出模型](/en/api/models/list): Get the currently available models. The response format is detected from the request headers: Anthropic format when `x-api-key` and `anthropic-version` are present; Gemini format when `x-goog-api-key` or the `key` query parameter is present; otherwise OpenAI format.
- [列出模型（Gemini 格式）](/en/api/models/list-gemini): Return the available model list in Gemini API format
- [Chat Completions](/en/api/chat/chat-completions): Create a model response from conversation history. Supports streaming and non-streaming responses. Compatible with the OpenAI Chat Completions API.
- [Responses](/en/api/chat/responses): OpenAI Responses API for creating model responses. Supports multi-turn conversations, tool calls, reasoning, and more.
- [Messages（Claude 格式）](/en/api/chat/messages): Anthropic Claude Messages API request format. The `anthropic-version` header is required.
- [Gemini 文本聊天](/en/api/chat/gemini): Proxy Gemini API requests. Path format: `/v1beta/models/{model_name}:{action}`. Examples: `/v1beta/models/gemini-2.5-pro:generateContent` and `/v1beta/models/gemini-2.5-pro:streamGenerateContent?alt=sse`.
- [Gemini 媒体识别](/en/api/chat/gemini-media): Gemini image, PDF, audio, and video recognition request. ⚠️ Native Gemini requests support media via inlineData (base64) or fileData.fileUri (a publicly accessible URL, including YouTube links). Access to file URIs uploaded via the Gemini File API depends on the upstream channel key permissions; publicly accessible URLs are recommended. When OpenAI format (chat/completions) requests are converted to Gemini, media is downloaded and passed as inlineData (base64).
- [Completions](/en/api/completions): Create a text completion from a prompt
- [Embeddings](/en/api/embeddings/openai): Convert text to vector embeddings
- [Embeddings（Gemini 格式）](/en/api/embeddings/gemini): Create embeddings using the specified engine/model
- [文档重排序](/en/api/rerank): Rerank a list of documents by relevance to the query
- [Moderations](/en/api/moderations): Check whether text content violates usage policies
- [生成图像](/en/api/images/generations): Create an image given a prompt. [Learn more](https://platform.openai.com/docs/guides/images).
- [编辑图像](/en/api/images/edits): Create an edited or extended image given an original image and prompt.
- [Gemini 原生格式生图](/en/api/images/gemini): Gemini image generation
- [Gemini 生图（Chat 格式）](/en/api/images/gemini-chat): Gemini image generation
- [通义千问生成图像](/en/api/images/qwen-generations): Bailian Qwen image series generation
- [通义千问编辑图像](/en/api/images/qwen-edits): Bailian Qwen image series editing
- [文本转语音](/en/api/audio/speech): Convert text to audio
- [音频转录](/en/api/audio/transcriptions): Convert audio to text
- [音频翻译](/en/api/audio/translations): Translate audio into English text
- [Gemini 音频理解](/en/api/audio/gemini): Gemini audio generation API. Models such as gemini-2.5-flash-preview-tts can be used.
- [Realtime](/en/api/realtime): Establish a WebSocket connection for a realtime conversation. **Note**: This is a WebSocket endpoint and requires the WebSocket protocol. Example connection URL: `wss://api.example.com/v1/realtime?model=gpt-4o-realtime`.
- [创建视频生成任务](/en/api/videos/create): Submit a video generation task; supports text-to-video and image-to-video. Returns a task ID that can be used to query status via GET.
- [查询视频生成任务](/en/api/videos/get): Query the status and result of a video generation task. Statuses: `queued` (queued), `in_progress` (generating), `completed`, and `failed`.
- [Sora 创建视频](/en/api/videos/sora-create): OpenAI-compatible video generation API. Reference: https://platform.openai.com/docs/api-reference/videos/create
- [Sora 查询任务](/en/api/videos/sora-get): OpenAI-compatible video task status API. Returns detailed status information for the video task.
- [Sora 获取视频内容](/en/api/videos/sora-content): Get the video file content of a completed video task. This endpoint proxies the video file stream.
- [可灵文生视频](/en/api/videos/kling-text2video): Generate video from a text description using a Kling model. Supported models include kling-v1 and kling-v1-5.
- [可灵文生视频查询](/en/api/videos/kling-text2video-get): Query the status and result of a Kling text-to-video task.
- [可灵图生视频](/en/api/videos/kling-image2video): Generate video from an image using a Kling model. The image parameter accepts an image URL or Base64-encoded image data.
- [可灵图生视频查询](/en/api/videos/kling-image2video-get): Query the status and result of a Kling image-to-video task.
- [即梦视频生成](/en/api/videos/jimeng): Video generation API in the official Jimeng API format. The Action parameter specifies the operation: `CVSync2AsyncSubmitTask` submits a video generation task; `CVSync2AsyncGetResult` retrieves the result. Specify Action and Version as query parameters.
- [Overview and authentication](/en/manage/overview): Manage your ZeroCat account from your own system with a personal access token: check balances, manage API keys, view logs, and more.
- [获取当前用户信息](/en/manage/user/self): Requires a personal access token with the `profile:read` scope (Profile → View).
- [更新当前用户信息](/en/manage/user/self-update): Requires a personal access token with the `profile:write` scope (Profile → Edit). This only changes the display name. Changing the password requires security verification in the console.
- [获取当前用户分组](/en/manage/user/groups): Requires a personal access token with the `profile:read` scope (Profile → View).
- [获取可用模型](/en/manage/user/models): Requires a personal access token with the `profile:read` scope (Profile → View).
- [更新用户设置](/en/manage/user/setting): Requires a personal access token with the `profile:write` scope (Profile → Edit). The request body replaces all notification and preference settings; omitted fields revert to their defaults.
- [获取 API 密钥列表](/en/manage/token/list): Requires a personal access token with the `api_key:read` scope (API Keys → View). The returned `key` is masked. To obtain the full key, call [Get full API key](/en/manage/token/key).
- [搜索 API 密钥](/en/manage/token/search): Requires a personal access token with the `api_key:read` scope (API Keys → View).
- [获取指定 API 密钥](/en/manage/token/get): Requires a personal access token with the `api_key:read` scope (API Keys → View).
- [获取完整 API 密钥](/en/manage/token/key): Requires a personal access token with the `api_key:reveal` scope (API Keys → View Full Key). The returned key does not include the `sk-` prefix; use `sk-` + `key` for model calls.
- [创建 API 密钥](/en/manage/token/create): Requires a personal access token with the `api_key:write` scope (API Keys → Edit). Successful creation returns only `success`, not the key. Use [List API keys](/en/manage/token/list) to find the new key ID, then call [Get full API key](/en/manage/token/key).
- [更新 API 密钥](/en/manage/token/update): Requires a personal access token with the `api_key:write` scope (API Keys → Edit). Without `status_only`, the request body overwrites all key settings. First retrieve the current settings with [Get API key](/en/manage/token/get), then modify and submit them in full.
- [删除 API 密钥](/en/manage/token/delete): Requires a personal access token with the `api_key:write` scope (API Keys → Edit).
- [批量删除 API 密钥](/en/manage/token/batch-delete): Requires a personal access token with the `api_key:write` scope (API Keys → Edit).
- [查询 API 密钥用量](/en/manage/token/usage): Authenticate with the API key being queried; no personal access token is required.
- [获取个人日志](/en/manage/log/self): Requires a personal access token with the `usage:read` scope (Usage → View). There is a maximum time range for a single query by an ordinary user; exceeding it returns an error.
- [个人日志统计](/en/manage/log/self-stat): Requires a personal access token with the `usage:read` scope (Usage → View). Only consumption logs are counted. `rpm` and `tpm` cover the last 60 seconds and are unaffected by time range parameters.
- [通过 API 密钥查询日志](/en/manage/log/by-token): Authenticate with the API key being queried; no personal access token is required. Returns up to 1000 recent call logs for this API key.
- [获取个人额度数据](/en/manage/log/data-self): Requires a personal access token with the `usage:read` scope (Usage → View).
- [获取充值记录](/en/manage/topup/self): Requires a personal access token with the `wallet:read` scope (Wallet → View).
- [使用兑换码](/en/manage/topup/redeem): Requires a personal access token with the `wallet:write` scope (Wallet → Edit). On successful redemption, credits are added directly to the account balance.
- [获取个人任务](/en/manage/task/self): Requires a personal access token with the `usage:read` scope (Usage → View).
- [获取个人 Midjourney 任务](/en/manage/task/mj-self): Requires a personal access token with the `usage:read` scope (Usage → View).
- [获取系统状态](/en/manage/public/status): Public endpoint; no authentication required.
- [获取定价信息](/en/manage/public/pricing): Public endpoint; no authentication required.
- [获取公告](/en/manage/public/notice): Public endpoint; no authentication required.
- [Install CC Switch](/en/guide/cc-switch): CC Switch is an open-source desktop tool for Windows, macOS, and Linux that manages providers for Claude Code, Codex, Gemini CLI, and other AI coding tools through a graphical interface.
- [Claude Code](/en/guide/claude-code): Configure ZeroCat in Claude Code using CC Switch's graphical interface, without manually editing configuration files.
- [Codex](/en/guide/codex): Configure ZeroCat in Codex using CC Switch, for the CLI, desktop app, and editor extensions.
- [DeepSeek Harness](/en/guide/deepseek-harness): DeepSeek Harness is DeepSeek's official AI agent desktop client. Its custom model API supports OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages.
- [Factory Droid CLI](/en/apps/factory-droid-cli): Install the Factory Droid CLI AI software engineering assistant and connect it to ZeroCat using a custom model.
- [Cherry Studio](/en/apps/cherry-studio): Connect the Cherry Studio desktop AI client to ZeroCat. Cherry Studio includes more than 30 professional AI assistants for a range of work scenarios.
- [DeepChat](/en/apps/deepchat): Connect the full-featured DeepChat AI agent client to ZeroCat, with one-click configuration import.
- [AionUi](/en/apps/aionui): Connect the free, open-source AionUi desktop work agent to ZeroCat. AionUi supports Gemini CLI, Claude Code, Codex, and other AI agents.
- [AQBot](/en/apps/aqbot): Connect the local-first AQBot desktop AI workbench to ZeroCat using the OpenAI, Claude, or Gemini protocol.
- [OpenClaw](/en/apps/openclaw): Install the self-hosted OpenClaw AI assistant platform and configure ZeroCat as a model provider. OpenClaw supports Telegram, Discord, WhatsApp, and other channels.
- [LangBot](/en/apps/langbot): Connect LangBot, an instant messaging bot development platform, to ZeroCat to provide AI capabilities for bots on Feishu, DingTalk, Telegram, Discord, and other platforms.
- [AstrBot](/en/apps/astrbot): Connect the open-source AstrBot agent chatbot platform to ZeroCat to add AI capabilities to QQ, Feishu, DingTalk, WeCom, and other messaging services.
- [Memoh](/en/apps/memoh): Connect the self-hosted, containerized Memoh AI agent platform to ZeroCat to create bots with long-term memory for Telegram, Discord, Feishu, QQ, WeChat, and other channels.
- [FluentRead](/en/apps/fluent-read): Connect the open-source FluentRead browser translation extension to ZeroCat for immersive bilingual reading with large models.
- [LunaTranslator](/en/apps/luna-translator): Connect the open-source GalGame and visual novel translator LunaTranslator to ZeroCat to improve translation quality with large models.
- [Frequently Asked Questions](/en/faq): Frequently asked questions about credits, billing, troubleshooting, top-ups, refunds, and contact information.
- [Terms of Service](/en/legal/terms): Your agreement with ZeroCat LLC governing use of ZeroCat services.
- [Privacy Policy](/en/legal/privacy): How ZeroCat LLC collects, uses, stores, discloses, and otherwise processes personal information.
- [Refund Policy](/en/legal/refund): Rules for prepaid credits, refunds, billing disputes, and chargebacks.
- [Usage Notice](/en/legal/usage): Eligibility, restricted regions, account and API credentials, acceptable use, and AI output disclaimers.
- [ホーム](/ja/index): 1つの API キーで OpenAI、Claude、Gemini 互換インターフェースを通じて複数の大規模モデルを呼び出し、Claude Code や Codex などの AI ツールと連携できます。
- [接続アドレス早見表](/ja/guide/endpoints): ZeroCat の2つの接続エンドポイントと、クライアント・プロトコルごとのアドレス指定方法
- [モデルの説明](/ja/user/models): 利用可能なモデルの確認方法、グループがモデルに与える影響、モデルごとに使用するプロトコルを説明します。
- [登録とログイン](/ja/user/auth): ZeroCat アカウントを登録し、アカウントとパスワード、Passkey、またはサードパーティアカウントでログインする方法と、パスワードの再設定について説明します。
- [概要とダッシュボード](/ja/user/dashboard): 概要ページとダッシュボードで残高、使用量、モデルの呼び出し状況、サービスの状態を確認します。
- [API キー](/ja/user/token): API キーは ZeroCat を呼び出すための認証情報です。キーごとに利用枠、モデル、グループ、アクセス元の制限を設定できます。
- [ウォレットとチャージ](/ja/user/wallet): 残高と使用量の確認、オンラインチャージ、引換コードの使用、サブスクリプションの購入、招待報酬の受け取り、注文履歴の確認。
- [ログと非同期タスク](/ja/user/log): API リクエストの明細、画像生成記録、非同期タスクを確認し、条件で絞り込んでタスクの状態、結果、返金を追跡します。
- [プロフィールとセキュリティ](/ja/user/profile): アカウント情報、通知と設定、パスワード、アカウント連携、ログインセッション、アクセストークン、2段階認証、Passkey を管理します。
- [モデル広場とランキング](/ja/user/pricing): モデル広場で利用可能なモデルの価格と状態を確認し、ランキングでモデルとプロバイダーの使用量順位を確認します。
- [API とプレイグラウンドの使用](/ja/user/playground): プレイグラウンドでモデルをオンラインテストするか、OpenAI、Claude、Gemini 互換インターフェースで ZeroCat を呼び出します。
- [チャットアプリ連携](/ja/user/chat-apps): ZeroCat の設定をさまざまな AI チャットアプリにワンクリックでインポート、または手動で設定します。
- [概要](/ja/api/overview): OpenAI、Anthropic Claude、Google Gemini 形式に対応する ZeroCat の AI モデルインターフェース。
- [モデル一覧](/ja/api/models/list): 現在利用可能なモデル一覧を取得します。

リクエストヘッダーから返却形式を自動判定します：
- `x-api-key` と `anthropic-version` ヘッダーがある場合は Anthropic 形式
- `x-goog-api-key` ヘッダーまたは `key` クエリパラメーターがある場合は Gemini 形式
- その他の場合は OpenAI 形式
- [モデル一覧（Gemini 形式）](/ja/api/models/list-gemini): 利用可能なモデル一覧を Gemini API 形式で返します
- [Chat Completions](/ja/api/chat/chat-completions): 会話履歴に基づきモデルの応答を作成します。ストリーミングと非ストリーミングの応答に対応します。

OpenAI Chat Completions API と互換性があります。
- [Responses](/ja/api/chat/responses): モデル応答を作成する OpenAI Responses API。
複数ターンの会話、ツール呼び出し、推論などに対応します。
- [Messages（Claude 形式）](/ja/api/chat/messages): Anthropic Claude Messages API 形式のリクエスト。
リクエストヘッダーに `anthropic-version` を含める必要があります。
- [Gemini テキストチャット](/ja/api/chat/gemini): Gemini API リクエストをプロキシします。
パス形式：`/v1beta/models/{model_name}:{action}`

例：
- `/v1beta/models/gemini-2.5-pro:generateContent`
- `/v1beta/models/gemini-2.5-pro:streamGenerateContent?alt=sse`
- [Gemini メディア認識](/ja/api/chat/gemini-media): Gemini の画像、PDF、音声、動画認識リクエスト

⚠️注意：ネイティブ Gemini 形式のリクエストでは inlineData（base64）または fileData.fileUri（公開アクセス可能な URL。YouTube リンクに対応）でメディアを渡せます。Gemini File API でアップロードしたファイル URI にアクセスできるかは上流チャネルの Key の権限によって異なるため、公開アクセス可能な URL の使用を推奨します。OpenAI 形式（chat/completions）のリクエストを Gemini に変換する場合、メディアはすべてダウンロードされ、inlineData（base64）に変換して渡されます。
- [Completions](/ja/api/completions): 指定されたプロンプトに基づきテキスト補完を作成
- [Embeddings](/ja/api/embeddings/openai): テキストをベクトル埋め込みに変換
- [Embeddings（Gemini 形式）](/ja/api/embeddings/gemini): 指定されたエンジン / モデルで埋め込みを作成
- [ドキュメントのリランキング](/ja/api/rerank): クエリに基づきドキュメント一覧を関連度順に並べ替え
- [Moderations](/ja/api/moderations): テキスト内容が利用ポリシーに違反していないか確認
- [画像を生成](/ja/api/images/generations): プロンプトを指定して画像を作成します。[詳細](https://platform.openai.com/docs/guides/images)。
- [画像を編集](/ja/api/images/edits): 元画像とプロンプトを指定して、編集または拡張した画像を作成します。
- [Gemini ネイティブ形式の画像生成](/ja/api/images/gemini): Gemini 画像生成
- [Gemini 画像生成（Chat 形式）](/ja/api/images/gemini-chat): Gemini 画像生成
- [通义千问の画像生成](/ja/api/images/qwen-generations): 百炼 qwen-image 系列の画像生成
- [通义千问の画像編集](/ja/api/images/qwen-edits): 百炼 qwen-image 系列の画像編集
- [テキスト読み上げ](/ja/api/audio/speech): テキストを音声に変換
- [音声の文字起こし](/ja/api/audio/transcriptions): 音声をテキストに変換
- [音声翻訳](/ja/api/audio/translations): 音声を英語のテキストに翻訳
- [Gemini 音声理解](/ja/api/audio/gemini): Gemini 音声生成インターフェース。
gemini-2.5-flash-preview-tts などのモデルを使用できます
- [Realtime](/ja/api/realtime): リアルタイム会話用の WebSocket 接続を確立します。

**注意**：これは WebSocket エンドポイントであり、WebSocket プロトコルで接続する必要があります。

接続 URL の例：`wss://api.example.com/v1/realtime?model=gpt-4o-realtime`
- [動画生成タスクを作成](/ja/api/videos/create): 動画生成タスクを送信します。テキストからの動画生成と画像からの動画生成に対応します。

タスク ID が返され、GET インターフェースでタスクの状態を照会できます。
- [動画生成タスクを照会](/ja/api/videos/get): 動画生成タスクの状態と結果を照会します。

タスクの状態：
- `queued`：順番待ち
- `in_progress`：生成中
- `completed`：完了
- `failed`：失敗
- [Sora 動画を作成](/ja/api/videos/sora-create): OpenAI 互換の動画生成インターフェース。

参考ドキュメント：https://platform.openai.com/docs/api-reference/videos/create
- [Sora タスクを照会](/ja/api/videos/sora-get): OpenAI 互換の動画タスク状態照会インターフェース。

動画タスクの詳細な状態情報を返します。
- [Sora 動画コンテンツを取得](/ja/api/videos/sora-content): 完了した動画タスクの動画ファイルの内容を取得します。

このインターフェースは動画ファイルのストリームをプロキシして返します。
- [可灵のテキストからの動画生成](/ja/api/videos/kling-text2video): Kling モデルを使用してテキストの説明から動画を生成します。

対応モデル：kling-v1、kling-v1-5 など
- [可灵のテキストからの動画生成を照会](/ja/api/videos/kling-text2video-get): Kling のテキストからの動画生成タスクの状態と結果を照会します。
- [可灵の画像からの動画生成](/ja/api/videos/kling-image2video): Kling モデルを使用して画像から動画を生成します。

image パラメーターに画像 URL または Base64 エンコードされた画像データを渡せます。
- [可灵の画像からの動画生成を照会](/ja/api/videos/kling-image2video-get): Kling の画像からの動画生成タスクの状態と結果を照会します。
- [即梦の動画生成](/ja/api/videos/jimeng): 即梦公式 API 形式の動画生成インターフェース。

Action パラメーターで操作の種類を指定できます：
- `CVSync2AsyncSubmitTask`：動画生成タスクを送信
- `CVSync2AsyncGetResult`：タスク結果を取得

クエリパラメーターで Action と Version を指定する必要があります。
- [概要と認証](/ja/manage/overview): 個人アクセストークンを使って自分のシステムから ZeroCat アカウントを管理します。残高の照会、API キーの管理、ログの確認などができます。
- [現在のユーザー情報を取得](/ja/manage/user/self): 個人アクセストークンが必要です。スコープ：`profile:read`（プロフィール → 閲覧）。
- [現在のユーザー情報を更新](/ja/manage/user/self-update): 個人アクセストークンが必要です。スコープ：`profile:write`（プロフィール → 編集）。

表示名の変更専用です。パスワードの変更にはセキュリティ認証が必要なため、コンソールで操作してください。
- [現在のユーザーグループを取得](/ja/manage/user/groups): 個人アクセストークンが必要です。スコープ：`profile:read`（プロフィール → 閲覧）。
- [利用可能なモデルを取得](/ja/manage/user/models): 個人アクセストークンが必要です。スコープ：`profile:read`（プロフィール → 閲覧）。
- [ユーザー設定を更新](/ja/manage/user/setting): 個人アクセストークンが必要です。スコープ：`profile:write`（プロフィール → 編集）。

通知と設定がリクエスト本文で全体的に上書きされ、送信されなかったフィールドは既定値に戻ります。
- [API キー一覧を取得](/ja/manage/token/list): 個人アクセストークンが必要です。スコープ：`api_key:read`（API キー → 閲覧）。

返される `key` はマスク済みです。完全なキーが必要な場合は [完全な API キーを取得](/ja/manage/token/key) を呼び出してください。
- [API キーを検索](/ja/manage/token/search): 個人アクセストークンが必要です。スコープ：`api_key:read`（API キー → 閲覧）。
- [指定した API キーを取得](/ja/manage/token/get): 個人アクセストークンが必要です。スコープ：`api_key:read`（API キー → 閲覧）。
- [完全な API キーを取得](/ja/manage/token/key): 個人アクセストークンが必要です。スコープ：`api_key:reveal`（API キー → 完全なキーの閲覧）。

返されるキーには `sk-` プレフィックスが含まれません。モデルの呼び出し時は `sk-` + `key` としてください。
- [API キーを作成](/ja/manage/token/create): 個人アクセストークンが必要です。スコープ：`api_key:write`（API キー → 編集）。

作成成功時は `success` のみを返し、キーは返しません。その後 [API キー一覧を取得](/ja/manage/token/list) で新しいキーの ID を探し、[完全な API キーを取得](/ja/manage/token/key) を呼び出してください。
- [API キーを更新](/ja/manage/token/update): 個人アクセストークンが必要です。スコープ：`api_key:write`（API キー → 編集）。

`status_only` がない場合、リクエスト本文でキーのすべての設定が上書きされます。まず [指定した API キーを取得](/ja/manage/token/get) で現在の設定を取得し、変更後に全体を送信してください。
- [API キーを削除](/ja/manage/token/delete): 個人アクセストークンが必要です。スコープ：`api_key:write`（API キー → 編集）。
- [API キーを一括削除](/ja/manage/token/batch-delete): 個人アクセストークンが必要です。スコープ：`api_key:write`（API キー → 編集）。
- [API キーの使用量を照会](/ja/manage/token/usage): 照会対象の API キー自体で認証し、個人アクセストークンは不要です。
- [個人ログを取得](/ja/manage/log/self): 個人アクセストークンが必要です。スコープ：`usage:read`（使用量 → 閲覧）。

一般ユーザーの1回の照会期間には上限があり、超過するとエラーを返します。
- [個人ログ統計](/ja/manage/log/self-stat): 個人アクセストークンが必要です。スコープ：`usage:read`（使用量 → 閲覧）。

消費ログのみを集計します。`rpm`、`tpm` は直近60秒の統計で、期間パラメーターの影響を受けません。
- [API キーでログを照会](/ja/manage/log/by-token): 照会対象の API キー自体で認証し、個人アクセストークンは不要です。

この API キーの最近の呼び出しログを最大1000件返します。
- [個人の利用枠データを取得](/ja/manage/log/data-self): 個人アクセストークンが必要です。スコープ：`usage:read`（使用量 → 閲覧）。
- [チャージ記録を取得](/ja/manage/topup/self): 個人アクセストークンが必要です。スコープ：`wallet:read`（ウォレット → 閲覧）。
- [引換コードを使用](/ja/manage/topup/redeem): 個人アクセストークンが必要です。スコープ：`wallet:write`（ウォレット → 編集）。

引き換えに成功すると利用枠がアカウント残高に直接加算されます。
- [個人タスクを取得](/ja/manage/task/self): 個人アクセストークンが必要です。スコープ：`usage:read`（使用量 → 閲覧）。
- [個人の Midjourney タスクを取得](/ja/manage/task/mj-self): 個人アクセストークンが必要です。スコープ：`usage:read`（使用量 → 閲覧）。
- [システム状態を取得](/ja/manage/public/status): 公開インターフェース。認証不要です。
- [価格情報を取得](/ja/manage/public/pricing): 公開インターフェース。認証不要です。
- [お知らせを取得](/ja/manage/public/notice): 公開インターフェース。認証不要です。
- [CC Switch のインストール](/ja/guide/cc-switch): CC Switch は Windows、macOS、Linux に対応するオープンソースのデスクトップツールで、Claude Code、Codex、Gemini CLI などの AI コーディングツールの「プロバイダー」設定を GUI で一元管理します。
- [Claude Code](/ja/guide/claude-code): CC Switch を使って ZeroCat を Claude Code に設定します。設定ファイルを手動で変更せず、すべて GUI で操作できます。
- [Codex](/ja/guide/codex): CC Switch で ZeroCat を Codex に設定します。Codex CLI、デスクトップ版、エディタープラグインに対応します。
- [DeepSeek Harness](/ja/guide/deepseek-harness): DeepSeek Harness は DeepSeek 公式の AI Agent デスクトップクライアントです。「カスタムモデル API」で中継サービスに接続し、OpenAI Chat Completions、OpenAI Responses、Anthropic Messages の3つのプロトコルを使用できます。
- [Factory Droid CLI](/ja/apps/factory-droid-cli): AI ソフトウェアエンジニアリングアシスタント Factory Droid CLI をインストールし、カスタムモデルで ZeroCat に接続します。
- [Cherry Studio](/ja/apps/cherry-studio): デスクトップ AI クライアント Cherry Studio を ZeroCat に接続します。30以上の専門 AI アシスタントを内蔵し、さまざまな仕事に対応します。
- [DeepChat](/ja/apps/deepchat): 高機能 AI Agent クライアント DeepChat を ZeroCat に接続します。設定のワンクリックインポートに対応しています。
- [AionUi](/ja/apps/aionui): 無料のオープンソースデスクトップ Cowork Agent AionUi を ZeroCat に接続します。Gemini CLI、Claude Code、Codex などの AI エージェントに対応します。
- [AQBot](/ja/apps/aqbot): ローカル優先のデスクトップ AI ワークベンチ AQBot を ZeroCat に接続します。OpenAI、Claude、Gemini の3つのプロトコルに対応します。
- [OpenClaw](/ja/apps/openclaw): セルフホスト型 AI アシスタントプラットフォーム OpenClaw をインストールし、ZeroCat をモデルプロバイダーとして設定します。Telegram、Discord、WhatsApp など複数チャネルに対応します。
- [LangBot](/ja/apps/langbot): メッセージボット開発プラットフォーム LangBot を ZeroCat に接続し、飞书、钉钉、Telegram、Discord などのボットに AI 機能を提供します。
- [AstrBot](/ja/apps/astrbot): オープンソースの Agent チャットボットプラットフォーム AstrBot を ZeroCat に接続し、QQ、飛书、钉钉、企业微信などのメッセージサービスに AI 機能を提供します。
- [Memoh](/ja/apps/memoh): セルフホスト型コンテナー AI エージェントプラットフォーム Memoh を ZeroCat に接続し、Telegram、Discord、飞书、QQ、微信 などのチャネルに長期記憶を持つ AI ボットを作成します。
- [流畅阅读 FluentRead](/ja/apps/fluent-read): オープンソースのブラウザー翻訳拡張機能 FluentRead を ZeroCat に接続し、大規模モデルによる没入型のバイリンガル読書を実現します。
- [LunaTranslator](/ja/apps/luna-translator): オープンソースの GalGame / ビジュアルノベル翻訳ツール LunaTranslator を ZeroCat に接続し、大規模モデルで翻訳品質を向上させます。
- [よくある質問](/ja/faq): 利用枠、課金、エラーの調査、チャージと返金、連絡先などに関するよくある質問。
- [利用規約](/ja/legal/terms): ZeroCat サービスの利用に関するお客様と ZeroCat LLC の間の契約。
- [プライバシーポリシー](/ja/legal/privacy): ZeroCat LLC による個人情報の収集、使用、保存、開示、その他の処理について。
- [返金ポリシー](/ja/legal/refund): 前払い利用枠、返金、請求への異議、チャージバックに関する規則。
- [利用上の注意](/ja/legal/usage): 利用資格、制限対象地域、アカウントと API 認証情報、許容される使用規範、AI 出力に関する免責事項。
- [Accueil](/fr/index): Avec une seule clé API, accédez à des modèles de plusieurs fournisseurs via des interfaces compatibles avec OpenAI, Claude et Gemini, ainsi qu’à des outils d’IA tels que Claude Code et Codex.
- [Adresses de connexion](/fr/guide/endpoints): Les deux points d’accès ZeroCat et les formats d’adresse selon le client et le protocole.
- [Présentation des modèles](/fr/user/models): Découvrez les modèles disponibles, l’effet des groupes et le protocole à utiliser selon le modèle.
- [Inscription et connexion](/fr/user/auth): Créez un compte ZeroCat et connectez-vous avec un mot de passe, une clé d’accès ou un compte tiers ; réinitialisez votre mot de passe si nécessaire.
- [Vue d’ensemble et tableau de bord](/fr/user/dashboard): Consultez votre solde, votre utilisation, les appels aux modèles et l’état du service.
- [Clés API](/fr/user/token): Les clés API permettent d’appeler ZeroCat. Configurez séparément le quota, les modèles, le groupe et les restrictions d’origine de chaque clé.
- [Portefeuille et recharge](/fr/user/wallet): Consultez votre solde et votre utilisation, rechargez en ligne, utilisez un code, achetez un abonnement et consultez vos récompenses et commandes.
- [Journaux et tâches asynchrones](/fr/user/log): Consultez les appels API, les dessins et les tâches asynchrones ; filtrez et suivez leur état, leurs résultats et les remboursements.
- [Profil et sécurité](/fr/user/profile): Gérez votre compte, vos notifications et préférences, votre mot de passe, vos comptes liés, sessions, jetons, validation en deux étapes et clés d’accès.
- [Catalogue et classement des modèles](/fr/user/pricing): Consultez les prix et l’état des modèles, ainsi que les classements d’utilisation des modèles et fournisseurs.
- [Utiliser l’API et le bac à sable](/fr/user/playground): Testez les modèles en ligne ou appelez ZeroCat avec les interfaces compatibles OpenAI, Claude et Gemini.
- [Intégration aux applications de chat](/fr/user/chat-apps): Importez ZeroCat en un clic ou configurez-le manuellement dans des applications de chat IA.
- [Vue d’ensemble](/fr/api/overview): Interfaces de modèles IA ZeroCat compatibles avec les formats OpenAI, Anthropic Claude et Google Gemini.
- [Lister les modèles](/fr/api/models/list): Obtenir les modèles actuellement disponibles. Le format dépend des en-têtes : Anthropic avec `x-api-key` et `anthropic-version` ; Gemini avec `x-goog-api-key` ou le paramêtre `key` ; sinon OpenAI.
- [Lister les modèles (format Gemini)](/fr/api/models/list-gemini): Renvoyer les modèles disponibles au format API Gemini
- [Chat Completions](/fr/api/chat/chat-completions): Créer une réponse à partir de l’historique de conversation, avec ou sans streaming. Compatible avec l’API OpenAI Chat Completions.
- [Responses](/fr/api/chat/responses): API OpenAI Responses pour créer des réponses de modèle. Prend en charge les conversations à plusieurs tours, les appels d’outils, le raisonnement et d’autres fonctions.
- [Messages (format Claude)](/fr/api/chat/messages): Format de requête de l’API Anthropic Claude Messages. L’en-tête `anthropic-version` est obligatoire.
- [Chat textuel Gemini](/fr/api/chat/gemini): Transmet les requêtes API Gemini. Format du chemin : `/v1beta/models/{model_name}:{action}`. Exemples : `/v1beta/models/gemini-2.5-pro:generateContent` et `/v1beta/models/gemini-2.5-pro:streamGenerateContent?alt=sse`.
- [Reconnaissance de médias Gemini](/fr/api/chat/gemini-media): Requête Gemini de reconnaissance d’image, PDF, audio et vidéo. Attention : les requêtes natives acceptent les médias par inlineData (base64) ou fileData.fileUri (URL publique, y compris YouTube). L’accès aux URI téléversés via Gemini File API dépend des autorisations de la clé du canal en amont ; les URL publiques sont recommandées. Lors de la conversion de requêtes OpenAI (chat/completions) vers Gemini, les médias sont téléchargés et transmis par inlineData (base64).
- [Completions](/fr/api/completions): Créer une complétion de texte à partir d’un prompt
- [Embeddings](/fr/api/embeddings/openai): Convertir du texte en embeddings vectoriels
- [Embeddings (format Gemini)](/fr/api/embeddings/gemini): Créer des embeddings avec le moteur ou modèle indiqué
- [Rerank des documents](/fr/api/rerank): Classer les documents selon leur pertinence pour la requête
- [Moderations](/fr/api/moderations): Vérifier si le texte enfreint les règles d’utilisation
- [Générer une image](/fr/api/images/generations): Créer une image à partir d’un prompt. [En savoir plus](https://platform.openai.com/docs/guides/images).
- [Modifier une image](/fr/api/images/edits): Créer une image modifiée ou étendue à partir d’une image et d’un prompt.
- [Génération d’images au format natif Gemini](/fr/api/images/gemini): Génération d’images Gemini
- [Génération d’images Gemini (format Chat)](/fr/api/images/gemini-chat): Génération d’images Gemini
- [Générer une image avec Qwen](/fr/api/images/qwen-generations): Génération d’images avec la série Qwen de Bailian
- [Modifier une image avec Qwen](/fr/api/images/qwen-edits): Modification d’images avec la série Qwen de Bailian
- [Synthèse vocale](/fr/api/audio/speech): Convertir du texte en audio
- [Transcription audio](/fr/api/audio/transcriptions): Convertir l’audio en texte
- [Traduction audio](/fr/api/audio/translations): Traduire l’audio en texte anglais
- [Compréhension audio Gemini](/fr/api/audio/gemini): API de génération audio Gemini. Des modèles tels que gemini-2.5-flash-preview-tts peuvent être utilisés.
- [Realtime](/fr/api/realtime): Établir une connexion WebSocket pour une conversation en temps réel. **Note** : ce point d’accès nécessite le protocole WebSocket. Exemple : `wss://api.example.com/v1/realtime?model=gpt-4o-realtime`.
- [Créer une tâche de génération vidéo](/fr/api/videos/create): Soumettre une tâche de génération vidéo depuis du texte ou une image. Renvoie un ID permettant de consulter son statut par GET.
- [Consulter une tâche de génération vidéo](/fr/api/videos/get): Consulter le statut et le résultat d’une tâche vidéo. Statuts : `queued` (en attente), `in_progress` (génération), `completed` (terminée) et `failed` (échouée).
- [Créer une vidéo Sora](/fr/api/videos/sora-create): API de génération vidéo compatible OpenAI. Référence : https://platform.openai.com/docs/api-reference/videos/create
- [Consulter une tâche Sora](/fr/api/videos/sora-get): API de statut des tâches vidéo compatible OpenAI. Renvoie les détails du statut de la tâche.
- [Obtenir le contenu vidéo Sora](/fr/api/videos/sora-content): Obtenir le fichier vidéo d’une tâche terminée. Ce point d’accès transmet le flux du fichier.
- [Générer une vidéo Kling à partir de texte](/fr/api/videos/kling-text2video): Générer une vidéo à partir d’une description textuelle avec un modèle Kling. Les modèles pris en charge comprennent kling-v1 et kling-v1-5.
- [Consulter une génération vidéo Kling à partir de texte](/fr/api/videos/kling-text2video-get): Consulter le statut et le résultat d’une tâche Kling texte-vers-vidéo.
- [Générer une vidéo Kling à partir d’une image](/fr/api/videos/kling-image2video): Générer une vidéo à partir d’une image avec un modèle Kling. Le paramètre image accepte une URL ou des données encodées en Base64.
- [Consulter une génération vidéo Kling à partir d’une image](/fr/api/videos/kling-image2video-get): Consulter le statut et le résultat d’une tâche Kling image-vers-vidéo.
- [Génération vidéo Jimeng](/fr/api/videos/jimeng): API de génération vidéo au format officiel Jimeng. Le paramètre Action indique l’opération : `CVSync2AsyncSubmitTask` soumet une tâche et `CVSync2AsyncGetResult` récupère son résultat. Indiquez Action et Version comme paramètres de requête.
- [Vue d’ensemble et authentification](/fr/manage/overview): Gérez votre compte ZeroCat depuis vos systèmes avec un jeton d’accès personnel : solde, clés API et journaux.
- [Obtenir les informations de l’utilisateur actuel](/fr/manage/user/self): Nécessite un jeton personnel avec `profile:read` (Profil → Voir).
- [Modifier les informations de l’utilisateur actuel](/fr/manage/user/self-update): Nécessite un jeton personnel avec `profile:write` (Profil → Modifier). Seul le nom affiché est modifié. Le changement de mot de passe nécessite une vérification de sécurité dans la console.
- [Obtenir les groupes de l’utilisateur actuel](/fr/manage/user/groups): Nécessite un jeton personnel avec `profile:read` (Profil → Voir).
- [Obtenir les modèles disponibles](/fr/manage/user/models): Nécessite un jeton personnel avec `profile:read` (Profil → Voir).
- [Modifier les paramètres utilisateur](/fr/manage/user/setting): Nécessite un jeton personnel avec `profile:write` (Profil → Modifier). Le corps remplace tous les paramètres de notification et préférences ; les champs omis reprennent leur valeur par défaut.
- [Lister les clés API](/fr/manage/token/list): Nécessite un jeton personnel avec `api_key:read` (Clés API → Voir). La `key` renvoyée est masquée. Pour la clé complète, appelez [Obtenir la clé API complète](/fr/manage/token/key).
- [Rechercher des clés API](/fr/manage/token/search): Nécessite un jeton personnel avec `api_key:read` (Clés API → Voir).
- [Obtenir une clé API](/fr/manage/token/get): Nécessite un jeton personnel avec `api_key:read` (Clés API → Voir).
- [Obtenir la clé API complète](/fr/manage/token/key): Nécessite un jeton personnel avec `api_key:reveal` (Clés API → Voir la clé complète). La clé renvoyée ne contient pas le préfixe `sk-` ; utilisez `sk-` + `key` pour appeler les modèles.
- [Créer une clé API](/fr/manage/token/create): Nécessite un jeton personnel avec `api_key:write` (Clés API → Modifier). La création réussie renvoie seulement `success`, pas la clé. Utilisez [Lister les clés API](/fr/manage/token/list) pour trouver l’ID, puis [Obtenir la clé API complète](/fr/manage/token/key).
- [Modifier une clé API](/fr/manage/token/update): Nécessite un jeton personnel avec `api_key:write` (Clés API → Modifier). Sans `status_only`, le corps écrase tous les paramètres. Récupérez d’abord les paramètres avec [Obtenir une clé API](/fr/manage/token/get), puis modifiez-les et soumettez-les intégralement.
- [Supprimer une clé API](/fr/manage/token/delete): Nécessite un jeton personnel avec la portée `api_key:write` (Clés API → Modifier).
- [Supprimer des clés API en lot](/fr/manage/token/batch-delete): Nécessite un jeton personnel avec la portée `api_key:write` (Clés API → Modifier).
- [Consulter l’utilisation d’une clé API](/fr/manage/token/usage): Authentification avec la clé API consultée ; aucun jeton personnel requis.
- [Obtenir les journaux personnels](/fr/manage/log/self): Nécessite un jeton personnel avec `usage:read` (Utilisation → Voir). La période d’une requête d’utilisateur ordinaire est limitée ; son dépassement renvoie une erreur.
- [Statistiques des journaux personnels](/fr/manage/log/self-stat): Nécessite un jeton personnel avec `usage:read` (Utilisation → Voir). Seuls les journaux de consommation sont comptés. `rpm` et `tpm` couvrent les 60 dernières secondes, indépendamment de la période demandée.
- [Consulter les journaux avec une clé API](/fr/manage/log/by-token): Authentification avec la clé API consultée, sans jeton personnel. Renvoie au plus 1000 appels récents de cette clé.
- [Obtenir les données de quota personnelles](/fr/manage/log/data-self): Nécessite un jeton personnel avec `usage:read` (Utilisation → Voir).
- [Obtenir l’historique des recharges](/fr/manage/topup/self): Nécessite un jeton personnel avec `wallet:read` (Portefeuille → Voir).
- [Utiliser un code de recharge](/fr/manage/topup/redeem): Nécessite un jeton personnel avec `wallet:write` (Portefeuille → Modifier). Après utilisation réussie, les crédits sont ajoutés directement au solde.
- [Obtenir les tâches personnelles](/fr/manage/task/self): Nécessite un jeton personnel avec `usage:read` (Utilisation → Voir).
- [Obtenir les tâches Midjourney personnelles](/fr/manage/task/mj-self): Nécessite un jeton personnel avec `usage:read` (Utilisation → Voir).
- [Obtenir l’état du système](/fr/manage/public/status): Point d’accès public sans authentification.
- [Obtenir les tarifs](/fr/manage/public/pricing): Point d’accès public sans authentification.
- [Obtenir les annonces](/fr/manage/public/notice): Point d’accès public sans authentification.
- [Installer CC Switch](/fr/guide/cc-switch): CC Switch est un outil de bureau open source pour Windows, macOS et Linux qui gère graphiquement les fournisseurs de Claude Code, Codex, Gemini CLI et autres outils de programmation IA.
- [Claude Code](/fr/guide/claude-code): Configurez ZeroCat dans Claude Code avec CC Switch, entièrement par interface graphique.
- [Codex](/fr/guide/codex): Configurez ZeroCat avec CC Switch pour Codex CLI, l’application de bureau et les extensions d’éditeur.
- [DeepSeek Harness](/fr/guide/deepseek-harness): DeepSeek Harness est le client de bureau officiel d’agent IA DeepSeek. Son API de modèle personnalisée accepte les protocoles OpenAI Chat Completions, OpenAI Responses et Anthropic Messages.
- [Factory Droid CLI](/fr/apps/factory-droid-cli): Installez l’assistant d’ingénierie logicielle Factory Droid CLI et connectez-le à ZeroCat avec des modèles personnalisés.
- [Cherry Studio](/fr/apps/cherry-studio): Connectez le client IA de bureau Cherry Studio à ZeroCat ; il comprend plus de 30 assistants spécialisés pour divers usages professionnels.
- [DeepChat](/fr/apps/deepchat): Connectez le client Agent IA complet DeepChat à ZeroCat, avec import de configuration en un clic.
- [AionUi](/fr/apps/aionui): Connectez AionUi, agent de bureau gratuit et open source, à ZeroCat ; il prend en charge Gemini CLI, Claude Code, Codex et d’autres agents IA.
- [AQBot](/fr/apps/aqbot): Connectez le poste de travail IA local AQBot à ZeroCat avec les protocoles OpenAI, Claude et Gemini.
- [OpenClaw](/fr/apps/openclaw): Installez la plateforme d’assistant IA auto-hébergée OpenClaw et configurez ZeroCat comme fournisseur de modèles pour Telegram, Discord, WhatsApp et autres canaux.
- [LangBot](/fr/apps/langbot): Connectez LangBot à ZeroCat pour doter d’IA vos bots Feishu, DingTalk, Telegram, Discord et autres.
- [AstrBot](/fr/apps/astrbot): Connectez la plateforme open source de chatbot Agent AstrBot à ZeroCat pour apporter l’IA à QQ, Feishu, DingTalk, WeCom et autres messageries.
- [Memoh](/fr/apps/memoh): Connectez la plateforme d’agents IA conteneurisée et auto-hébergée Memoh à ZeroCat pour créer des bots à mémoire persistante sur Telegram, Discord, Feishu, QQ, WeChat et autres.
- [FluentRead](/fr/apps/fluent-read): Connectez l’extension de traduction open source FluentRead à ZeroCat pour lire en deux langues avec un grand modèle.
- [LunaTranslator](/fr/apps/luna-translator): Connectez le traducteur open source de romans visuels LunaTranslator à ZeroCat pour améliorer la traduction avec un grand modèle.
- [Questions fréquentes](/fr/faq): Questions sur les quotas, la facturation, les erreurs, les recharges, les remboursements et les contacts.
- [Conditions d’utilisation](/fr/legal/terms): Accord entre vous et ZeroCat LLC concernant l’utilisation des services ZeroCat.
- [Politique de confidentialité](/fr/legal/privacy): Comment ZeroCat LLC collecte, utilise, stocke, divulgue et traite les informations personnelles.
- [Politique de remboursement](/fr/legal/refund): Règles relatives aux crédits prépayés, remboursements, contestations de facturation et rétrofacturations.
- [Consignes d’utilisation](/fr/legal/usage): Admissibilité, territoires restreints, comptes et identifiants API, règles d’utilisation acceptable et exclusion de responsabilité relative aux Sorties IA.
- [Inici](/ca/index): Una clau d'API per accedir a models de diversos proveïdors mitjançant interfícies compatibles amb OpenAI, Claude i Gemini, i connectar eines d'IA com Claude Code i Codex.
- [Referència ràpida d'adreces](/ca/guide/endpoints): Els dos punts d'accés de ZeroCat i el format de l'adreça per a cada client i protocol
- [Models](/ca/user/models): Com consultar els models disponibles, l'efecte dels grups i el protocol que cal utilitzar per a cada model.
- [Registre i inici de sessió](/ca/user/auth): Registra un compte de ZeroCat, inicia la sessió amb contrasenya, Passkey o un compte de tercers i recupera la contrasenya.
- [Vista general i tauler de dades](/ca/user/dashboard): Consulta el saldo, l'ús, les crides als models i l'estat del servei a la vista general i al tauler de dades.
- [Claus d'API](/ca/user/token): Les claus d'API permeten accedir a ZeroCat. Cada clau pot tenir límits de crèdits, models, grup i origen.
- [Cartera i recàrregues](/ca/user/wallet): Consulta el saldo i l'ús, recarrega en línia, bescanvia codis, compra subscripcions, rep recompenses per invitacions i consulta les comandes.
- [Registres i tasques asíncrones](/ca/user/log): Consulta els detalls de peticions d'API, registres de generació d'imatges i tasques asíncrones, filtra'ls i segueix-ne l'estat, els resultats i els reemborsaments.
- [Perfil i seguretat](/ca/user/profile): Gestiona les dades del compte, notificacions i preferències, contrasenya, comptes vinculats, sessions, testimonis d'accés, verificació en dos passos i Passkey.
- [Catàleg de models i classificacions](/ca/user/pricing): Consulta els preus i l'estat dels models disponibles al catàleg i les classificacions d'ús de models i proveïdors.
- [Ús de l'API i del banc de proves](/ca/user/playground): Prova models en línia al banc de proves o accedeix a ZeroCat mitjançant interfícies compatibles amb OpenAI, Claude i Gemini.
- [Integració amb aplicacions de xat](/ca/user/chat-apps): Importa ZeroCat amb un clic o configura'l manualment en diverses aplicacions de xat amb IA.
- [Visió general](/ca/api/overview): Les interfícies de models d'IA de ZeroCat, compatibles amb els formats OpenAI, Anthropic Claude i Google Gemini.
- [Llistar models](/ca/api/models/list): Obté els models disponibles actualment. El format de resposta es determina per les capçaleres: Anthropic si hi ha `x-api-key` i `anthropic-version`; Gemini si hi ha `x-goog-api-key` o el paràmetre de consulta `key`; en altres casos, OpenAI.
- [Llistar models (format Gemini)](/ca/api/models/list-gemini): Retorna la llista de models disponibles en format de l'API Gemini
- [Complecions de xat](/ca/api/chat/chat-completions): Crea una resposta del model a partir de l'historial de conversa. Admet respostes en flux i sense flux. Compatible amb l'API OpenAI Chat Completions.
- [Responses](/ca/api/chat/responses): API OpenAI Responses per crear respostes de models. Admet converses de diversos torns, crides a eines, raonament i més.
- [Missatges (format Claude)](/ca/api/chat/messages): Format de petició de l'API Anthropic Claude Messages. La capçalera `anthropic-version` és obligatòria.
- [Xat de text amb Gemini](/ca/api/chat/gemini): Intermedia peticions de l'API Gemini. Format del camí: `/v1beta/models/{model_name}:{action}`. Exemples: `/v1beta/models/gemini-2.5-pro:generateContent` i `/v1beta/models/gemini-2.5-pro:streamGenerateContent?alt=sse`.
- [Reconeixement multimèdia amb Gemini](/ca/api/chat/gemini-media): Petició de reconeixement d'imatges, PDF, àudio i vídeo de Gemini. ⚠️ Les peticions natives de Gemini admeten contingut multimèdia mitjançant inlineData (base64) o fileData.fileUri (una URL pública, inclosos enllaços de YouTube). L'accés als URI de fitxers pujats amb la Gemini File API depèn dels permisos de la clau del canal del proveïdor; es recomanen URL públiques. En convertir peticions de format OpenAI (chat/completions) a Gemini, el contingut es descarrega i es passa com a inlineData (base64).
- [Complecions](/ca/api/completions): Crea una compleció de text a partir d'una instrucció
- [Embeddings](/ca/api/embeddings/openai): Converteix text en embeddings vectorials
- [Embeddings (format Gemini)](/ca/api/embeddings/gemini): Crea embeddings amb el motor o model indicat
- [Reordenació de documents](/ca/api/rerank): Reordena una llista de documents segons la rellevància per a la consulta
- [Moderació](/ca/api/moderations): Comprova si el text infringeix les polítiques d'ús
- [Generar una imatge](/ca/api/images/generations): Crea una imatge a partir d'una instrucció. [Més informació](https://platform.openai.com/docs/guides/images).
- [Editar una imatge](/ca/api/images/edits): Crea una imatge editada o ampliada a partir d'una imatge original i una instrucció.
- [Generació d'imatges nativa de Gemini](/ca/api/images/gemini): Generació d'imatges amb Gemini
- [Generació d'imatges amb Gemini (format Chat)](/ca/api/images/gemini-chat): Generació d'imatges amb Gemini
- [Generació d'imatges amb Qwen](/ca/api/images/qwen-generations): Generació de la sèrie d'imatges Bailian Qwen
- [Edició d'imatges amb Qwen](/ca/api/images/qwen-edits): Edició de la sèrie d'imatges Bailian Qwen
- [Text a veu](/ca/api/audio/speech): Converteix text en àudio
- [Transcripció d'àudio](/ca/api/audio/transcriptions): Converteix àudio en text
- [Traducció d'àudio](/ca/api/audio/translations): Tradueix àudio a text en anglès
- [Comprensió d'àudio amb Gemini](/ca/api/audio/gemini): API de generació d'àudio de Gemini. Es poden utilitzar models com gemini-2.5-flash-preview-tts.
- [Temps real](/ca/api/realtime): Estableix una connexió WebSocket per a una conversa en temps real. **Nota**: aquest punt d'accés requereix el protocol WebSocket. Exemple d'URL de connexió: `wss://api.example.com/v1/realtime?model=gpt-4o-realtime`.
- [Crear una tasca de generació de vídeo](/ca/api/videos/create): Envia una tasca de generació de vídeo; admet text a vídeo i imatge a vídeo. Retorna un ID de tasca que permet consultar-ne l'estat amb GET.
- [Obtenir una tasca de generació de vídeo](/ca/api/videos/get): Consulta l'estat i el resultat d'una tasca de generació de vídeo. Estats: `queued` (en cua), `in_progress` (en generació), `completed` i `failed`.
- [Crear un vídeo Sora](/ca/api/videos/sora-create): API de generació de vídeo compatible amb OpenAI. Referència: https://platform.openai.com/docs/api-reference/videos/create
- [Obtenir una tasca Sora](/ca/api/videos/sora-get): API d'estat de tasques de vídeo compatible amb OpenAI. Retorna informació detallada sobre l'estat de la tasca.
- [Obtenir contingut de vídeo Sora](/ca/api/videos/sora-content): Obté el contingut del fitxer de vídeo d'una tasca completada. Aquest punt d'accés intermedia el flux del fitxer.
- [Text a vídeo amb Kling](/ca/api/videos/kling-text2video): Genera un vídeo a partir d'una descripció de text amb un model Kling. Els models admesos inclouen kling-v1 i kling-v1-5.
- [Obtenir una tasca de text a vídeo de Kling](/ca/api/videos/kling-text2video-get): Consulta l'estat i el resultat d'una tasca de text a vídeo de Kling.
- [Imatge a vídeo amb Kling](/ca/api/videos/kling-image2video): Genera un vídeo a partir d'una imatge amb un model Kling. El paràmetre image accepta una URL d'imatge o dades codificades en Base64.
- [Obtenir una tasca d'imatge a vídeo de Kling](/ca/api/videos/kling-image2video-get): Consulta l'estat i el resultat d'una tasca d'imatge a vídeo de Kling.
- [Generació de vídeo amb Jimeng](/ca/api/videos/jimeng): API de generació de vídeo en el format oficial de Jimeng. El paràmetre Action indica l'operació: `CVSync2AsyncSubmitTask` envia una tasca de generació i `CVSync2AsyncGetResult` n'obté el resultat. Indica Action i Version com a paràmetres de consulta.
- [Visió general i autenticació](/ca/manage/overview): Gestiona el compte ZeroCat des del teu sistema amb un testimoni d'accés personal: consulta el saldo, gestiona claus d'API i consulta registres.
- [Obtenir l'usuari actual](/ca/manage/user/self): Cal un testimoni d'accés personal amb l'abast `profile:read` (Perfil → Consulta).
- [Actualitzar l'usuari actual](/ca/manage/user/self-update): Cal un testimoni d'accés personal amb l'abast `profile:write` (Perfil → Edició). Només canvia el nom visible. Canviar la contrasenya requereix verificació de seguretat a la consola.
- [Obtenir els grups de l'usuari actual](/ca/manage/user/groups): Cal un testimoni d'accés personal amb l'abast `profile:read` (Perfil → Consulta).
- [Obtenir els models disponibles](/ca/manage/user/models): Cal un testimoni d'accés personal amb l'abast `profile:read` (Perfil → Consulta).
- [Actualitzar la configuració d'usuari](/ca/manage/user/setting): Cal un testimoni d'accés personal amb l'abast `profile:write` (Perfil → Edició). El cos substitueix totes les notificacions i preferències; els camps omesos tornen als valors predeterminats.
- [Llistar claus d'API](/ca/manage/token/list): Cal un testimoni d'accés personal amb l'abast `api_key:read` (Claus d'API → Consulta). El `key` retornat està emmascarat. Per obtenir la clau completa, crida [Obtenir la clau d'API completa](/ca/manage/token/key).
- [Cercar claus d'API](/ca/manage/token/search): Cal un testimoni d'accés personal amb l'abast `api_key:read` (Claus d'API → Consulta).
- [Obtenir una clau d'API](/ca/manage/token/get): Cal un testimoni d'accés personal amb l'abast `api_key:read` (Claus d'API → Consulta).
- [Obtenir la clau d'API completa](/ca/manage/token/key): Cal un testimoni d'accés personal amb l'abast `api_key:reveal` (Claus d'API → Veure la clau completa). La clau retornada no inclou el prefix `sk-`; utilitza `sk-` + `key` per cridar models.
- [Crear una clau d'API](/ca/manage/token/create): Cal un testimoni d'accés personal amb l'abast `api_key:write` (Claus d'API → Edició). Si la creació té èxit, només retorna `success`, no la clau. Utilitza [Llistar claus d'API](/ca/manage/token/list) per trobar l'ID de la nova clau i crida [Obtenir la clau d'API completa](/ca/manage/token/key).
- [Actualitzar una clau d'API](/ca/manage/token/update): Cal un testimoni d'accés personal amb l'abast `api_key:write` (Claus d'API → Edició). Sense `status_only`, el cos de la petició substitueix tota la configuració de la clau. Consulta primer la configuració actual amb [Obtenir una clau d'API](/ca/manage/token/get), modifica-la i envia-la completa.
- [Eliminar una clau d'API](/ca/manage/token/delete): Cal un testimoni d'accés personal amb l'abast `api_key:write` (Claus d'API → Edició).
- [Eliminar claus d'API en bloc](/ca/manage/token/batch-delete): Cal un testimoni d'accés personal amb l'abast `api_key:write` (Claus d'API → Edició).
- [Consultar l'ús d'una clau d'API](/ca/manage/token/usage): Autentica't amb la clau d'API consultada; no cal testimoni d'accés personal.
- [Obtenir registres personals](/ca/manage/log/self): Cal un testimoni d'accés personal amb l'abast `usage:read` (Ús → Consulta). Una consulta d'un usuari ordinari té un període màxim; si se supera, retorna un error.
- [Estadístiques personals de registres](/ca/manage/log/self-stat): Cal un testimoni d'accés personal amb l'abast `usage:read` (Ús → Consulta). Només es compten registres de consum. `rpm` i `tpm` cobreixen els últims 60 segons i no depenen dels paràmetres de període.
- [Obtenir registres per clau d'API](/ca/manage/log/by-token): Autentica't amb la clau d'API consultada; no cal testimoni d'accés personal. Retorna com a màxim 1000 registres recents de crides d'aquesta clau.
- [Obtenir dades personals de crèdits](/ca/manage/log/data-self): Cal un testimoni d'accés personal amb l'abast `usage:read` (Ús → Consulta).
- [Obtenir l'historial de recàrregues](/ca/manage/topup/self): Cal un testimoni d'accés personal amb l'abast `wallet:read` (Cartera → Consulta).
- [Bescanviar un codi](/ca/manage/topup/redeem): Cal un testimoni d'accés personal amb l'abast `wallet:write` (Cartera → Edició). Si el bescanvi té èxit, els crèdits s'afegeixen directament al saldo del compte.
- [Obtenir tasques personals](/ca/manage/task/self): Cal un testimoni d'accés personal amb l'abast `usage:read` (Ús → Consulta).
- [Obtenir tasques personals de Midjourney](/ca/manage/task/mj-self): Cal un testimoni d'accés personal amb l'abast `usage:read` (Ús → Consulta).
- [Obtenir l'estat del sistema](/ca/manage/public/status): Punt d'accés públic; no cal autenticació.
- [Obtenir preus](/ca/manage/public/pricing): Punt d'accés públic; no cal autenticació.
- [Obtenir anuncis](/ca/manage/public/notice): Punt d'accés públic; no cal autenticació.
- [Instal·lar CC Switch](/ca/guide/cc-switch): CC Switch és una eina d'escriptori de codi obert per a Windows, macOS i Linux que gestiona gràficament els proveïdors de Claude Code, Codex, Gemini CLI i altres eines de programació amb IA.
- [Claude Code](/ca/guide/claude-code): Configura ZeroCat a Claude Code amb CC Switch mitjançant la interfície gràfica, sense editar fitxers manualment.
- [Codex](/ca/guide/codex): Configura ZeroCat a Codex amb CC Switch per a la CLI, l'aplicació d'escriptori i els connectors d'editor.
- [DeepSeek Harness](/ca/guide/deepseek-harness): DeepSeek Harness és el client d'escriptori oficial d'agents d'IA de DeepSeek. Permet connectar serveis intermediaris amb una API de model personalitzada i els protocols OpenAI Chat Completions, OpenAI Responses i Anthropic Messages.
- [Factory Droid CLI](/ca/apps/factory-droid-cli): Instal·la Factory Droid CLI, un assistent d'enginyeria de programari amb IA, i connecta'l a ZeroCat amb models personalitzats.
- [Cherry Studio](/ca/apps/cherry-studio): Connecta el client d'IA d'escriptori Cherry Studio a ZeroCat. Inclou més de 30 assistents professionals per a diferents tasques.
- [DeepChat](/ca/apps/deepchat): Connecta DeepChat, un client complet d'agents d'IA, a ZeroCat amb importació de configuració amb un clic.
- [AionUi](/ca/apps/aionui): Connecta AionUi, l'agent d'escriptori gratuït i de codi obert, a ZeroCat. Admet agents d'IA com Gemini CLI, Claude Code i Codex.
- [AQBot](/ca/apps/aqbot): Connecta AQBot, un espai de treball d'IA d'escriptori amb prioritat local, a ZeroCat amb els protocols OpenAI, Claude i Gemini.
- [OpenClaw](/ca/apps/openclaw): Instal·la OpenClaw, una plataforma autoallotjada d'assistents d'IA, i configura ZeroCat com a proveïdor de models. Admet Telegram, Discord, WhatsApp i altres canals.
- [LangBot](/ca/apps/langbot): Connecta la plataforma de desenvolupament de bots de missatgeria LangBot a ZeroCat per oferir IA a bots de Feishu, DingTalk, Telegram, Discord i altres plataformes.
- [AstrBot](/ca/apps/astrbot): Connecta la plataforma de bots de xat de codi obert AstrBot a ZeroCat per oferir funcions d'IA a QQ, Feishu, DingTalk, WeCom i altres serveis de missatgeria.
- [Memoh](/ca/apps/memoh): Connecta Memoh, una plataforma autoallotjada d'agents d'IA en contenidors, a ZeroCat per crear bots amb memòria a llarg termini per a Telegram, Discord, Feishu, QQ, WeChat i altres canals.
- [FluentRead](/ca/apps/fluent-read): Connecta l'extensió de traducció de codi obert FluentRead a ZeroCat per llegir en dues llengües amb models de llenguatge.
- [LunaTranslator](/ca/apps/luna-translator): Connecta LunaTranslator, traductor de novel·les visuals de codi obert, a ZeroCat per millorar la traducció amb models de llenguatge.
- [Preguntes freqüents](/ca/faq): Preguntes freqüents sobre crèdits, facturació, resolució d'errors, recàrregues, reemborsaments i contacte.
- [Condicions del servei](/ca/legal/terms): Acord entre v?s i ZeroCat LLC sobre l'?s dels serveis de ZeroCat.
- [Pol?tica de privacitat](/ca/legal/privacy): Com ZeroCat LLC recull, utilitza, emmagatzema, divulga i tracta d'altres maneres la informaci? personal.
- [Política de reemborsament](/ca/legal/refund): Crèdits prepagats, reemborsaments, disputes de facturació i retrocessions de pagament.
- [Normes d'ús](/ca/legal/usage): Requisits d'ús, regions restringides, compte i credencials d'API, ús acceptable i exempció de responsabilitat pels resultats d'IA.