兔子API（Tuzi API）接口文档总览

本文是 Apifox 项目文档的「总介绍」。涵盖聊天、图像生成、视频生成、音乐生成等能力的统一说明、调用规范与示例。请先阅读「接口状态说明」，再开始调试。

接口状态说明（必读）

已发布：接口功能稳定、可正常调用，计费与限流规则生效。

待开发：接口设计稿或联调中，不可正常使用，仅供预览字段与约定。

在 Apifox 中，请以右上角「发布状态」为准；仅当接口处于 已发布 状态时再进行调用与接入。

1. 关于兔子API

兔子API 是一家专注 多模型、多媒体 AI 能力聚合 的服务平台，统一封装聊天理解、图像生成、视频生成、音乐生成等主流能力，帮助研发团队 更快上线、低成本运维。

2. 快速开始

2.1 认证方式

Authorization：Bearer <Your_API_Key>

Header：Content-Type: application/json

示例：Authorization: Bearer sk-xxxxx

2.2 网关与版本

Base URL：https://api.tu-zi.com（示例，按实际网关替换）

版本：v1，通过路径标识（例如 /v1/...）

2.3 通用响应结构

{
  "code": 0,
  "message": "ok",
  "request_id": "req_1234567890",
  "data": { }
}

code = 0 表示成功；非 0 为失败。

request_id 便于问题追踪，请在工单中携带。

3. 服务目录

3.1 聊天（Chat / Completions）

POST /v1/chat/completions

用途：对话问答、指令执行、结构化信息抽取

请求体

{
  "model": "gpt-5",
  "messages": [
    {"role": "user", "content": "用一句话介绍兔子API"}
  ],
  "temperature": 0.7,
  "stream": false
}

成功响应（非流式）

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "chatcmpl_abc",
    "model": "gpt-5",
    "choices": [
      {"index": 0, "message": {"role": "assistant", "content": "兔子API聚合多模态AI能力，助你快速上线智能产品。"}}
    ],
    "usage": {"prompt_tokens": 12, "completion_tokens": 24, "total_tokens": 36}
  }
}

流式说明：当 stream=true 时返回 text/event-stream，按行推送 data: 事件。

cURL

3.2 图像生成（Image Generation）

POST /v1/images/generations

用途：根据文本生成图片；可选高清、尺寸、数量

请求体

{
  "model": "gpt-4o-image",
  "prompt": "一只戴着蓝色围巾的兔子，卡通，高清",
  "size": "1024x1024",
  "n": 1
}

成功响应

{
  "data": {
    "created": 1736160000,
    "images": [
      {"url": "https://cdn.tu-zi.com/i/abc.png"} # 示例
    ]
  }
}

cURL

4. Webhook 回调（可选）

推荐对 异步任务（如视频）配置 webhook_url。

回调将以 POST 方式发送 JSON，包含 job_id、status、资源地址与签名头 X-Tuzi-Signature。

验签：使用服务端保存的 Webhook Secret 与请求体进行 HMAC-SHA256 校验。

5. 幂等性与重复提交

对可产生侧效应的接口（如下单、任务提交），支持 Idempotency-Key：
Idempotency-Key: <uuid>

服务器将对同一 Key 的请求返回相同结果，避免重复扣费或重复生成。

6. SDK 与示例

JavaScript（fetch）

Python（requests）

7. 安全与合规

请妥善保管 API Key，避免在前端明文暴露。

遵循使用政策与内容合规要求；对可能含敏感内容的场景，建议启用 审计/安全策略。

对生产环境启用 IP 白名单 与 请求签名。

8. 支持与反馈

工单/邮箱：sydney@sydney-ai.com

请在反馈中提供：调用时间、request_id、接口名、示例请求体/响应体（脱敏）。

9. 再次提醒

只有当接口在 Apifox 中显示为「已发布」状态时才可正常使用；若为「待开发」，将无法保证可用性与返回结果。

感谢使用 兔子API！如果需要更多行业方案与稳定性保障，欢迎联系我们获取企业版支持。

介绍

兔子API（Tuzi API）接口文档总览#

接口状态说明（必读）#

1. 关于兔子API#

2. 快速开始#

2.1 认证方式#

2.2 网关与版本#

2.3 通用响应结构#

3. 服务目录#

3.1 聊天（Chat / Completions）#

3.2 图像生成（Image Generation）#

4. Webhook 回调（可选）#

5. 幂等性与重复提交#

6. SDK 与示例#

7. 安全与合规#

8. 支持与反馈#

9. 再次提醒#